Linkup API for LinkedIn icon

Linkup API for LinkedIn

Automate LinkedIn with Linkup

Actions36

Overview

The "Get Candidates" operation of the Recruiter resource in this node allows users to retrieve a list of candidates from LinkedIn Recruiter job postings. This is useful for recruiters or HR professionals who want to automate the process of fetching candidate profiles that match specific criteria such as years of experience, ratings, and sorting preferences.

Typical use cases include:

  • Automatically gathering candidate data for open job positions.
  • Filtering candidates based on experience or ratings.
  • Paginating through large sets of candidate results.
  • Integrating LinkedIn Recruiter data into other HR or CRM systems.

For example, a recruiter could configure this node to fetch the top 10 candidates with at least 5 years of experience, sorted by rating in descending order, to quickly identify the best matches for a job posting.

Properties

Name Meaning
Years of Experience Required years of experience for candidates.
Sort Type The criterion by which to sort candidates (e.g., by relevance, date).
Sort Order Sorting order: ASC (ascending) or DESC (descending).
Ratings Filter candidates by their ratings.
Start Starting point for pagination (offset or cursor).
Number of Results Number of candidate results to retrieve per request (default 10).
Start Page First page number to retrieve when paginating through results.
End Page Last page number to retrieve when paginating through results.
Country Code Country code used for proxy selection (e.g., FR for France, US for United States).
Timeout Request timeout in milliseconds (advanced option).
Retry Count Number of retries on failure (advanced option).

Output

The output JSON contains the API response from the LinkedIn Recruiter endpoint listing candidates. It includes:

  • Candidate details as returned by the LinkedIn Recruiter API.
  • A _debug object containing:
    • requestBody: The exact request payload sent.
    • requestHeaders: HTTP headers used in the request.
    • endpoint: The API endpoint called.
    • apiResponse: Raw response from the API.
  • A _meta object with metadata:
    • resource: The resource name ("recruiter").
    • operation: The operation name ("getCandidates").
    • timestamp: ISO timestamp of the request.
    • nodeVersion: Version of the node implementation.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for authenticating with the Linkup API service.
  • The node makes HTTP POST requests to the Linkup API endpoint https://api.linkupapi.com/v1/recruiter/candidates.
  • Proper configuration of the API key credential is necessary.
  • Optional country code parameter influences proxy selection for the API call.

Troubleshooting

  • Missing API Key: If the API key credential is not configured or invalid, the node will throw an error indicating the missing API key. Ensure the API key is set up correctly in the node credentials.
  • Timeouts: Requests may time out if the server is slow or network issues occur. Adjust the "Timeout" advanced option to a higher value if needed.
  • Invalid Parameters: Providing incorrect or malformed parameters (e.g., non-numeric values where numbers are expected) may cause API errors. Validate input parameters before execution.
  • Pagination Issues: Incorrect start, start_page, or end_page values might result in empty or incomplete results. Verify pagination settings.
  • Country Code Errors: Using unsupported or incorrect country codes may affect proxy routing and cause failures. Use valid country codes like "FR", "US", "UK", etc.

Links and References

  • Linkup API Documentation — Official site to create accounts and obtain API keys.
  • LinkedIn Recruiter official documentation (for understanding candidate data structure and usage).

This summary is based solely on static analysis of the provided source code and property definitions.

Discussion