Apollo.io (API)

🌳 Using a generic email on free plan, or prefer to use your own cookies instead of the API? Try canadesk/apollo-io-cookie.

🛑 Please first create your Apollo.io API Key: https://knowledge.apollo.io/hc/en-us/articles/4415734629773-Create-API-Keys

Free Plan limitations

You will not be able to use the API if your account is linked to a generic email provider (@gmail, @outlook, @hotmail...) on the free plan. Use cookies instead.

Use this actor primarly for search/search export and job postings if you don't have many export credits. It is however very fast for mass enrichment for users with higher plans.

💡 For enrichment, always try this actor with a low maximum (1 to 10) at first so you don't consume too many credits! Each enrichment consumes 1 export credit. If you don't have any left, you will not be able to use the API altogether (including searches)!

Input

• 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).

    Compatible filters (all ARRAY, except for "q_keywords" STRING):

    1[
    2	{
    3		"person_titles",						// ["marketing manager"]
    4		"person_locations",						// ["new york"]
    5		"person_seniorities",					// ["vp"]
    6		"organization_locations",				// ["new york"]
    7		"q_organization_domains",				// ["abc.com"]
    8		"contact_email_status",					// ["verified", "unverified"] (e.g., set "verified" for verified-only)
    9		"organization_num_employees_ranges",	// ["1", "10] (e.g., 1-10 employees)
    10		"q_keywords"							// "biology teacher" (equivalent to free text search)
    11	}
    12]
    

  • 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).

    Compatible filters (all ARRAY, except for "q_organization_name" STRING):

    1[
    2	{
    3		"organization_num_employees_ranges",    // ["1-10"] (e.g., 1-10 employees)
    4		"organization_locations",               // ["new york"]
    5		"organization_not_locations",           // ["california"]
    6		"q_organization_keyword_tags",          // ["technology"]
    7		"q_organization_name"                 	// "ABC"
    8	}
    9]
    

  • Enrich People

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

    Apollo.io is unlikely to return data for very generic filters, such as only giving it first/last/full name.

    Compatible filters (all STRING values):

    1[
    2	{
    3		"first_name",			// "Joe"
    4		"last_name",			// "Smith"
    5		"name",					// "Joe Smith"
    6		"email",				// "js@abc.com"
    7		"organization_name",	// "ABC"
    8		"domain",				// "abc.com" (no www. or @)
    9		"linkedin_url"			// "http://www.linkedin.com/in/js-46545"
    10	}
    11]
    

    🛑 Apollo.io has multiple limits when it comes to credits usage, from most restrictive to least:

    1. Export credits: One export credit is used per enrichment. When no credits are left, the whole API is blocked.

    2. Email/Phone credits: One specific credit is used per email/phone enrichment.

    3. Rate limits: The number of requests sent to the API is limited based on your plan (see next section).

  • Enrich Organizations

    Enhances the provided information about organizations based on your filters. Will consume export/email/phone credits.

    Required field (STRING):

    1[
    2	{
    3		"domain"	// "abc.com" (no www. or @)
    4	}
    5]
    

• Queries (array)

  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": ["verified"],
  4		"organization_locations": ["new york"]
  5	},
  6	{
  7		"first_name": "Jane",
  8		"last_name": "Smith"
  9	}
  10]
  

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

• 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.

• Enrichment mode (People) (select)

  Choose one of:

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

  • Reveal personal email: May consume 1 additional credit per person for personal email verification.

  • Reveal phone numbers: Will consume 1 credit per person for phone verification. You must enter a webhook URL. Apollo.io might take several minutes before returning the information, it will therefore be sent to your webhook instead.

  🛑 This consumes export credits. The run will fail if your account does not have sufficient credits. Unfortunately, Apollo blocks all API calls, including search, once you consume all of your export credits.

• Limits (integer)

  The limit fields are optional and try to calculate how much time and how credits will be consumed.

  API usage is rate limited by Apollo.io. The pricier your plan the more requests you can send.

  Adjust the field values based on your plan and current account usage.

  💡 For example, the free plan only allows up to 50/200/600 requests per minute/hour/day. They also limit the results, such as a maximum of 5,000 people per search request, and the number of enrichment up to your number (80) of export credits.

• 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	"contact_email_status": ["verified"],
3	"organization_locations": ["seoul", "tokyo"],
4	"organization_num_employees_ranges": ["100-5000"],
5    "person_seniorities": ["vp"]
6}

-- OUTPUT --

