Search

Search contacts

Paginated contact search with filters. Returns up to limit contacts (default 1000, max 5000). Charges 1 credit per contact returned.

post/api/v1/contacts/search

Request

  • Base URL: https://app.getleads.io
  • URL: https://app.getleads.io/api/v1/contacts/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 in the same page and CSV. Defaults on for the new database. Set false for the raw sort key.

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

Page size.

offsetinteger

Pagination offset.

max_per_companyinteger

Cap contacts per company.

columnsstring[]

Columns to include by display label or internal name. Discover names with GET /api/v1/contacts/columns. Unknown Classic-only names return invalid_columns and column_replacements.

where_sqlstring

Advanced WHERE predicate on catalog fields. AND-combined with curated filters.

Response

Matching contacts

okboolean
contactsContact[]
total_availableinteger
total_available_is_minimumboolean
query_credits_usedinteger
creditsRemaininginteger nullable
offsetinteger
limitinteger
returnedinteger
has_moreboolean
next_offsetinteger
max_per_companyinteger
credits_exhaustedboolean
messagestring
codestring
pagination_warningstring

Changes