post /v3/search/companies

Lookalike companies search

Search companies using filters.

Looking for the legacy endpoint? Access it here
Endpoint POST /v3/search/companies
Credit cost 0.2 credits / result
Response Synchronous — up to 10,000 results per request
When to use Build a filtered list of target companies matching your ideal customer profile

Example use case: Find all B2B SaaS companies in Germany with 51–200 employees that use HubSpot.

Quickstart#

curl -X POST "https://api.ocean.io/v3/search/companies" \
  -H "X-Api-Token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "companiesFilters": {
      "primaryLocations": { "includeCountries": ["de"] },
      "companySizes": ["51-200"],
      "industries": { "industries": ["SaaS"] },
      "technologies": {
        "apps": { "anyOf": ["HubSpot"] }
      }
    },
    "size": 10
  }'
import requests

response = requests.post(
    'https://api.ocean.io/v3/search/companies',
    headers={'X-Api-Token': 'YOUR_API_TOKEN'},
    json={
        'companiesFilters': {
            'primaryLocations': {'includeCountries': ['de']},
            'companySizes': ['51-200'],
            'industries': {'industries': ['SaaS']},
            'technologies': {'apps': {'anyOf': ['HubSpot']}},
        },
        'size': 10,
    },
)
data = response.json()
const response = await fetch('https://api.ocean.io/v3/search/companies', {
  method: 'POST',
  headers: { 'X-Api-Token': 'YOUR_API_TOKEN', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    companiesFilters: {
      primaryLocations: { includeCountries: ['de'] },
      companySizes: ['51-200'],
      industries: { industries: ['SaaS'] },
      technologies: { apps: { anyOf: ['HubSpot'] } },
    },
    size: 10,
  }),
});
const data = await response.json();

Example response:

{
  "companies": [
    {
      "domain": "example.de",
      "name": "Example GmbH",
      "companySize": "51-200",
      "primaryCountry": "de",
      "industries": ["SaaS", "B2B"],
      "technologies": ["HubSpot", "Salesforce"]
    }
  ],
  "searchAfter": ["example.de"],
  "total": 842
}

Use the searchAfter value from each response as the searchAfter parameter in your next request to get the following page. See Pagination for details.

Authorizations

apiToken string
x-api-token string

Body application/json

