Search contacts

post

https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-contacts

Search for contacts based on various filters such as name, title, company, location, etc. Requires authentication via Bearer token or API key in query parameter. The limit parameter is required and must be between 1 and 500.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

api_key

string

required

API key for authentication. Without this parameter, the request returns 401 Unauthorized with message 'API key is required'.

Body Params

name

array of strings

length ≤ 2000

Filter by full name

name

firstName

array of strings

length ≤ 2000

Filter by first name

firstName

lastName

array of strings

length ≤ 2000

Filter by last name

lastName

title

array of strings

length ≤ 2000

Filter by job title

title

excludeTitle

array of strings

length ≤ 2000

Exclude contacts with these titles

excludeTitle

excludeCompany

array of strings

length ≤ 2000

Exclude these companies

excludeCompany

excludeCompanyDomain

array of strings

length ≤ 2000

Exclude these company domains

excludeCompanyDomain

includeTitle

array of strings

length ≤ 2000

Include only these titles

includeTitle

includeCompany

array of strings

length ≤ 2000

Include only these companies

includeCompany

includeCompanyDomain

array of strings

length ≤ 2000

Include only these company domains

includeCompanyDomain

department

array of strings

length ≤ 2000

Filter by department

department

level

array of strings

length ≤ 2000

Filter by seniority level

level

companyName

array of strings

length ≤ 2000

Filter by company name

companyName

companyDomain

array of strings

length ≤ 2000

Filter by company domain

companyDomain

companyKeyword

array of strings

length ≤ 2000

Filter by company keyword

companyKeyword

companyHeadCount

array of strings

length ≤ 2000

Filter by company headcount range

companyHeadCount

companyRevenue

array of strings

length ≤ 2000

Filter by company revenue

companyRevenue

companyIndustry

array of strings

length ≤ 2000

Filter by industry

companyIndustry

companySubIndustry

array of strings

length ≤ 2000

Filter by sub-industry

companySubIndustry

city

array of strings

length ≤ 2000

Filter by city

city

state

array of strings

length ≤ 2000

Filter by state

state

country

array of strings

length ≤ 2000

Filter by country

country

dontDisplayOwnedContact

boolean

Exclude contacts already owned

limit

number

required

1 to 500

Number of contacts to return (1-500)

scroll_id

string

Pagination scroll ID for next page

titleExactMatch

boolean

Match title exactly

companyExactMatch

boolean

Match company exactly

companyDomainExactMatch

boolean

Match company domain exactly

Responses

Language

Credentials

Bearer

JWT

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successfully retrieved contacts

400Invalid request (e.g., invalid limit parameter or array exceeds max 2000 items)

401Unauthorized - Missing or invalid API key. Returned when api_key is not provided in the query parameter.

500Internal server error