1[
2	{
3		"id": "55705bf473696414623b3000",
4		"first_name": "redacted",
5		"last_name": "redacted",
6		"name": "redacted",
7		"linkedin_url": "http://www.linkedin.com/in/redacted",
8		"title": "Executive Vice President",
9		"email_status": "verified",
10		"photo_url": "https://static.licdn.com/aero-v1/sc/h/9c8pery4andzj6ohjkjp54ma2",
11		"twitter_url": null,
12		"github_url": null,
13		"facebook_url": null,
14		"extrapolated_email_confidence": null,
15		"headline": "Group Executive Vice President - Rakuten",
16		"email": "redacted@rakuten.com",
17		"organization_id": "674b608dc0db080001403b8c",
18		"state": null,
19		"city": null,
20		"country": "Japan",
21		"organization": {
22			"id": "674b608dc0db080001403b8c",
23			"name": "Rakuten Group",
24			"linkedin_url": "http://www.linkedin.com/company/rakuten-group",
25			"linkedin_uid": "8999956",
26			"logo_url": "https://zenprospect-production.s3.amazonaws.com/uploads/pictures/63edac0a998f12000100b12d/picture",
27			"industry": "retail",
28			"keywords": [],
29			"estimated_num_employees": 57,
30			"industries": [
31				"retail"
32			],
33			"secondary_industries": [],
34			"snippets_loaded": true,
35			"industry_tag_id": "5567ced173696450cb580000",
36			"industry_tag_hash": {
37				"retail": "5567ced173696450cb580000"
38			},
39			"retail_location_count": 0,
40			"raw_address": "Tokyo",
41			"street_address": "",
42			"city": "Tokyo",
43			"state": "Tokyo",
44			"postal_code": "90012",
45			"country": "Japan",
46			"owned_by_organization_id": null,
47			"seo_description": "",
48			"short_description": "Rakuten Group is a computer and network security company.",
49			"suborganizations": [],
50			"num_suborganizations": 0,
51			"total_funding": null,
52			"total_funding_printed": null,
53			"latest_funding_round_date": null,
54			"latest_funding_stage": null,
55			"funding_events": [],
56			"technology_names": [],
57			"current_technologies": [],
58			"org_chart_root_people_ids": [
59				"5abab61ea6da98413d1d1143"
60			],
61			"org_chart_sector": null,
62			"org_chart_removed": null,
63			"org_chart_show_department_filter": null
64		},
65		"departments": [],
66		"subdepartments": [],
67		"seniority": "vp",
68		"functions": [],
69		"intent_strength": null,
70		"show_intent": false,
71		"email_domain_catchall": true,
72		"revealed_for_current_team": true,
73		"employment_history": [
74			{
75				"_id": "6790bc059f0189000120784b",
76				"created_at": null,
77				"current": true,
78				"degree": null,
79				"description": null,
80				"emails": null,
81				"end_date": null,
82				"grade_level": null,
83				"kind": null,
84				"major": null,
85				"organization_id": "674b608dc0db080001403b8c",
86				"organization_name": "Rakuten Group",
87				"raw_address": null,
88				"start_date": "2005-04-01",
89				"title": "Executive Vice President",
90				"updated_at": null,
91				"id": "6790bc059f0189000120784b",
92				"key": "6790bc059f0189000120784b"
93			},
94			{
95				"_id": "6790bc059f0189000120784c",
96				"created_at": null,
97				"current": true,
98				"degree": null,
99				"description": null,
100				"emails": null,
101				"end_date": null,
102				"grade_level": null,
103				"kind": null,
104				"major": null,
105				"organization_id": "5f3b8319f1ee38008c2089fa",
106				"organization_name": "Rakuten",
107				"raw_address": null,
108				"start_date": "2005-04-01",
109				"title": "Group Executive Vice Presidnet",
110				"updated_at": null,
111				"id": "6790bc059f0189000120784c",
112				"key": "6790bc059f0189000120784c"
113			},
114			{
115				"_id": "6790bc059f0189000120784e",
116				"created_at": null,
117				"current": false,
118				"degree": null,
119				"description": null,
120				"emails": null,
121				"end_date": "2000-01-01",
122				"grade_level": null,
123				"kind": null,
124				"major": null,
125				"organization_id": "5d09f6c1f65125d2e8d80a10",
126				"organization_name": "Nomura Securities",
127				"raw_address": null,
128				"start_date": "1988-01-01",
129				"title": "Section Chief",
130				"updated_at": null,
131				"id": "6790bc059f0189000120784e",
132				"key": "6790bc059f0189000120784e"
133			}
134		],
135		"personal_emails": []
136	},
137	...
138]

"Find Organizations" with Search Mode = "jobs"

-- INPUT --

1{
2	"organization_num_employees_ranges": ["1000-5000"],
3	"organization_locations": ["new york"],
4	"q_organization_keyword_tags": ["fintech"]
5}

-- OUTPUT --

