Piloterr icon

Piloterr

Consume Piloterr API
Join our community

Actions7

Overview

The Piloterr node for n8n, when configured with the "Linkedin" resource and "Job Info" operation, retrieves detailed information about a specific LinkedIn job posting. This is achieved by querying the Piloterr API with either a LinkedIn job ID or a full LinkedIn job URL.

Common scenarios:

  • Enriching CRM or HR systems with up-to-date job details from LinkedIn.
  • Automating recruitment workflows by fetching job data for analysis or reporting.
  • Monitoring specific job postings for changes or updates.

Practical example:
A recruiter wants to automatically pull in all relevant details of a LinkedIn job posting (given its ID or URL) into their database whenever a new job is found.

Properties

Name Type Meaning
Query String The LinkedIn job to look up. Accepts either a numeric job ID (e.g., 3006950185) or a full job URL.

Output

The node outputs a JSON object containing the details of the specified LinkedIn job. The exact structure depends on the response from the Piloterr API, but typically includes fields such as:

{
  "id": "3006950185",
  "title": "Software Engineer",
  "company": "Example Corp",
  "location": "San Francisco, CA",
  "description": "...",
  "postedDate": "2024-06-01",
  // ...other job-related fields
}
  • If the API returns an error and "Continue On Fail" is enabled, the output will include an error field with the error message and an empty json object.

Dependencies

  • External Service: Requires access to the Piloterr API.
  • API Key: You must configure valid Piloterr API credentials (piloterrApi) in your n8n instance.
  • n8n Configuration: No additional environment variables are required beyond the API key setup.

Troubleshooting

Common issues:

  • Invalid or missing API key:
    Error message: 401 Unauthorized or similar.
    Resolution: Ensure your Piloterr API credentials are correctly set up in n8n.

  • Malformed Query input:
    Error message: Invalid query parameter or no results returned.
    Resolution: Double-check that you provide a valid LinkedIn job ID or a correct job URL.

  • Job not found:
    Error message: Job not found or empty result.
    Resolution: Verify the job still exists on LinkedIn and the ID/URL is correct.

  • API rate limits:
    Error message: 429 Too Many Requests.
    Resolution: Wait before making more requests or upgrade your Piloterr plan if necessary.

Links and References

Discussion