Apollo.ioPeople DataEnrichment

Enrich a person by email, LinkedIn URL or name + company

apollo.people.enrich

Enrich a person from an email, LinkedIn URL or name + company — title, contact details

Price: $0.026/successAt provider cost
Success rate: 100%Last 30 days · 288,089 calls
Latency p50: 321 msp95 683 ms
Last verified: —Not verified yet

POSThttps://toolswitch.dev/v1/tools/apollo.people.enrich?email=patrick%40stripe.comPreview

Uses platform quota
Synchronous response
Reads public data

Parameters

POST, but every parameter rides in the QUERY STRING — there is no JSON body. Supply the strongest identifier you have: email > linkedin_url > name + domain. A request with none of them cannot match

Parameter	Type	Required	Description	Example
Query parameters
`id`	string	Optional	Apollo person id from a previous search
`name`	string	Optional	full name; use instead of first_name + last_name
`email`	string	Optional	work or personal email of the person	`tim@apple.com`
`domain`	string	Optional	employer's domain, with no www and no @	`apple.com`
`last_name`	string	Optional		`Cook`
`first_name`	string	Optional		`Tim`
`webhook_url`	string	Optional	OWN KEY ONLY: refused on treg's shared key. REQUIRED when reveal_phone_number is true
`hashed_email`	string	Optional	MD5 or SHA-256 hash of the email, when you cannot send it in the clear
`linkedin_url`	string	Optional		`http://www.linkedin.com/in/tim-cook`
`organization_name`	string	Optional	the person's employer, to disambiguate common names	`Apple`
`reveal_phone_number`	boolean	Optional	OWN KEY ONLY: refused on treg's shared key. Adds 8 CREDITS when a mobile is found. The number is returned ASYNCHRONOUSLY to webhook_url, not inline, so webhook_url becomes required; default false	`false`
`run_waterfall_email`	boolean	Optional	OWN KEY ONLY: refused on treg's shared key. Fall through to third-party vendors when Apollo's own data misses; some vendors bill even on a miss; default false
`run_waterfall_phone`	boolean	Optional	OWN KEY ONLY: refused on treg's shared key. As run_waterfall_email, for phone numbers; default false
`reveal_personal_emails`	boolean	Optional	unlocks personal emails; default false	`false`

Query parameters
idstringOptional
Apollo person id from a previous search
namestringOptional
full name; use instead of first_name + last_name
emailstringOptional
work or personal email of the person
Example: tim@apple.com
domainstringOptional
employer's domain, with no www and no @
Example: apple.com
last_namestringOptional
Example: Cook
first_namestringOptional
Example: Tim
webhook_urlstringOptional
OWN KEY ONLY: refused on treg's shared key. REQUIRED when reveal_phone_number is true
hashed_emailstringOptional
MD5 or SHA-256 hash of the email, when you cannot send it in the clear
linkedin_urlstringOptional
Example: http://www.linkedin.com/in/tim-cook
organization_namestringOptional
the person's employer, to disambiguate common names
Example: Apple
reveal_phone_numberbooleanOptional
OWN KEY ONLY: refused on treg's shared key. Adds 8 CREDITS when a mobile is found. The number is returned ASYNCHRONOUSLY to webhook_url, not inline, so webhook_url becomes required; default false
Example: false
run_waterfall_emailbooleanOptional
OWN KEY ONLY: refused on treg's shared key. Fall through to third-party vendors when Apollo's own data misses; some vendors bill even on a miss; default false
run_waterfall_phonebooleanOptional
OWN KEY ONLY: refused on treg's shared key. As run_waterfall_email, for phone numbers; default false
reveal_personal_emailsbooleanOptional
unlocks personal emails; default false
Example: false

Code samples

Replace $TOOLSWITCH_KEY with the key you created in the console.

Preview

curl -X POST 'https://toolswitch.dev/v1/tools/apollo.people.enrich?email=patrick%40stripe.com' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

import os
import requests

response = requests.request(
    "POST",
    "https://toolswitch.dev/v1/tools/apollo.people.enrich?email=patrick%40stripe.com",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/apollo.people.enrich?email=patrick%40stripe.com", {
  method: "POST",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
  },
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

This gateway API is in preview; its URL and authentication may change. The example parameters are sample data. Calls are billed at $0.026/success, including the service fee.