Apollo.io (Cookie)

🌳 Prefer to use the API? Try canadesk/apollo-io-api.

🛑 Please first install a cookie exporter such as: https://chromewebstore.google.com/detail/cookie-editor/ookdjilphngeeeghgngjabigmpepanpl. Then, log in to Apollo.io, go to the Search screen, click the extension, and choose "Export" with the type "Header string". Paste the content into the Cookie field in the Actor's Input.

💡 It is recommended to refresh cookies often. Your plan determines how many results and credits you get. For example, unverified free plans can only fetch 125 search results at a time, in which case you would have to run 10 different URLs (with different filters) to get up to 1,250 results. The API will likely return a lot more results for search: canadesk/apollo-io-api.

Input

• Cookie (string)

  Required. See above.

• Process (select)

  • Find People

    Returns information about people based on your filters.

    If you want to enrich the returned data at the same time, set Search Mode to "enrich" (will consume credits).

    You can either enter your people search URL (../people?..) or use Custom Input.

    Custom Input compatible filters:

    💡 Creating Personas and entering their IDs in "q_person_persona_ids" is the easiest.

    1[
    2	"contact_email_exclude_catch_all",			// true, false
    3	"person_seniorities",						// array
    4	"person_titles",							// array
    5	"person_not_titles",						// array
    6	"person_locations",							// array
    7	"person_not_locations",						// array
    8	"organization_num_employees_ranges",		// array
    9	"organization_industry_tag_ids",			// array
    10	"q_organization_keyword_tags",				// array
    11	"q_anded_organization_keyword_tags",		// array
    12	"q_not_organization_keyword_tags",			// array
    13	"open_factor_names",						// array
    14	"prospected_by_current_team",				// array
    15	"contact_email_status_v2",					// array
    16	"q_person_persona_ids",						// array
    17	"exist_fields",								// array
    18	"q_not_organization_search_list_id",		// string
    19	"excluded_organization_keyword_fields",		// array
    20	"typed_custom_fields",						// array
    21	"page"										// string - you can set this to start from a specific page
    22]
    

  • Find Organizations

    Returns information about organizations based on your filters.

    If you want to enrich the returned data at the same time, set Search Mode to "enrich" (will consume credits).

    You can either enter your organizations search URL (../companies?..) or use Custom Input.

    Custom Input compatible filters:

    1[
    2	{
    3		"organization_num_employees_ranges",    // array of strings (e.g., ["1-10"])
    4		"exist_fields",                         // array of strings
    5		"q_not_organization_search_list_id",    // string
    6		"organization_locations",               // array of strings (e.g., ["new york"])
    7		"organization_not_locations",           // array of strings (e.g., ["california"])
    8		"organization_industry_tag_ids",        // array of strings
    9		"q_organization_keyword_tags",          // array of strings (e.g., ["technology"])
    10		"included_organization_keyword_fields", // array of strings
    11		"q_not_organization_keyword_tags",      // array of strings
    12		"excluded_organization_keyword_fields", // array of strings
    13		"open_factor_names",                    // array of strings
    14		"typed_custom_fields",                  // array of strings
    15		"page"									// string - you can set this to start from a specific page
    16	}
    17]
    

  • Enrich People

    Enhances the provided information about people based on your filters. Will consume email or phone credits.

    You can either enter a person URL (../people..) or use Custom Input.

    Custom Input only accepts one key of type ARRAY:

    1[
    2	{
    3		"entities_ids",			// ["personID1", "personID2"] - up to 10 entries
    4	}
    5]
    

• URLs (array)

  Enter the URLs from Apollo.io. They must match the process to run. Overrides Custom Input.

  For example, a search people URL looks like "/people?" while URLs for enriching people look like "/people/{id}".

  The following would run multiple queries, up to the maximum of pages allowed by your plan, for people working for a companies with a number of employees going from 10 to 40:

  1[
  2	"https://app.apollo.io/#/people?page=1&organizationNumEmployeesRanges[]=1,10...",
  3	"https://app.apollo.io/#/people?page=1&organizationNumEmployeesRanges[]=10,15...",
  4	"https://app.apollo.io/#/people?page=1&organizationNumEmployeesRanges[]=15,20...",
  5	"https://app.apollo.io/#/people?page=1&organizationNumEmployeesRanges[]=20,25...",
  6	"https://app.apollo.io/#/people?page=1&organizationNumEmployeesRanges[]=25,30...",
  7	"https://app.apollo.io/#/people?page=1&organizationNumEmployeesRanges[]=30,40..."
  8]
  

• Custom Input (array)

  Remove any URLs before proceeding.

  Must be a valid JSON object with the fields relevant to the process you want to run. Do not leave empty values!

  For example, assuming the process is set to "Find People", this will run 2 separate queries with different filters:

  1[
  2	{
  3		"contact_email_status_v2": ["verified"],
  4		"organization_locations": ["new york"]
  5	},
  6	{
  7		"contact_email_status_v2": ["unverified"],
  8		"organization_locations": ["los angeles"]
  9	}
  10]
  

  💡 You cannot run different processes (e.g., "Find People" and "Find Organizations") in the same run.

