Company search

Company search builds a target account list from the criteria that define your ideal customer profile. Send every company request to POST /search/company.

Which company field names should you use?

The operator a field accepts depends on the field’s type. Text fields accept only the text operator. Typed fields, such as strings and integers, accept equals, in and range. Sending equals to a text field returns HTTP 400.

Field	Type	Operators	Notes
`industry`	text	`text`	Word match, for example `software`
`name`	text	`text`	Company name
`about`, `slogan`, `specialties`	text	`text`	Descriptive text
`headquarters_location`	text	`text`	Descriptive location string
`headquarters_country_code`	string	`equals`, `in`	ISO 3166 alpha-2 code such as `US` or `GB`
`headquarters_city`	string	`equals`	Exact city name
`offices_country_codes`	array of strings	`in`	Countries where the company has an office
`offices_cities`	array of strings	`in`	Cities where the company has an office
`organization_type`	string	`equals`	One of `Privately Held`, `Public Company`, `Nonprofit`, `Educational`, `Self-Employed` or `Government Agency`
`founded_year`	integer	`range`, `equals`
`employees_in_linkedin`	integer	`range`	Headcount recorded at the source
`company_size_from`, `company_size_to`	integer	`range`	Self-reported size band
`funding_stage`	string	`equals`, `in`	Latest round type
`funding_raised`	integer	`range`	Amount of the last round, in USD
`linkedin_followers`	integer	`range`	Follower count

funding_stage accepts pre-seed, seed, angel, series-a, series-b, series-c, series-d, series-e, series-unknown, grant, debt, convertible-note, crowdfunding, non-equity-assistance, corporate-round, private-equity and undisclosed.

What does a company search request look like?

This Ludicrous request finds US companies with software in their industry and 50 to 500 employees on record. It also requests the founding year and follower count as output fields:

{
  "mode": "ludicrous",
  "query": {
    "and": [
      { "text": { "industry": "software" } },
      { "equals": { "headquarters_country_code": "US" } },
      {
        "range": {
          "employees_in_linkedin": { ">=": 50, "<=": 500 }
        }
      }
    ]
  },
  "offset": 0,
  "limit": 10,
  "view": {
    "fields": [
      "name", "website", "industry",
      "headquarters_country_code", "employees_in_linkedin",
      "founded_year", "linkedin_followers", "url"
    ]
  }
}

A field you select for output does not become a search condition. The view list above returns founded_year, but it does not restrict the search to companies that have a founding year on record. Conditions live in query, output lives in view.

How should you read employees_in_linkedin?

employees_in_linkedin is the headcount recorded in the source profile. Do not treat it as a guaranteed total company headcount. When your product shows a headcount to an end user, label the source rather than presenting the number as the company’s official size. company_size_from and company_size_to, when available, represent the company size range. Use them when you need a band rather than a point estimate. Roughly 40 percent of company records have no headcount on record and store employees_in_linkedin as 0. For a reliable size filter, combine the headcount range with the size band and keep the lower bound of employees_in_linkedin at 1 or higher, so records with an unknown count drop out:

{
  "and": [
    { "range": { "employees_in_linkedin": { ">=": 50, "<=": 200 } } },
    { "range": { "company_size_from": { "<=": 200 } } },
    { "range": { "company_size_to": { ">=": 50 } } }
  ]
}

A record qualifies when its headcount is in the range and its self-reported band overlaps it.

Which fields does the summary view return?

The summary view returns 14 fields: name, slogan, industry, headquarters_location, headquarters_country_code, offices_cities, company_size_from, company_size_to, employees_in_linkedin, linkedin_followers, website, domain, url and logo. A field the record has no value for is left out rather than returned as null. founded_year is not in summary, so request it in a fields list. See Business Search field views.

Get started

Data extraction

Web search

AI training data

Proxy networks

Which company field names should you use?

What does a company search request look like?

How should you read employees_in_linkedin?

Which fields does the summary view return?

​Which company field names should you use?

​What does a company search request look like?

​How should you read employees_in_linkedin?

​Which fields does the summary view return?

Which company field names should you use?

What does a company search request look like?

How should you read employees_in_linkedin?

Which fields does the summary view return?