Documentation Index Fetch the complete documentation index at: https://lava.so/docs/llms.txt
Use this file to discover all available pages before exploring further.
Sales intelligence platform providing person enrichment, company lookup, people search, org charts, and job posting data for B2B prospecting. Best for sales automation workflows — finding decision makers, enriching lead lists, and identifying hiring signals. Unlike People Data Labs (raw data enrichment), Apollo is oriented toward sales prospecting with contact discovery and intent signals.
9 endpoints available through Lava’s AI Gateway. See the Apollo.io API docs for full documentation.
Supports both managed (Lava’s API keys) and unmanaged (bring your own credentials) mode.
Endpoints
Enrich a person by name, email, LinkedIn, or domain
POST https://api.apollo.io/api/v1/people/match — $0.025 / request
const data = await lava . gateway ( 'https://api.apollo.io/api/v1/people/match' , {
body: {
"first_name" : "Tim" ,
"last_name" : "Cook" ,
"organization_name" : "Apple" ,
"domain" : "apple.com" ,
"email" : "tim@apple.com" ,
"linkedin_url" : "https://linkedin.com/in/timcook" ,
"reveal_personal_emails" : false ,
"reveal_phone_number" : false
},
});
curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.apollo.io%2Fapi%2Fv1%2Fpeople%2Fmatch" \
-H "Authorization: Bearer $LAVA_SECRET_KEY " \
-H "Content-Type: application/json" \
-d '{"first_name":"Tim","last_name":"Cook","organization_name":"Apple","domain":"apple.com","email":"tim@apple.com","linkedin_url":"https://linkedin.com/in/timcook","reveal_personal_emails":false,"reveal_phone_number":false}'
Bulk enrich people (up to 10 per request)
POST https://api.apollo.io/api/v1/people/bulk_match — $0.025 / request
const data = await lava . gateway ( 'https://api.apollo.io/api/v1/people/bulk_match' , {
body: {
"details" : [
{
"first_name" : "Tim" ,
"last_name" : "Cook" ,
"organization_name" : "Apple"
}
]
},
});
curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.apollo.io%2Fapi%2Fv1%2Fpeople%2Fbulk_match" \
-H "Authorization: Bearer $LAVA_SECRET_KEY " \
-H "Content-Type: application/json" \
-d '{"details":[{"first_name":"Tim","last_name":"Cook","organization_name":"Apple"}]}'
Enrich an organization by domain
POST https://api.apollo.io/api/v1/organizations/enrich — $0.025 / request
const data = await lava . gateway ( 'https://api.apollo.io/api/v1/organizations/enrich' , { body: { "domain" : "apple.com" } });
curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.apollo.io%2Fapi%2Fv1%2Forganizations%2Fenrich" \
-H "Authorization: Bearer $LAVA_SECRET_KEY " \
-H "Content-Type: application/json" \
-d '{"domain":"apple.com"}'
Bulk enrich organizations by domain
POST https://api.apollo.io/api/v1/organizations/bulk_enrich — $0.025 / request
const data = await lava . gateway ( 'https://api.apollo.io/api/v1/organizations/bulk_enrich' , { body: { "domains" : [ "apple.com" ]} });
curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.apollo.io%2Fapi%2Fv1%2Forganizations%2Fbulk_enrich" \
-H "Authorization: Bearer $LAVA_SECRET_KEY " \
-H "Content-Type: application/json" \
-d '{"domains":["apple.com"]}'
Search people by title, location, company size
POST https://api.apollo.io/api/v1/mixed_people/api_search — Free
const data = await lava . gateway ( 'https://api.apollo.io/api/v1/mixed_people/api_search' , {
body: {
"person_titles" : [
"ceo"
],
"person_locations" : [
"united states"
],
"organization_industry_tag_ids" : [],
"organization_num_employees_ranges" : [
"1,100"
],
"per_page" : 10 ,
"page" : 1
},
});
curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.apollo.io%2Fapi%2Fv1%2Fmixed_people%2Fapi_search" \
-H "Authorization: Bearer $LAVA_SECRET_KEY " \
-H "Content-Type: application/json" \
-d '{"person_titles":["ceo"],"person_locations":["united states"],"organization_industry_tag_ids":[],"organization_num_employees_ranges":["1,100"],"per_page":10,"page":1}'
Search companies by location, size, industry
POST https://api.apollo.io/api/v1/mixed_companies/search — Free
const data = await lava . gateway ( 'https://api.apollo.io/api/v1/mixed_companies/search' , {
body: {
"organization_locations" : [
"united states"
],
"organization_num_employees_ranges" : [
"1,100" ,
"101,500"
],
"organization_industry_tag_ids" : [],
"q_organization_keyword_tags" : [],
"per_page" : 10 ,
"page" : 1
},
});
curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.apollo.io%2Fapi%2Fv1%2Fmixed_companies%2Fsearch" \
-H "Authorization: Bearer $LAVA_SECRET_KEY " \
-H "Content-Type: application/json" \
-d '{"organization_locations":["united states"],"organization_num_employees_ranges":["1,100","101,500"],"organization_industry_tag_ids":[],"q_organization_keyword_tags":[],"per_page":10,"page":1}'
Search organizations by industry and size
POST https://api.apollo.io/api/v1/organizations/search — Free
const data = await lava . gateway ( 'https://api.apollo.io/api/v1/organizations/search' , {
body: {
"organization_industry_tag_ids" : [],
"organization_num_employees_ranges" : [
"1,100"
],
"per_page" : 10 ,
"page" : 1
},
});
curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.apollo.io%2Fapi%2Fv1%2Forganizations%2Fsearch" \
-H "Authorization: Bearer $LAVA_SECRET_KEY " \
-H "Content-Type: application/json" \
-d '{"organization_industry_tag_ids":[],"organization_num_employees_ranges":["1,100"],"per_page":10,"page":1}'
Get organization details by Apollo ID (24-hex, obtained from organizations/enrich or search responses)
GET https://api.apollo.io/api/v1/organizations/5fcd2cf3ed78c700f9383e4e — $0.025 / request
const data = await lava . gateway ( 'https://api.apollo.io/api/v1/organizations/5fcd2cf3ed78c700f9383e4e' , { method: 'GET' });
curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.apollo.io%2Fapi%2Fv1%2Forganizations%2F5fcd2cf3ed78c700f9383e4e" \
-H "Authorization: Bearer $LAVA_SECRET_KEY "
Get job postings for an organization by Apollo ID (24-hex, obtained from organizations/enrich or search responses)
GET https://api.apollo.io/api/v1/organizations/5fcd2cf3ed78c700f9383e4e/job_postings — Free
const data = await lava . gateway ( 'https://api.apollo.io/api/v1/organizations/5fcd2cf3ed78c700f9383e4e/job_postings' , { method: 'GET' });
curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.apollo.io%2Fapi%2Fv1%2Forganizations%2F5fcd2cf3ed78c700f9383e4e%2Fjob_postings" \
-H "Authorization: Bearer $LAVA_SECRET_KEY "
Next Steps
All Providers Browse all supported AI providers
Forward Proxy Learn how to construct proxy URLs and authenticate requests