• Sort by / Order (select)

  Returns sorted results (e.g., descending Company title).

• Search mode (select)

  Only applies to "Find" processes.

  • Search only: Returns data without any enrichment.

  • Search & Enrich: Returns enriched data (additional requests) for each search result.

  🛑 This consumes export credits. If Enrichment mode is set to email or phone, this will also consume credits!

  • Search & Jobs (Org.): Returns organizations data along with all open job postings. Requires API Key https://knowledge.apollo.io/hc/en-us/articles/4415734629773-Create-API-Keys!

• Enrichment mode (People) (select)

  Choose one of:

  • Default: Will consume 1 credit per person for work email verification.

  • Reveal phone numbers: Will consume 1 credit per person for phone verification. The phone numbers may not be returned immediately.

• Maximum results (integer)

  Defines how many results will be returned for the process (e.g., 50 for 50 people from process "Find People")

• Save on usage costs (select)

  • Default: Pushes new rows to Apify dataset with each request.

  • Wrapped: Pushes a single row per page. If any request fails, nothing at all will be returned! Only use for single queries.

Examples

💡 Some values are set to "redacted". They will be available in the results, but have been removed here.

"Find People" with Search Mode = "enrich" and Enrichment Mode = "default"

-- INPUT --

1[
2	"https://app.apollo.io/#/people?page=1&organizationNumEmployeesRanges[]=1%2C10&prospectedByCurrentTeam[]=no&contactEmailStatusV2[]=verified&&existFields[]=organization_id&sortAscending=true&sortByField=person_title_normalized"
3]

-- OUTPUT --

1[
2	{
3		"id": "6792d15cc135d901b0d54687",
4		"first_name": "redacted",
5		"last_name": "redacted",
6		"name": "redacted",
7		"linkedin_url": "http://www.linkedin.com/in/redacted",
8		"title": "🧩 Co-Founder and Sales Lead at Software Mingle 🧩",
9		"email_status": "verified",
10		"photo_url": null,
11		"twitter_url": null,
12		"github_url": null,
13		"facebook_url": null,
14		"extrapolated_email_confidence": null,
15		"headline": "🧩 Co-Founder and Sales Lead at Software Mingle 🧩",
16		"email": "redacted@softwaremingle.com",
17		"organization_id": "64f36e749a24ea01ad9dcf76",
18		"employment_history": [
19			{
20				"_id": "677f9e53cd1ddd00014af97c",
21				"created_at": null,
22				"current": true,
23				"degree": null,
24				"description": null,
25				"emails": null,
26				"end_date": null,
27				"grade_level": null,
28				"kind": null,
29				"major": null,
30				"organization_id": "64f36e749a24ea01ad9dcf76",
31				"organization_name": "Software Mingle",
32				"raw_address": null,
33				"start_date": "2023-01-01",
34				"title": "🧩 Co-Founder and Sales Lead at Software Mingle 🧩",
35				"updated_at": null,
36				"id": "677f9e53cd1ddd00014af97c",
37				"key": "677f9e53cd1ddd00014af97c"
38			},
39			...
40		],
41		"state": "New York",
42		"city": "New York",
43		"country": "United States",
44		"organization": {
45			"id": "64f36e749a24ea01ad9dcf76",
46			"name": "Software Mingle",
47			"website_url": "http://www.softwaremingle.com",
48			"linkedin_url": "http://www.linkedin.com/company/software-mingle",
49			"linkedin_uid": "98644093",
50			"logo_url": "https://zenprospect-production.s3.amazonaws.com/uploads/pictures/678eaeaa34739c00010dc6ae/picture",
51			"primary_domain": "softwaremingle.com"
52		},
53		"departments": [
54			"c_suite",
55			"master_engineering_technical",
56			"master_sales"
57		],
58		"subdepartments": [
59			"founder",
60			"software_development",
61			"sales"
62		],
63		"seniority": "founder",
64		"functions": [
65			"sales",
66			"engineering",
67			"entrepreneurship"
68		],
69		"intent_strength": null,
70		"show_intent": false,
71		"email_domain_catchall": true,
72		"revealed_for_current_team": true,
73		"contact_roles": [],
74		"contact_stage_id": "679029a2852c0301b112538d",
75		"owner_id": "679029a5852c0301b112556a",
76		"creator_id": "679029a5852c0301b112556a",
77		"person_id": "66f86a448dcef000014b7f0c",
78		"email_needs_tickling": true,
79		"organization_name": "Software Mingle",
80		"source": "search",
81		"original_source": "search",
82		"present_raw_address": "New York, New York, United States",
83		"linkedin_uid": "88631783",
84		"salesforce_id": null,
85		"salesforce_lead_id": null,
86		"salesforce_contact_id": null,
87		"salesforce_account_id": null,
88		"crm_owner_id": null,
89		"created_at": "2025-01-23T23:31:40.847Z",
90		"emailer_campaign_ids": [],
91		"direct_dial_status": null,
92		"direct_dial_enrichment_failed_at": null,
93		"email_source": "crm_csv",
94		"account_id": "6792d15cc135d901b0d54688",
95		"last_activity_date": null,
96		"hubspot_vid": null,
97		"hubspot_company_id": null,
98		"crm_id": null,
99		"sanitized_phone": null,
100		"merged_crm_ids": null,
101		"updated_at": "2025-01-23T23:31:40.847Z",
102		"queued_for_crm_push": null,
103		"suggested_from_rule_engine_config_id": null,
104		"email_unsubscribed": null,
105		"person_deleted": null,
106		"call_opted_out": null,
107		"label_ids": [],
108		"has_pending_email_arcgate_request": false,
109		"has_email_arcgate_request": false,
110		"existence_level": "full",
111		"email_from_customer": null,
112		"typed_custom_fields": {},
113		"custom_field_errors": {},
114		"crm_record_url": null,
115		"email_status_unavailable_reason": null,
116		"email_true_status": "Verifying",
117		"updated_email_true_status": true,
118		"source_display_name": "Requested from Apollo",
119		"contact_campaign_statuses": [],
120		"contact_emails": [],
121		"time_zone": "America/New_York",
122		"phone_numbers": [],
123		"account_phone_note": null,
124		"free_domain": false
125	}
126	...
127]