size integer
Number of companies to return. The maximum value is 10,000. To get more than 10,000 results, use `searchAfter`.
searchAfter string
Use `searchAfter` returned by the previous request to get the next page
Collection of companies filters to be applied to the search
Find domains similar to the provided
Array of string
Only return specified domains
Array of string
Exclude specified domains from the results
Array of string
Filter by company size ranges
Array of PublicCompanySize
enum
"0-1""2-10""11-50""51-200""201-500""501-1000""1001-5000""5001-10000""10001-50000""50001-100000""100001-500000""500000+"
ecommerce boolean
true -> returns only e-commerce companies<br>false -> excludes e-commerce companies<br>none -> returns everything
Filter by year founded. Valid range: 0-2100
from integer
Greater than or equal to
to integer
Less than or equal to
Filter by the number of countries in which the company operates. Valid range: 0-300
from integer
Greater than or equal to
to integer
Less than or equal to
Filter by revenue ranges
Array of Revenue
enum
"0-1M""1-10M""10-50M""50-100M""100-500M""500-1000M"">1000M"
Only return companies that have a certain number of employee profiles in our database. Valid range: 0-10,000,000
from integer
Greater than or equal to
to integer
Less than or equal to
Filter by the number of mobile apps that the company produced. Valid range: 0-10,000
from integer
Greater than or equal to
to integer
Less than or equal to
Filter by mobile app attributes (count, downloads, release year)
Filter by the number of mobile apps that the company produced. Valid range: 0-10,000
from integer
Greater than or equal to
to integer
Less than or equal to
Filter by the number of mobile app downloads. Valid range: 0-10,000,000,000
from integer
Greater than or equal to
to integer
Less than or equal to
Filter by the release year of mobile apps. Valid range: 2000-2100
from integer
Greater than or equal to
to integer
Less than or equal to
Only return companies that have a certain amount of locations. Valid range: 0-100,000
from integer
Greater than or equal to
to integer
Less than or equal to
Filter by the size of company departments. Valid range: 0-10,000,000
Array of DepartmentSizeFilter
from integer
Greater than or equal to
to integer
Less than or equal to
enum
"Accounting and Finance""Board""Business Support""Customer Relations""Design""Editorial Personnel""Engineering""Founder/Owner""Healthcare""HR""Legal""Management""Manufacturing""Marketing and Advertising""Operations""PR and Communications""Procurement""Product""Quality Control""R&D""Sales""Security""Supply Chain""Other"
The number of employees a company has on LinkedIn. Valid range: 0-10,000,000
from integer
Greater than or equal to
to integer
Less than or equal to
Filter by company industries. Available values are located at /v2/data-fields endpoint.<br>
Array of the industries to include
Array of string
mode enum
[default] anyOf - match at least one of the industries<br>allOf - match all of the industries
"anyOf""allOf"
Array of the industries to exclude
Array of string
Filter by company industry categories. Available values are located at /v2/data-fields endpoint.<br>
Array of the industry categories to include
Array of string
mode enum
[default] anyOf - match at least one of the industry categories<br>allOf - match all of the industry categories
"anyOf""allOf"
Array of the industry categories to exclude
Array of string
Filter by Linkedin industries. This is OR filter. Available values are located at /v2/data-fields endpoint.<br>
Array of string
Array of Linkedin industries to exclude. Available values are located at /v2/data-fields endpoint.<br>
Array of string
Filter by funding rounds
Amount of money raised in funding round. Valid range: 0-100,000,000,000
from integer
Greater than or equal to
to integer
Less than or equal to
List of funding round types
Array of FundingRoundType
enum
"Seed""Series A""Angel""Series B""Series Unknown""Pre-Seed""Grant""Series C""Convertible Note""Debt Financing""Non-Equity Assistance""Undisclosed""Series D""Corporate Round""Equity Crowdfunding""Product Crowdfunding""Series E""Private Equity""Secondary Market""Initial Coin Offering""Post-IPO Equity""Series F""Post-IPO Debt""Series H""Series G""Post-IPO Secondary""Series I""Series J"
Date range of the funding round. Valid range: 1800-01-01 to 2100-12-31
from string
Date in YYYY-MM-DD format
to string
Date in YYYY-MM-DD format
Filter by primary locations (HQ)
Filter by all countries where the company has presence.<br>Must be provided as alpha-2 ISO 3166 country codes.
Array of string
Exclude companies that are present in the specified countries.<br>Must be provided as alpha-2 ISO 3166 country codes.
Array of string
Filter by country regions — US states, Canadian provinces, etc. (if applicable). Available values are located at /v2/data-fields endpoint.
Array of State
country string Required
Alpha-2 ISO 3166 country code
abbreviation string Required
Valid state abbreviation. List available in the region section there: /v2/data-fields.
Exclude companies present in the specified regions — US states, Canadian provinces, etc. (if applicable). Available values are located at /v2/data-fields endpoint.
Array of State
country string Required
Alpha-2 ISO 3166 country code
abbreviation string Required
Valid state abbreviation. List available in the region section there: /v2/data-fields.
Filter by cities
Array of CompaniesCityFilter
city string Required
City name
country string
Alpha-2 ISO 3166 country code
Filter by country region (if applicable)
country string Required
Alpha-2 ISO 3166 country code
abbreviation string Required
Valid state abbreviation. List available in the region section there: /v2/data-fields.
postalCode string
Filter by postal code
Exclude companies that are present in the specified cities
Array of CompaniesCityFilter
city string Required
City name
country string
Alpha-2 ISO 3166 country code
Filter by country region (if applicable)
country string Required
Alpha-2 ISO 3166 country code
abbreviation string Required
Valid state abbreviation. List available in the region section there: /v2/data-fields.
postalCode string
Filter by postal code
Filter by latitude and longitude
latitude number Required
Latitude of the location
longitude number Required
Longitude of the location
radius integer Required
Radius in meters
Filter by locations of offices other than the headquarters
Filter by all countries where the company has presence.<br>Must be provided as alpha-2 ISO 3166 country codes.
Array of string
Exclude companies that are present in the specified countries.<br>Must be provided as alpha-2 ISO 3166 country codes.
Array of string
Filter by country regions — US states, Canadian provinces, etc. (if applicable). Available values are located at /v2/data-fields endpoint.
Array of State
country string Required
Alpha-2 ISO 3166 country code
abbreviation string Required
Valid state abbreviation. List available in the region section there: /v2/data-fields.
Exclude companies present in the specified regions — US states, Canadian provinces, etc. (if applicable). Available values are located at /v2/data-fields endpoint.
Array of State
country string Required
Alpha-2 ISO 3166 country code
abbreviation string Required
Valid state abbreviation. List available in the region section there: /v2/data-fields.
Filter by cities
Array of CompaniesCityFilter
city string Required
City name
country string
Alpha-2 ISO 3166 country code
Filter by country region (if applicable)
country string Required
Alpha-2 ISO 3166 country code
abbreviation string Required
Valid state abbreviation. List available in the region section there: /v2/data-fields.
postalCode string
Filter by postal code
Exclude companies that are present in the specified cities
Array of CompaniesCityFilter
city string Required
City name
country string
Alpha-2 ISO 3166 country code
Filter by country region (if applicable)
country string Required
Alpha-2 ISO 3166 country code
abbreviation string Required
Valid state abbreviation. List available in the region section there: /v2/data-fields.
postalCode string
Filter by postal code
Filter by latitude and longitude
latitude number Required
Latitude of the location
longitude number Required
Longitude of the location
radius integer Required
Radius in meters
Filter by web traffic metrics
Only return companies that have a certain amount of visits. Valid range: 0-100,000,000,000
from integer
Greater than or equal to
to integer
Less than or equal to
Only return companies that have a certain amount of page views. Valid range: 0-100,000,000,000
from integer
Greater than or equal to
to integer
Less than or equal to
Filter by social media presence
Filter by social media presence
The filter should match **any** of the specified values.
Array of enum
enum
"linkedin""x""facebook""instagram""youtube""xing""tiktok"
The filter should match **all** of the specified values.
Array of enum
enum
"linkedin""x""facebook""instagram""youtube""xing""tiktok"
The filter should match **none** of the specified values.
Array of enum
enum
"linkedin""x""facebook""instagram""youtube""xing""tiktok"
minCount integer
Return companies that are present in more than `n` social networks
Filter by the software technologies present on the company's website
Filter by software technologies used by the company. Available values are located at /v2/data-fields endpoint.
The filter should match **any** of the specified values.
Array of string
The filter should match **all** of the specified values.
Array of string
The filter should match **none** of the specified values.
Array of string
Filter by software technology categories used by the company. Available values are located at /v2/data-fields endpoint.
The filter should match **any** of the specified values.
Array of string
The filter should match **all** of the specified values.
Array of string
The filter should match **none** of the specified values.
Array of string
Filter by keywords
The filter should match **any** of the specified values.
Array of string
The filter should match **all** of the specified values.
Array of string
The filter should match **none** of the specified values.
Array of string
minRelevance enum
Filter by min relevance (A - the most relevant).
"A""B""C"
maxRelevance enum
Filter by max relevance (A - the most relevant). Use combination of min_relevance: "B" and max_relevance: "B" to get only results with the "B" relevance
"A""B""C"
Filter by headcount growth
asPercentage boolean Required
true -> filter on the percentage value of the headcount growth<br>false -> filter on the absolute value of the headcount growth<br>
Filter by headcount growth values. Valid range: -10,000,000 to 10,000,000.<br>If `as_percentage=false`, values are in integer form (e.g., `5`, `-5`).<br>If `as_percentage=true`, values are in decimal form (e.g., `0.5` = 50%).
from number
Greater than or equal to
to number
Less than or equal to
Headcount growth period in months
enum
"Three months""Six months""Twelve months"
Filter by department headcount growth
The result should match **any** of the department headcount growth filters.
Array of DepartmentGrowthFilter
asPercentage boolean Required
true -> filter on the percentage value of the headcount growth<br>false -> filter on the absolute value of the headcount growth<br>
Filter by headcount growth values. Valid range: -10,000,000 to 10,000,000.<br>If `as_percentage=false`, values are in integer form (e.g., `5`, `-5`).<br>If `as_percentage=true`, values are in decimal form (e.g., `0.5` = 50%).
from number
Greater than or equal to
to number
Less than or equal to
Headcount growth period in months
enum
"Three months""Six months""Twelve months"
Functional department for the headcount growth filter. Departments are assigned by job function, not seniority — a VP of Sales appears under 'Sales', a CTO under 'Engineering', a CMO under 'Marketing and Advertising', a CFO under 'Accounting and Finance', a CHRO under 'HR', a CLO/General Counsel under 'Legal'. 'Management' captures CEO, COO, and general-manager roles only. For VP/leadership hiring signals across functions, use anyOf with the relevant functional departments rather than 'Management' alone.
enum
"Accounting and Finance""Board""Business Support""Customer Relations""Design""Editorial Personnel""Engineering""Founder/Owner""Healthcare""HR""Legal""Management""Manufacturing""Marketing and Advertising""Operations""PR and Communications""Procurement""Product""Quality Control""R&D""Sales""Security""Supply Chain""Other"
The result should match **all** of the he department headcount growth filters.
Array of DepartmentGrowthFilter
asPercentage boolean Required
true -> filter on the percentage value of the headcount growth<br>false -> filter on the absolute value of the headcount growth<br>
Filter by headcount growth values. Valid range: -10,000,000 to 10,000,000.<br>If `as_percentage=false`, values are in integer form (e.g., `5`, `-5`).<br>If `as_percentage=true`, values are in decimal form (e.g., `0.5` = 50%).
from number
Greater than or equal to
to number
Less than or equal to
Headcount growth period in months
enum
"Three months""Six months""Twelve months"
Functional department for the headcount growth filter. Departments are assigned by job function, not seniority — a VP of Sales appears under 'Sales', a CTO under 'Engineering', a CMO under 'Marketing and Advertising', a CFO under 'Accounting and Finance', a CHRO under 'HR', a CLO/General Counsel under 'Legal'. 'Management' captures CEO, COO, and general-manager roles only. For VP/leadership hiring signals across functions, use anyOf with the relevant functional departments rather than 'Management' alone.
enum
"Accounting and Finance""Board""Business Support""Customer Relations""Design""Editorial Personnel""Engineering""Founder/Owner""Healthcare""HR""Legal""Management""Manufacturing""Marketing and Advertising""Operations""PR and Communications""Procurement""Product""Quality Control""R&D""Sales""Security""Supply Chain""Other"
updatedWithinMonths integer
Filter companies updated within the last N months.
Return records where specified fields exist
Array of enum
enum
"companySize""countries""departmentSizes""description""emails""faxes""impressum""industries""industryCategories""keywords""legalName""linkedinIndustry""locations""logo""medias""mobileApps""name""phones""primaryCountry""revenue""rootUrl""technologies""technologyCategories""webTraffic""yearFounded"
Return records where specified fields do not exist
Array of enum
enum
"companySize""countries""departmentSizes""description""emails""faxes""impressum""industries""industryCategories""keywords""legalName""linkedinIndustry""locations""logo""medias""mobileApps""name""phones""primaryCountry""revenue""rootUrl""technologies""technologyCategories""webTraffic""yearFounded"
companyMatchingMode enum
Controls how strictly companies are matched when using lookalike_domains. "precise" (default): Matches companies with similar products/services using semantic similarity. "broad": Matches companies within the same industries, casting a wider net for results.
"precise""broad"
Collection of people filters to be applied to the search, the search results will display companies that have at least one person matching those filters
List of people linkedin handles to search for similar people.
Array of string
List of country codes (alpha-2 ISO 3166) to search for people.
Array of string
List of people IDs to include in the search.
Array of string
List of people linkedin handles to include in the search.
Array of string
List of people IDs to exclude from the search.
Array of string
List of people linkedin handles to exclude from the search.
Array of string
Filter by seniorities. Available values are located at /v2/data-fields endpoint.
Array of Seniority
enum
"Owner""Founder""Board Member""C-Level""Partner""VP""Head""Director""Manager""Other"
Filter by skills
The LinkedIn profile skills must include all of these keywords
Array of string
The LinkedIn profile skills must include at least one of these keywords
Array of string
The LinkedIn profile skills must not include any of these keywords
Array of string
Filter by keywords present in job titles
Match all of the keywords
Array of string
Match at least one of the keywords
Array of string
Match none of the keywords
Array of string
Filter by all job descriptions
Job descriptions must include all of these
Array of string
Job descriptions must include at least one of these
Array of string
Job descriptions must not include any of these
Array of string
Filter by current job description
The current job description must include all of these
Array of string
The current job description must include at least one of these
Array of string
The current job description must not include any of these
Array of string
Filter by profile description
The LinkedIn profile description must include all of these keywords
Array of string
The LinkedIn profile description must include at least one of these keywords
Array of string
The LinkedIn profile description must not include any of these keywords
Array of string
List of region codes to search for people.
Array of string
List of states/regions to search for people (ISO-3166-2 region codes). Available abbreviation values are located at /v2/data-fields endpoint (region section).
Array of State
country string Required
Alpha-2 ISO 3166 country code
abbreviation string Required
Valid state abbreviation. List available in the region section there: /v2/data-fields.
List of states/regions to exclude when searching for people (ISO-3166-2 region codes). Available abbreviation values are located at /v2/data-fields endpoint (region section).
Array of State
country string Required
Alpha-2 ISO 3166 country code
abbreviation string Required
Valid state abbreviation. List available in the region section there: /v2/data-fields.
List of country codes (alpha-2 ISO 3166) to exclude when searching for people.
Array of string
List of cities to search for people.
Array of PeopleCityFilter
city string Required
City name
country string
Alpha-2 ISO 3166 country code
Filter by country region (if applicable)
country string Required
Alpha-2 ISO 3166 country code
abbreviation string Required
Valid state abbreviation. List available in the region section there: /v2/data-fields.
List of cities to exclude when searching for people.
Array of PeopleCityFilter
city string Required
City name
country string
Alpha-2 ISO 3166 country code
Filter by country region (if applicable)
country string Required
Alpha-2 ISO 3166 country code
abbreviation string Required
Valid state abbreviation. List available in the region section there: /v2/data-fields.
Filter by names
Array of string
Filter by departments. Available values are located at /v2/data-fields endpoint.<br>
Array of Department
enum
"Accounting and Finance""Board""Business Support""Customer Relations""Design""Editorial Personnel""Engineering""Founder/Owner""Healthcare""HR""Legal""Management""Manufacturing""Marketing and Advertising""Operations""PR and Communications""Procurement""Product""Quality Control""R&D""Sales""Security""Supply Chain""Other"
Exclude people by departments. Available values are located at /v2/data-fields endpoint.<br>
Array of Department
enum
"Accounting and Finance""Board""Business Support""Customer Relations""Design""Editorial Personnel""Engineering""Founder/Owner""Healthcare""HR""Legal""Management""Manufacturing""Marketing and Advertising""Operations""PR and Communications""Procurement""Product""Quality Control""R&D""Sales""Security""Supply Chain""Other"
Return records where specified fields exist
Array of enum
enum
"country""departments""firstName""jobTitle""jobTitleEnglish""lastName""linkedinUrl""location""name""photo""seniorities""summary"
Return records where specified fields do not exist
Array of enum
enum
"country""departments""firstName""jobTitle""jobTitleEnglish""lastName""linkedinUrl""location""name""photo""seniorities""summary"
changedPositionAfter string
Return people who started a new job between the specified date (inclusive) and now
changedPositionBefore string
Return people who started a new currently active job before the specified date (inclusive)
updatedWithinMonths integer
Filter people updated within the last N months.
Number of connections of the person on Linkedin
from integer
Greater than or equal to
to integer
Less than or equal to
Number of followers of the person on Linkedin
from integer
Greater than or equal to
to integer
Less than or equal to
Fields to return in the Company objects. Only requesting the fields that are needed will use less bandwidth and result in faster responses. If not specified, all fields are returned that can be seen in the example.
Array of CompanyField
enum
"domain""countries""primaryCountry""companySize""industryCategories""industries""linkedinIndustry""ecommerce""keywords""employeeCountOcean""employeeCountLinkedin""revenue""yearFounded""description""emails""phones""phones.number""phones.country""phones.primary""logo""technologies""technologyCategories""mobileApps""mobileApps.link""mobileApps.name""webTraffic""webTraffic.visits""webTraffic.pageViews""webTraffic.pagesPerVisit""medias""medias.linkedin""medias.twitter""medias.youtube""medias.facebook""medias.xing""medias.tiktok""medias.instagram""name""legalName""locations""locations.primary""locations.country""locations.locality""locations.region""locations.postalCode""locations.streetAddress""locations.state""locations.regionCode""departmentSizes""rootUrl""faxes""faxes.number""faxes.country""faxes.primary""impressum""impressum.company""impressum.address""impressum.email""impressum.phone""impressum.fax""impressum.vat""impressum.url""impressum.people""fundingRound""fundingRound.date""fundingRound.type""fundingRound.moneyRaisedInUsd""fundingRound.cbUrl""redirectedFrom""updatedAt""headcountGrowth""headcountGrowth.threeMonths""headcountGrowth.threeMonthsPercentage""headcountGrowth.sixMonths""headcountGrowth.sixMonthsPercentage""headcountGrowth.twelveMonths""headcountGrowth.twelveMonthsPercentage""headcountGrowthPerDepartment"

