Actions41
- Companies Actions
- Search companies
- Search companies (POST)
- Enrich company
- Search companies by name
- Search companies by prompt
- Search similar companies
- Count companies
- Count companies (POST)
- Enrich company by email
- Enrich company by social
- Get email patterns
- Ask company
- Get company context
- Fetch companies analytics
- Export companies analytics
- Lists Actions
- Locations Actions
- Business data Actions
- Actions Actions
- Prompts Actions
- Utilities Actions
Overview
This node allows you to search for companies by their name using The Companies API. It is useful when you want to find detailed company information based on partial or full company names, filter results by various criteria, and sort them according to specific fields.
Common scenarios include:
- Enriching CRM data by finding company details from a name.
- Market research to identify companies matching certain criteria.
- Filtering out companies from specific lists or countries.
- Paginating through large sets of company search results.
For example, you can search for companies named "Tech" in the United States, exclude certain lists, and sort results by monthly visitors in descending order.
Properties
| Name | Meaning |
|---|---|
| Search fields | Fields to search within the company data (multiple values allowed). |
| Lists to exclude | Lists of companies to exclude from the search results. |
| Simplified | Whether to return simplified company data (boolean). |
| Page | Page number of the results to retrieve (pagination). |
| Size | Number of results per page. |
| Sort key | Field by which to sort the results. Options include: About > business type, industries, name, total employees, year founded, analytics monthly visitors, apps, codes (naics, sic), contacts, domain, finances revenue, locations (headquarters city/country/state codes), meta score, socials, technologies active, urls. |
| Sort order | Order of sorting: Ascending or Descending. |
| Countries | Filter results by country codes. |
| Exact words match | Whether to match exact words in the company name (boolean). |
| Name | Company name to search for. |
| Sort fields | Additional fields to sort by (multiple values allowed). |
Output
The output is a JSON array where each item contains company data returned by the API under the json property. The structure corresponds to the company information as provided by The Companies API, including enriched details such as business type, industry, location, analytics, and more depending on the query parameters.
No binary data output is produced by this node.
Dependencies
- Requires an API token credential for The Companies API.
- Uses the official SDK of The Companies API (
@thecompaniesapi/sdk) to perform requests. - No additional environment variables are needed beyond the API token.
Troubleshooting
- Unknown operation error: If the operation parameter is set incorrectly, the node will throw an error indicating the operation is unknown. Ensure the operation is set to "searchCompaniesByName".
- SDK method not found: If the SDK does not have the expected method, it indicates a mismatch between the node's operation and the SDK version. Update the SDK or verify the operation name.
- Empty or invalid parameters: Some parameters default to predefined values if left empty or zero. Make sure required parameters like
nameare correctly set. - API authentication errors: Verify that the API token credential is valid and has the necessary permissions.
- Pagination issues: If no results appear, check the
pageandsizeparameters to ensure they are within valid ranges.