The Companies API icon

The Companies API

Access company data, enrichment, analytics and more using The Companies API

Overview

This node integrates with The Companies API to search for industry data based on user-defined criteria. It allows users to query industries by keywords and paginate through results, making it useful for business intelligence, market research, or enrichment workflows where understanding industry classifications is important.

Common scenarios:

  • Finding industries related to a specific keyword or sector.
  • Retrieving paginated lists of industries for analysis or reporting.
  • Enriching company data with relevant industry information.

Practical example:
A marketing team wants to target companies in the "renewable energy" sector. They can use this node to search industries matching "renewable energy" and retrieve a list of relevant industry codes and descriptions to filter their outreach campaigns.

Properties

Name Meaning
Search A string keyword to search industries by name or description.
Page The page number of results to retrieve (pagination). Defaults to 1.
Size The number of results per page. Defaults to 25.

Output

The node outputs JSON data containing the search results from The Companies API. The structure typically includes an array of industry objects with details such as industry codes, names, and descriptions.

  • json: Contains the main response data from the API under .data or directly if .data is not present.
  • pairedItem: Indicates which input item the output corresponds to, supporting multiple inputs.

The node does not output binary data.

Dependencies

  • Requires an API token credential for The Companies API to authenticate requests.
  • Uses the official SDK from @thecompaniesapi/sdk.
  • No additional environment variables are needed beyond the API token credential configured in n8n.

Troubleshooting

  • Unknown operation error: If the operation parameter is set incorrectly or not supported, the node throws an error stating "Unknown operation". Ensure the operation is set to "searchIndustries".
  • SDK method not found: If the SDK method corresponding to the operation is missing, verify that the SDK version supports the requested operation.
  • Empty or invalid parameters: If required parameters like search are empty or invalid, the API may return no results or errors. Provide valid search terms.
  • API authentication errors: Ensure the API token credential is correctly configured and has sufficient permissions.
  • Pagination issues: If requesting pages beyond available data, the API may return empty results.

To resolve errors, check parameter values, confirm credentials, and consult The Companies API documentation for limits and usage guidelines.

Links and References

Discussion