Search

Search companies

One row per company domain. Company-level filters only (industries, headquarters, size, domain, funding, …). Person-level filters (job_titles, seniority, …) return 400 — use /api/v1/contacts/search for people. Charges 1 credit per company returned. contact_count is the number of matching contact rows at that company.

post/api/v1/companies/search

Request

  • Base URL: https://app.getleads.io
  • URL: https://app.getleads.io/api/v1/companies/search
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Request body

domainsstring[]
job_titlesstring[]
senioritystring[]
job_functionsstring[]
industriesstring[]
countriesstring[]
headquarters_countriesstring[]
company_sizestring[]

LinkedIn size-band labels (e.g. "51 to 200").

company_linkedin_urlsstring[]
revenuestring[]
citiesstring[]
statesstring[]
exclude_domainsstring[]
exclude_countriesstring[]
exclude_headquarters_countriesstring[]
exclude_industriesstring[]
exclude_job_titlesstring[]
email_statusstring[]

Email verification status. Use ["VALID"] for deliverable emails.

technologiesstring[]

Technologies/tools a company uses.

funding_typesstring[]

Last funding round type (e.g. "Seed", "Series A", "IPO").

headquarters_citiesstring[]
company_namestring
email_domainstring
first_namestring
last_namestring
email_addressstring
linkedin_urlstring
company_descriptionstring

Keyword search over company LinkedIn About text.

person_descriptionstring

Keyword search over person LinkedIn bio.

linkedin_headlinestring
educationstring
certificationsstring
languagesstring
job_start_date_minstring date

Earliest current-role start date (YYYY-MM-DD).

job_start_date_maxstring date

Latest current-role start date (YYYY-MM-DD).

skillsstring

Keyword search over contact skills.

domain_list_idstring

Saved domain list id.

company_size_mininteger
company_size_maxinteger
employees_mininteger

Minimum company headcount (band-overlap matching).

employees_maxinteger

Maximum company headcount (band-overlap matching).

employee_profiles_on_linkedin_mininteger

Minimum exact LinkedIn employee-profile headcount (hard cutoff).

employee_profiles_on_linkedin_maxinteger

Maximum exact LinkedIn employee-profile headcount (hard cutoff).

founded_year_mininteger

Earliest founding year.

founded_year_maxinteger

Latest founding year.

total_funding_mininteger

Minimum total funding raised (USD).

total_funding_maxinteger

Maximum total funding raised (USD).

require_emailboolean
require_phoneboolean
require_company_profileboolean

Skip contacts with no company name. Defaults on for domain-only searches that request company columns.

require_domain_or_headlineboolean

Rank contacts with a company domain or LinkedIn headline first; remaining matches still appear later. Defaults on for the new database.

has_mobile_appboolean
has_web_appboolean
open_to_workboolean

Only contacts with LinkedIn Open to Work signal.

is_hiringboolean

Only contacts with LinkedIn Hiring badge.

limitinteger
offsetinteger
columnsstring[]

Company columns only. Discover with GET /api/v1/companies/columns.

where_sqlstring

Response

Matching companies

okboolean
companiesobject[]
total_availableinteger
total_available_is_minimumboolean
query_credits_usedinteger
creditsRemaininginteger nullable
offsetinteger
limitinteger
returnedinteger
has_moreboolean
next_offsetinteger

Changes

No recorded changes to this operation across all 1 revision of this API.