"Find Organizations" with Search Mode = "jobs"

-- INPUT --

1[
2	"https://app.apollo.io/#/companies?organizationNumEmployeesRanges[]=1000%2C5000&existFields[]=organization_id&page=1&sortByField=%5Bnone%5D&sortAscending=false"
3]

-- OUTPUT --

1[
2	{
3		"id": "5e56c2101b70ba0001a7aff6",
4		"name": "CNBC",
5		"website_url": "http://www.cnbc.com",
6		"linkedin_url": "http://www.linkedin.com/company/cnbc",
7		"twitter_url": "https://www.twitter.com/cnbc/",
8		"facebook_url": "https://www.facebook.com/cnbc/",
9		"primary_phone": {
10			"number": "+1 201-735-2622",
11			"source": "Owler",
12			"sanitized_number": "+12017352622"
13		},
14		"languages": [
15			"English",
16			"French",
17			...
18		],
19		"alexa_ranking": 540,
20		"phone": "+1 201-735-2622",
21		"linkedin_uid": "1833",
22		"founded_year": 1989,
23		"logo_url": "https://zenprospect-production.s3.amazonaws.com/uploads/pictures/67899fb627d1a60001c78c8d/picture",
24		"primary_domain": "cnbc.com",
25		"sanitized_phone": "+12017352622",
26		"owned_by_organization_id": null,
27		"organization_revenue_printed": "510M",
28		"organization_revenue": 510000000,
29		"intent_strength": null,
30		"show_intent": true,
31		"has_intent_signal_account": false,
32		"intent_signal_account": null,
33		"job_postings": [
34			{
35				"id": "67632ee5e322bb0001ca9fbb",
36				"title": "Vice President, Brand & Marketing, CNBC International",
37				"url": "https://uk.linkedin.com/jobs/view/vice-president-brand-marketing-cnbc-international-at-cnbc-4103431548?position=4&pageNum=0&refId=eFfC84duDRArAqmCGVXIZw%3D%3D&trackingId=%2FLnt41K8oZr5DlJgyFkVsg%3D%3D",
38				"city": "London",
39				"state": "England",
40				"country": "United Kingdom",
41				"last_seen_at": "2024-12-18T20:21:57.661+00:00",
42				"posted_at": "2024-12-18T04:21:57.661+00:00"
43			},
44			{
45				"id": "67809cab47854b0001f1aa0c",
46				"title": "Digital Rotational Program, CNBC Digital & CNBC TV",
47				"url": "https://www.linkedin.com/jobs/view/digital-rotational-program-cnbc-digital-cnbc-tv-at-cnbc-4118840565?position=3&pageNum=2&refId=8PcMt%2FHL1zOSNG7q3ZjbvA%3D%3D&trackingId=dgcPMV6RvoPPuhy3ai4KOw%3D%3D",
48				"city": "Englewood Cliffs",
49				"state": "New Jersey",
50				"country": "United States",
51				"last_seen_at": "2025-01-10T04:06:03.087+00:00",
52				"posted_at": "2025-01-09T22:06:03.087+00:00"
53			},
54			...
55		]
56	},
57	...
58]

Support

🛑 Limits are defined by your plan! We cannot guarantee the number of calls or credits consumed.

Apollo.io enforces additional restrictions on free accounts registered with a generic e-mail domain (@gmail, @outlook, etc.).

Open a new issue for features and bugs. Please share your Run URL + Input.

Cheers!