Search

Count matching contacts

Returns the count of contacts matching the filters. Free (0 credits).

post/api/v1/contacts/search/count

Request

  • Base URL: https://app.getleads.io
  • URL: https://app.getleads.io/api/v1/contacts/search/count
  • 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.

Response

Count result

okboolean
total_matchinginteger
total_matching_is_minimumboolean
max_export_rowsinteger
exportable_rowsinteger
export_cappedboolean
credits_used0
creditsRemaininginteger nullable
messagestring
codestring

Changes

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