The Companies APIInstall

Overview

This node integrates with The Companies API to search for industries similar to a given set of industries. It is useful in scenarios where you want to discover related industry sectors based on one or more input industries, for example:

• Market research to identify adjacent or competitive industries.
• Business development to find new target sectors similar to current ones.
• Data enrichment workflows that require classification or grouping of companies by related industries.

The node accepts multiple industries as input and supports pagination through page number and size parameters, allowing users to control the volume and offset of results returned.

Properties

Output

The node outputs JSON data containing the search results from The Companies API's "search similar industries" endpoint. The structure typically includes an array of industries similar to the input industries, along with associated metadata as provided by the API.

No binary data output is produced by this node.

Example output JSON snippet (simplified):

{
  "data": [
    {
      "industryId": "123",
      "industryName": "Related Industry A",
      "similarityScore": 0.85
    },
    {
      "industryId": "456",
      "industryName": "Related Industry B",
      "similarityScore": 0.80
    }
  ]
}

Dependencies

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

Troubleshooting

• Unknown operation error: If the operation parameter is incorrect or unsupported, the node throws an error indicating "Unknown operation". Ensure the operation is set exactly to "searchIndustriesSimilar".
• SDK method not found: If the internal SDK method corresponding to the operation is missing, it will throw an error. This usually indicates a version mismatch or misconfiguration.
• Empty or invalid input: Providing empty industries array or invalid types may result in no results or API errors. Make sure to provide valid industry names as strings.
• API authentication errors: Invalid or missing API token will cause authentication failures. Verify the API token credential is correctly set up.
• Pagination issues: Requesting pages beyond available data may return empty results. Adjust page and size accordingly.

If continueOnFail is enabled, errors for individual items will be captured in the output JSON under an error field instead of stopping execution.

Links and References

• The Companies API Documentation
• The Companies API SDK on npm
• n8n Documentation - Creating Custom Nodes