1[
2	{
3		"id": "5d0a12adf651252f023bbf30",
4		"name": "NYU Stern School of Business",
5		"linkedin_url": "http://www.linkedin.com/school/nyu-stern-school-of-business",
6		"primary_phone": {
7			"number": "+1 212-998-6100",
8			"source": "Scraped",
9			"sanitized_number": "+12129986100"
10		},
11		"phone": "+1 212-998-6100",
12		"linkedin_uid": "3157",
13		"founded_year": 1900,
14		"logo_url": "https://zenprospect-production.s3.amazonaws.com/uploads/pictures/6788d25366866c0001860327/picture",
15		"sanitized_phone": "+12129986100",
16		"industry": "higher education",
17		"keywords": [
18			"accounting",
19			"business & society",
20			"economics",
21			"entertainment",
22			...
23		],
24		"estimated_num_employees": 2600,
25		"industries": [
26			"higher education"
27		],
28		"secondary_industries": [],
29		"snippets_loaded": true,
30		"industry_tag_id": "5567cd4c73696453e1300000",
31		"industry_tag_hash": {
32			"higher education": "5567cd4c73696453e1300000"
33		},
34		"retail_location_count": 0,
35		"raw_address": "44 west 4th street, new york, ny 10012, us",
36		"street_address": "44 West 4th Street",
37		"city": "New York",
38		"state": "New York",
39		"country": "United States",
40		"postal_code": "10012",
41		"intent_strength": null,
42		"show_intent": false,
43		"has_intent_signal_account": false,
44		"intent_signal_account": null,
45		"job_postings": [
46			{
47				"id": "6760605048d865000193c532",
48				"title": "Associate Director, Diversity and Inclusion",
49				"url": "https://www.linkedin.com/jobs/view/associate-director-diversity-and-inclusion-at-nyu-stern-school-of-business-4101180945?position=1&pageNum=97&refId=cFLCAfkYdmTalZ5mBTZ1sA%3D%3D&trackingId=%2BlM%2F271CfN64Y9%2FcD7s6tg%3D%3D",
50				"city": "New York",
51				"state": "New York",
52				"country": "United States",
53				"last_seen_at": "2024-12-16T17:16:00.733+00:00",
54				"posted_at": "2024-12-16T17:08:00.733+00:00"
55			},
56			...
57		]
58	},
59	...
60]

"Find Organizations" with Search Mode = "enrich"

-- Input--

1{
2	"organization_num_employees_ranges": ["1000-5000"],
3	"organization_locations": ["new york"],
4	"q_organization_keyword_tags": ["fintech"]
5}

-- Output --

1[
2	{
3		"id": "5cb7768dcfb03c2b82e54798",
4		"name": "NYC Fintech Women",
5		"website_url": "http://www.nycfintechwomen.com",
6		"linkedin_url": "http://www.linkedin.com/company/nyc-fintech-women",
7		"facebook_url": "https://www.facebook.com/nycfintechwomen/",
8		"linkedin_uid": "34317028",
9		"founded_year": 2017,
10		"logo_url": "https://zenprospect-production.s3.amazonaws.com/uploads/pictures/678418ba80406e0001c8b410/picture",
11		"primary_domain": "nycfintechwomen.com",
12		"industry": "financial services",
13		"keywords": [
14			"women in fintech",
15			"women in tech",
16			"community organization",
17			...
18		],
19		"estimated_num_employees": 24,
20		"industries": [
21			"financial services"
22		],
23		"secondary_industries": [],
24		"snippets_loaded": true,
25		"industry_tag_id": "5567cdd67369643e64020000",
26		"industry_tag_hash": {
27			"financial services": "5567cdd67369643e64020000"
28		},
29		"retail_location_count": 0,
30		"raw_address": "new york, new york, united states",
31		"street_address": "",
32		"city": "New York",
33		"state": "New York",
34		"country": "United States",
35		"postal_code": null,
36		"intent_strength": null,
37		"show_intent": false,
38		"has_intent_signal_account": false,
39		"intent_signal_account": null,
40		"owned_by_organization_id": null,
41		"seo_description": "Empowering Women in the FinTech Community. Women's FinTech Network",
42		"short_description": null,
43		"suborganizations": [],
44		"num_suborganizations": 0,
45		"total_funding": null,
46		"total_funding_printed": null,
47		"latest_funding_round_date": null,
48		"latest_funding_stage": null,
49		"funding_events": [],
50		"technology_names": [
51			"Adobe Media Optimizer",
52			"Adyen",
53			"Cedexis Radar",
54			"Gmail",
55			...
56		],
57		"current_technologies": [
58			{
59				"uid": "adobe_media_optimizer",
60				"name": "Adobe Media Optimizer",
61				"category": "Search Marketing"
62			},
63			{
64				"uid": "adyen",
65				"name": "Adyen",
66				"category": "Payments"
67			},
68			{
69				"uid": "cedexis_radar",
70				"name": "Cedexis Radar",
71				"category": "Web Performance Monitoring"
72			},
73			{
74				"uid": "gmail",
75				"name": "Gmail",
76				"category": "Email Providers"
77			},
78			...
79		],
80		"org_chart_root_people_ids": [],
81		"org_chart_sector": "OrgChart::SectorHierarchy::Rules::Finance",
82		"org_chart_removed": null,
83		"org_chart_show_department_filter": null,
84		"departmental_head_count": {
85			"marketing": 1,
86			"entrepreneurship": 2,
87			"accounting": 0,
88			...
89		}
90	},
91	...
92]

Support

🛑 API Usage is 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!