Linked API icon

Linked API

Control your LinkedIn accounts and retrieve real-time data.

Overview

This node, named "Linked API," enables users to perform advanced LinkedIn people searches by sending search queries to an external LinkedIn-related API. It is designed to help automate the retrieval of real-time LinkedIn data about people based on various search criteria. Typical use cases include recruiting, sales prospecting, market research, and networking automation where users want to find LinkedIn profiles matching specific keywords, job titles, locations, companies, or educational backgrounds.

For example, a recruiter could use this node to search for software developers in New York who have worked at Google or Microsoft, limiting results to the top 10 matches. The node sends the search parameters to a webhook URL where the response will be delivered asynchronously.

Properties

Name Meaning
Webhook URL URL where the search results response will be sent via webhook. This must be a publicly accessible endpoint that can receive POST requests with the search results.
Search Term Keywords or terms to search for in people's profiles, such as job titles, skills, or other relevant text (e.g., "software development").
Limit Maximum number of search results to return. Must be at least 1. Defaults to 10.
Additional Search Fields A collection of optional filters to refine the search:
• First Name — Person's first name
• Last Name — Person's last name
• Position — Job position/title
• Locations — Semicolon-separated list of locations (e.g., "New York; San Francisco")
• Industries — Semicolon-separated industries (e.g., "Software Development; Technology")
• Current Companies — Semicolon-separated current employers (e.g., "Google; Microsoft")
• Previous Companies — Semicolon-separated previous employers (e.g., "Apple; Facebook")
• Schools — Semicolon-separated schools attended (e.g., "Stanford University; MIT")

Output

The node outputs JSON data containing the search results returned from the LinkedIn API via the configured webhook. The exact structure depends on the external API's response but typically includes an array of people profiles matching the search criteria, each with details such as names, positions, companies, locations, and other profile information.

No binary data output is indicated or expected.

Dependencies

  • Requires an active API key credential for authenticating with the LinkedIn-related external API.
  • Requires a publicly accessible webhook URL to receive asynchronous responses.
  • The node sends a POST request to the external API endpoint https://api.linkedapi.io/automation/execute with the search parameters.
  • Proper network connectivity and permissions to access both the external API and the webhook URL are necessary.

Troubleshooting

  • Common issues:

    • Invalid or unreachable webhook URL: Ensure the webhook URL is correct, publicly accessible, and able to accept POST requests.
    • Missing or invalid API authentication: Verify that the API key credential is correctly configured and has sufficient permissions.
    • Exceeding rate limits or quota on the external API may cause errors or delayed responses.
    • Incorrectly formatted semicolon-separated fields may lead to unexpected filtering behavior.
  • Error messages:

    • Errors related to webhook delivery failures usually indicate network or URL misconfiguration.
    • Authentication errors suggest problems with the provided API key or credential setup.
    • Validation errors may occur if required fields like "Webhook URL" or "Search Term" are missing or empty.

Resolving these typically involves verifying credentials, ensuring the webhook endpoint is operational, and checking input field formats.

Links and References

Discussion