Linkup API for LinkedIn

Overview

This node integrates with the Linkup API to automate LinkedIn Recruiter tasks. Specifically, the "Get Candidate CV" operation allows users to download a candidate's CV from LinkedIn Recruiter. This is useful for recruiters or HR professionals who want to programmatically retrieve candidate resumes for further processing, storage, or analysis within an automated workflow.

Practical examples include:

• Automatically fetching candidate CVs after sourcing candidates from a job posting.
• Integrating candidate CV retrieval into a larger recruitment pipeline that includes screening and communication.
• Archiving candidate CVs in a document management system without manual downloads.

Properties

Note: The node also requires selecting the Resource as "Recruiter" and Operation as "Get Candidate CV" but these are fixed by your input context.

Output

The node outputs JSON data containing the response from the Linkup API for the candidate CV request. The output JSON includes:

• _debug: Debug information including the request body sent, request headers, endpoint URL, and raw API response.
• The actual API response fields merged at the root level.
• _meta: Metadata about the resource ("recruiter"), operation ("getCandidateCV"), timestamp of execution, and node version.
• pairedItem: Indicates which input item this output corresponds to.

If the API returns binary data for the CV (e.g., PDF or DOCX), it would typically be included in the JSON response or handled separately by the API. The code does not explicitly handle binary data, so any binary content would likely be base64 encoded or provided as a URL in the JSON.

Dependencies

• Requires an API key credential for the Linkup API.
• Needs proper configuration of the Linkup API credentials including API key and optionally LinkedIn email/password for authentication.
• The node makes HTTP POST requests to the Linkup API endpoints.
• No additional external dependencies beyond standard HTTP requests.

Troubleshooting

• Missing API Key Error: If the API key is not configured, the node throws an error indicating the missing API key. Ensure you have set up the Linkup API credentials correctly in n8n.
• Timeouts or Network Errors: The node supports a configurable timeout (default 30 seconds). Increase the timeout if requests frequently time out.
• API Rate Limits or Failures: The node supports retry count (default 3) on failures. Adjust retry count based on API reliability.
• Invalid Parameters: Ensure all required parameters for the "Get Candidate CV" operation are correctly set in the node UI or workflow.
• Unexpected API Responses: Check the _debug output for request and response details to diagnose issues.

Links and References

• Linkup API Documentation — Official site to create account and get API key.
• LinkedIn Recruiter official documentation (for understanding job postings and candidate CVs).
• n8n HTTP Request node documentation (for understanding underlying HTTP calls).

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