Responses

200 Successful Response
searchAfter string
Used for pagination. Use `searchAfter` returned by this request in the next request to get the next page of search results. If `searchAfter` is not present in the response then there is no next page.
detail string Required
Status text
total integer
Total number of results of the search, accessible with pagination.
Domains from `lookalikeDomains` filter that are either not present in Ocean's database or present but lacking necessary data to perform the search, along with the reason
object
Mapping of original domains passed in filters to their redirected domains.
object
creditsUsed number Required
Number of credits charged for this request.
Array of found companies. Returns empty array if no results
Array of PublicCompanyWithRelevance
Company found in the database
domain string Required
Domain of the company, used as a unique identifier
List of all countries in which the company operates
Array of string
primaryCountry string
Main country of the company
Company size range
enum
"0-1""2-10""11-50""51-200""201-500""501-1000""1001-5000""5001-10000""10001-50000""50001-100000""100001-500000""500000+"
Industry categories of the company<br>Available values can be found at /v2/data-fields endpoint.
Array of string
Industries of the company<br>Available values can be found at /v2/data-fields endpoint.
Array of string
linkedinIndustry string
Linkedin industry of the company<br>Available values can be found at /v2/data-fields endpoint.
ecommerce boolean
True if the company is an e-commerce company
Keywords associated with the company
Array of string
employeeCountOcean integer
Number of people working at the company in our database.
employeeCountLinkedin integer
Number of people linked to the company page on Linkedin. This number might be higher than `employeeCountOcean` because of private profiles.
Revenue range
enum
"0-1M""1-10M""10-50M""50-100M""100-500M""500-1000M"">1000M"
yearFounded integer
Year the company was founded
description string
Company's description
Emails of the company
Array of string
Phones of the company
Array of ContactNumber
number string Required
Contact number
country string
Country code of the contact number
primary boolean
True if the contact number is the primary contact number of the company
logo string
Logo of the company (URL)
Software technologies used by the company
Array of string
Technology categories of the company
Array of string
Mobile apps produced by the company
Array of MobileApp
link string
Website address for this app
name string Required
App name
Web traffic of the domain
visits integer
Total number of visits of the website for the last available month
pageViews integer
Number of views of the website for the last available month
pagesPerVisit number
Average number of pages viewed per visit for the last available month
bounceRate number
Bounce rate of the domain for the last available month
Social medias of the company
LinkedIn page associated with the company
url string Required
URL of the media
handle string
ids extracted from social media urls
name string
Name of the company as it appears in the social media account
Specialties of the company as it appears in the social media account. Right now we only have this for LinkedIn.
Array of string
Twitter page associated with the company
url string Required
URL of the media
handle string
ids extracted from social media urls
name string
Name of the company as it appears in the social media account
Specialties of the company as it appears in the social media account. Right now we only have this for LinkedIn.
Array of string
YouTube page associated with the company
url string Required
URL of the media
handle string
ids extracted from social media urls
name string
Name of the company as it appears in the social media account
Specialties of the company as it appears in the social media account. Right now we only have this for LinkedIn.
Array of string
Facebook page associated with the company
url string Required
URL of the media
handle string
ids extracted from social media urls
name string
Name of the company as it appears in the social media account
Specialties of the company as it appears in the social media account. Right now we only have this for LinkedIn.
Array of string
Xing page associated with the company
url string Required
URL of the media
handle string
ids extracted from social media urls
name string
Name of the company as it appears in the social media account
Specialties of the company as it appears in the social media account. Right now we only have this for LinkedIn.
Array of string
TikTok page associated with the company
url string Required
URL of the media
handle string
ids extracted from social media urls
name string
Name of the company as it appears in the social media account
Specialties of the company as it appears in the social media account. Right now we only have this for LinkedIn.
Array of string
Instagram page associated with the company
url string Required
URL of the media
handle string
ids extracted from social media urls
name string
Name of the company as it appears in the social media account
Specialties of the company as it appears in the social media account. Right now we only have this for LinkedIn.
Array of string
name string
Name of the company
legalName string
Legal name of the company
Locations of the company
Array of Location
primary boolean
True if the location is the headquarter of the company
latitude number
Latitude of the location
longitude number
Longitude of the location
country string
Country code of the location
locality string
Locality (city) of the location
region string
Region of the location. Available abbreviation values are located at /v2/data-fields endpoint (region section)
postalCode string
Postal code of the location
streetAddress string
Street address of the location
state string Deprecated
Abbreviation of the location (if applicable). Available abbreviation values are located at /v2/data-fields endpoint (region section). Deprecated, please use `region` instead
regionCode string
Region code of the location
Number of employees per department
Array of DepartmentSize
Department name
enum
"Accounting and Finance""Board""Business Support""Customer Relations""Design""Editorial Personnel""Engineering""Founder/Owner""Healthcare""HR""Legal""Management""Manufacturing""Marketing and Advertising""Operations""PR and Communications""Procurement""Product""Quality Control""R&D""Sales""Security""Supply Chain""Other"
size integer Required
Department size
rootUrl string
Root url to access the website
Faxes of the company
Array of ContactNumber
number string Required
Contact number
country string
Country code of the contact number
primary boolean
True if the contact number is the primary contact number of the company
Impressum (Imprint) data of the company (only for Germany, Austria, Switzerland)
company string
Company name as mentioned in Impressum
address string
Company address as mentioned in Impressum
email string
Company email as mentioned in Impressum
phone string
Company phone as mentioned in Impressum
fax string
Company fax as mentioned in Impressum
vat string
VAT number as mentioned in Impressum
url string
url where Impressum can be found
People mentioned in Impressum
Array of ImpressumPerson
name string Required
position string
Funding round of the company
date string
Date of the funding round
Type of the funding round
enum
"Seed""Series A""Angel""Series B""Series Unknown""Pre-Seed""Grant""Series C""Convertible Note""Debt Financing""Non-Equity Assistance""Undisclosed""Series D""Corporate Round""Equity Crowdfunding""Product Crowdfunding""Series E""Private Equity""Secondary Market""Initial Coin Offering""Post-IPO Equity""Series F""Post-IPO Debt""Series H""Series G""Post-IPO Secondary""Series I""Series J"
moneyRaisedInUsd integer
Amount of money raised in USD
cbUrl string
URL of the funding round on Crunchbase
Urls that redirects to this domain. We provide maximum 10 urls in this field.
Array of string
updatedAt string
When has the company data been updated for the last time
Headcount growth of the company
threeMonths integer
Actual headcount change (positive or negative number)
threeMonthsPercentage number
Headcount growth as a decimal (e.g., 0.15 represents 15% growth)
sixMonths integer
Actual headcount change (positive or negative number)
sixMonthsPercentage number
Headcount growth as a decimal (e.g., 0.15 represents 15% growth)
twelveMonths integer
Actual headcount change (positive or negative number)
twelveMonthsPercentage number
Headcount growth as a decimal (e.g., 0.15 represents 15% growth)
Headcount growth per department
Array of DepartmentSizesGrowth
Department name
enum
"Accounting and Finance""Board""Business Support""Customer Relations""Design""Editorial Personnel""Engineering""Founder/Owner""Healthcare""HR""Legal""Management""Manufacturing""Marketing and Advertising""Operations""PR and Communications""Procurement""Product""Quality Control""R&D""Sales""Security""Supply Chain""Other"
Headcount growth per department
threeMonths integer
Actual headcount change (positive or negative number)
threeMonthsPercentage number
Headcount growth as a decimal (e.g., 0.15 represents 15% growth)
sixMonths integer
Actual headcount change (positive or negative number)
sixMonthsPercentage number
Headcount growth as a decimal (e.g., 0.15 represents 15% growth)
twelveMonths integer
Actual headcount change (positive or negative number)
twelveMonthsPercentage number
Headcount growth as a decimal (e.g., 0.15 represents 15% growth)
relevance enum
Relevance category (A - the most relevant)
"A""B""C"
Domains from `includeDomains` filter that were not found in the search results, along with the reason
object
400 Bad Request
detail enum Required
"Conflicting API tokens provided in query parameters and headers"
402 Payment Required
detail enum Required
"Insufficient credits"
403 Forbidden
detail enum Required
"API token should be provided in headers or query parameters""Current API token is not registered in our database"
404 Not found
422 Validation Error
Array of ValidationError
Array of string | integer
string | integer
msg string Required
type string Required
input any
object

FAQs#

How many results can I get per request?

Up to 10,000 per request (default is 50). Use searchAfter to paginate beyond 10,000 total results. See Pagination for details.

How do I find valid values for industries, technologies, and locations?

Use the Autocomplete endpoints for typeahead lookups, or call Get Data Fields to retrieve the full reference lists.

Can I combine companiesFilters and peopleFilters in the same search?

Yes. Adding peopleFilters narrows the results to companies that have at least one employee matching those criteria. For example, combine companiesFilters.technologies with peopleFilters.seniorities to find companies using Salesforce that have C-Level contacts.

What is the difference between primaryLocations and locations?

primaryLocations filters by the company's main headquarters country/region. locations includes any office location worldwide. Use primaryLocations for HQ-focused targeting and locations when you want to find companies with any presence in a region.