API
Get API key

Search for Contacts

post
https://api.apollo.io/api/v1/contacts/search

✅

No Credit Cost

This endpoint doesn't consume Apollo credits. Learn more about API pricing and credits.

Contacts are people saved in Apollo.

Use the Search for Contacts endpoint to search for the contacts that have been added to your team's Apollo account.

This endpoint only returns contacts in the search results. To search for people in the Apollo database, call the People API Search endpoint.

To protect Apollo's performance for all users, this endpoint has a display limit of 50,000 records (100 records per page, up to 500 pages). Add more filters to narrow your search results as much as possible.

Body Params
string

Add keywords to narrow the search of the contacts in your team's Apollo account. Keywords can include combinations of names, job titles, employers (company names), and email addresses. Examples: tim zheng; senior research analyst; microsoft

contact_stage_ids
array of strings

The Apollo IDs for the contact stages that you want to include in your search results. If you add multiple contact stages, Apollo will include all contacts that match any of the stages, along with the other parameters, in the search results. Call the List Contact Stages endpoint to retrieve a list of all the contact stage IDs available in your Apollo account. Example: 6095a710bd01d100a506d4ae

contact_stage_ids
contact_label_ids
array of strings

The Apollo IDs for the labels that you want to include in your search results. If you add multiple labels, Apollo will include all contacts connected to any of the labels, along with the other parameters, in the search results. Example: ['6095a710bd01d100a506d4ae']

contact_label_ids
string

Sort the matching contacts by 1 of the following options:

  • contact_last_activity_date: The most recent activity date recorded first.
  • contact_email_last_opened_at: The most recent email opened date first.
  • contact_email_last_clicked_at: The most recent email clicked first.
  • contact_created_at: The most recently created first.
  • contact_updated_at: The most recently updated first.
boolean
Defaults to false

Set to true to sort the matching contacts in ascending order. This parameter must be used with sort_by_field. Otherwise, the sorting logic is not applied. Example: true

int32

The number of search results that should be returned for each page. Limiting the number of results per page improves the endpoint's performance. Use the page parameter to search the different pages of data. Example: 10

int32

The page number of the Apollo data that you want to retrieve. Use this parameter in combination with the per_page parameter to make search results navigable and improve the performance of the endpoint. Example: 4

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated 2 days ago

What’s Next

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/plain

Updated 2 days ago

What’s Next