Company API

This page provides detailed information on how to retrieve company information through our 2 main API's the search: /api/company/search and export: /api/company/export endpoints. These endpoints allow you to retrieve, search, and export information about companies, with a variety of filtering options such as country, city, industry etc.

Company Search

Endpoint: /api/company/search

The /api/company/search endpoint allows users to search for companies based on various criteria. This endpoint returns a standard set of fields, including the company name and address.

Returned Fields

• ID: A unique identifier of the company, can be used to retrieve a full record.
• Company Name: The main name of the company.
• Country Name: The country of the company.

Note: it's possible to receive more fields on search, this can be requested via support.

Important Notes

• Purpose: This endpoint is primarily used to retrieve basic information such as the company name and address based on a search query. For instance in an autocomplete search.
• Filtering branches: In most cases, you'll want to add statusCode=0,1 to your query. This filters for single locations (0) and headquarters (1) only. Large companies often have many branches/subsidiaries in the database, which are typically not relevant for most use cases like lead generation or company lookup.

Example Request

curl -G https://app.companydata.com/api/company/search \
  -H "x-api-key: {ApiKey}" \
  -d "search=Example Company"

Additional Examples

1. Search for companies named Bolddata

curl -G https://app.companydata.com/api/company/search?page=1&pageSize=25&search=BoldData \
  -H "x-api-key: {ApiKey}"

2. Search for companies named Bolddata in The NETHERLANDS

curl -G https://app.companydata.com/api/company/search?page=1&pageSize=25&search=BoldData&countryCode=NL \
  -H "x-api-key: {ApiKey}"

Company Export

Endpoint: /api/company/export

The /api/company/export endpoint allows users to request a specific set of fields related to company data. The fields returned by this endpoint depend on the type of package purchased by the client.

Returned Fields

• The set of fields returned is determined by the client's subscription package. This could include detailed company information such as financial data, employee count, or contact information.

Important Notes

• Package-Dependent Fields: The fields returned by this endpoint are customized based on the client's purchased package. For more information contact support.
• Use Case: This endpoint is used for getting a full company profile, often used in CRM's or for purposing of contacting or researching a company.

Example Request

Export the first 25 companies from Rotterdam, the Netherlands with the Sic Code 3221, for glassware.

curl -G https://app.companydata.com/api/company/export?page=1&pageSize=25&sic4Digits=3221&countryCode=NL&cityName=Rotterdam? \
  -H "x-api-key: {ApiKey}" \
  -d "export=true"

Query Parameters

Below is a list of query parameters that can be used to filter the results returned by this endpoint. Export and search support the same parameters.