Piloterr icon

Piloterr

Consume Piloterr API

Actions7

Overview

This n8n node interacts with the Piloterr API to retrieve the employee count for a specified LinkedIn company. It is particularly useful for workflows that require automated enrichment of company data, such as lead qualification, market research, or HR analytics. For example, you can use this node to automatically fetch and log the current or past employee count of a company based on its LinkedIn identifier.

Properties

Name Type Meaning
Query String The LinkedIn company identifier to look up. Example: 1337.
Status String Filter to specify whether to count "current" or "past" employees. Default is "current".

Output

The output is a JSON object containing the response from the Piloterr API's /v2/linkedin/company/employee_count endpoint. The structure typically includes fields such as:

{
  "company": "Example Company",
  "employee_count": 1234,
  "status": "current"
}
  • company: The name or identifier of the company.
  • employee_count: The number of employees matching the status filter.
  • status: Indicates whether the count refers to "current" or "past" employees.

Note: The exact structure may vary depending on the API response.

Dependencies

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

Troubleshooting

Common Issues:

  • Invalid or missing API key: If your credentials are incorrect or missing, the node will fail to authenticate with the Piloterr API.
  • Incorrect company identifier: Providing an invalid or non-existent LinkedIn company ID in the "Query" field may result in empty or error responses.
  • Status parameter typo: Only "current" or "past" are accepted; other values may cause errors.

Error Messages:

  • "Request failed with status code 401": Check your API key configuration.
  • "Company not found": Verify the LinkedIn company identifier in the "Query" property.
  • "Invalid status parameter": Ensure "Status" is set to either "current" or "past".

Links and References

Discussion