Search for Contacts

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

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

In Apollo terminology, a contact is a person that your team has explicitly added to your database. A contact will have their data enriched in some way, such as accessing an email address or a phone number.

This endpoint only returns contacts in the search results. To search for people in the Apollo database, call the People 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. This limitation does not restrict your access to Apollo's database; you just need to access the data in batches.

This feature is not accessible to Apollo users on free plans.

Query Params

q_keywords

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[]

sort_by_field

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.

sort_ascending

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

per_page

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 for navigable and improve the performance of the endpoint.

Example: 4

page

int32

The number of search results that should be returned for each page. Limited the number of results per page improves the endpoint's performance.

Use the page parameter to search the different pages of data.

Example: 10

Responses

Response body

object

contacts

array of objects

contacts

object

contact_roles

array

contact_roles

string

first_name

string

last_name

string

name

string

linkedin_url

string

title

string

contact_stage_id

string

owner_id

string

creator_id

string

person_id

string

email_needs_tickling

string

organization_name

string

source

string

original_source

string

organization_id

string

headline

string

photo_url

string

present_raw_address

string

linkedin_uid

string

extrapolated_email_confidence

string

salesforce_id

string

salesforce_lead_id

string

salesforce_contact_id

string

salesforce_account_id

string

crm_owner_id

string

created_at

string

emailer_campaign_ids

array

emailer_campaign_ids

direct_dial_status

string

direct_dial_enrichment_failed_at

string

email_status

string

email_source

string

account_id

string

last_activity_date

string

hubspot_vid

string

hubspot_company_id

string

crm_id

string

sanitized_phone

string

merged_crm_ids

string

updated_at

string

queued_for_crm_push

boolean

Defaults to true

suggested_from_rule_engine_config_id

string

email_unsubscribed

string

label_ids

array

label_ids

has_pending_email_arcgate_request

boolean

Defaults to true

has_email_arcgate_request

boolean

Defaults to true

existence_level

string

email_from_customer

boolean

Defaults to true

typed_custom_fields

object

custom_field_errors

object

crm_record_url

string

email_status_unavailable_reason

string

email_true_status

string

updated_email_true_status

boolean

Defaults to true

contact_rule_config_statuses

array

contact_rule_config_statuses

source_display_name

string

twitter_url

string

contact_campaign_statuses

array

contact_campaign_statuses

account

object

contact_emails

array

contact_emails

organization

object

intent_strength

string

show_intent

boolean

Defaults to true

phone_numbers

array

phone_numbers

account_phone_note

string

free_domain

boolean

Defaults to true

is_likely_to_engage

boolean

Defaults to true

email_domain_catchall

boolean

Defaults to true

contact_job_change_event

string

breadcrumbs

array of objects

breadcrumbs

object

label

string

signal_field_name

string

value

string

display_name

string

partial_results_only

boolean

Defaults to true

has_join

boolean

Defaults to true

disable_eu_prospecting

boolean

Defaults to true

partial_results_limit

integer

Defaults to 0

pagination

object

page

integer

Defaults to 0

per_page

integer

Defaults to 0

total_entries

integer

Defaults to 0

total_pages

integer

Defaults to 0

num_fetch_result

string

Language

Credentials

Header


xxxxxxxxxx
1
curl --request POST \
2
     --url 'https://api.apollo.io/api/v1/contacts/search?sort_ascending=false' \
3
     --header 'Cache-Control: no-cache' \
4
     --header 'Content-Type: application/json' \
5
     --header 'accept: application/json'


xxxxxxxxxx
333
}
1
{
2
  "contacts": [
3
    {
4
      "contact_roles": [],
5
      "id": "66e3726977d36c03f2c30afc",
6
      "first_name": "Walt",
7
      "last_name": "Whitman",
8
      "name": "Walt Whitman",
9
      "linkedin_url": null,
10
      "title": "Associate Writer",
11
      "contact_stage_id": "6095a710bd01d100a506d4ae",
12
      "owner_id": "60affe7d6e270a00f5db6fe4",
13
      "creator_id": "60affe7d6e270a00f5db6fe4",
14
      "person_id": null,
15
      "email_needs_tickling": null,
16
      "organization_name": "Apollo.io",
17
      "source": "api",
18
      "original_source": "api",
19
      "organization_id": "5e66b6381e05b4008c8331b8",
20
      "headline": null,
21
      "photo_url": null,
22
      "present_raw_address": null,
23
      "linkedin_uid": null,
24
      "extrapolated_email_confidence": null,
25
      "salesforce_id": null,

200200

401401

403403

429429