Help us improve
Share bugs, ideas, or general feedback.
From apollo-pack
Generates TypeScript/axios examples for Apollo.io API: people search (free), person enrichment, organization enrichment. For starting integrations, testing setup, or learning basics.
npx claudepluginhub jeremylongshore/claude-code-plugins-plus-skills --plugin apollo-packHow this skill is triggered — by the user, by Claude, or both
Slash command
/apollo-pack:apollo-hello-worldThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Minimal working example demonstrating the three core Apollo.io API operations: people search, person enrichment, and organization enrichment. Uses the correct `x-api-key` header and `api.apollo.io/api/v1/` base URL.
Implements Apollo.io workflows for free people/org searches by domains, titles, seniorities, locations and paid enrichment. Includes TypeScript/Node.js code examples using correct API endpoints.
Automates Apollo.io lead generation: search organizations, discover contacts, enrich prospect data, manage stages, and build outreach lists via natural language through Composio MCP.
Creates p5.js generative art with seeded randomness, noise fields, and interactive parameter exploration. Use for algorithmic art, flow fields, or particle systems.
Share bugs, ideas, or general feedback.
Minimal working example demonstrating the three core Apollo.io API operations: people search, person enrichment, and organization enrichment. Uses the correct x-api-key header and api.apollo.io/api/v1/ base URL.
apollo-install-auth setupAPOLLO_API_KEY environment variableThe People API Search endpoint finds contacts in Apollo's 275M+ database. This endpoint is free — it does not consume enrichment credits, but it also does not return emails or phone numbers.
// hello-apollo.ts
import axios from 'axios';
const client = axios.create({
baseURL: 'https://api.apollo.io/api/v1',
headers: {
'Content-Type': 'application/json',
'x-api-key': process.env.APOLLO_API_KEY!,
},
});
// People Search — POST /mixed_people/api_search
async function searchPeople() {
const { data } = await client.post('/mixed_people/api_search', {
q_organization_domains_list: ['apollo.io'],
person_titles: ['engineer'],
person_seniorities: ['senior', 'manager'],
page: 1,
per_page: 10,
});
console.log(`Found ${data.pagination.total_entries} contacts`);
data.people.forEach((person: any) => {
console.log(` ${person.name} — ${person.title} at ${person.organization?.name}`);
});
return data;
}
searchPeople().catch(console.error);
The People Enrichment endpoint returns full contact details including email and phone.
// Enrich by email, LinkedIn URL, or name+domain combo
async function enrichPerson() {
const { data } = await client.post('/people/match', {
email: 'tim@apollo.io',
// Alternative identifiers:
// linkedin_url: 'https://www.linkedin.com/in/...',
// first_name: 'Tim', last_name: 'Zheng', organization_domain: 'apollo.io',
reveal_personal_emails: false,
reveal_phone_number: false,
});
if (!data.person) {
console.log('No match found');
return;
}
const p = data.person;
console.log(`Name: ${p.name}`);
console.log(`Title: ${p.title}`);
console.log(`Email: ${p.email}`);
console.log(`Company: ${p.organization?.name}`);
console.log(`LinkedIn: ${p.linkedin_url}`);
}
// Organization Enrichment — GET /organizations/enrich
async function enrichOrg() {
const { data } = await client.get('/organizations/enrich', {
params: { domain: 'apollo.io' },
});
const org = data.organization;
if (!org) { console.log('No org found'); return; }
console.log(`Company: ${org.name}`);
console.log(`Industry: ${org.industry}`);
console.log(`Employees: ${org.estimated_num_employees}`);
console.log(`Revenue: ${org.annual_revenue_printed}`);
console.log(`HQ: ${org.city}, ${org.state}, ${org.country}`);
console.log(`Tech Stack: ${org.current_technologies?.slice(0, 5).map((t: any) => t.name).join(', ')}`);
}
import os, requests
API_KEY = os.environ['APOLLO_API_KEY']
BASE = 'https://api.apollo.io/api/v1'
HEADERS = {'Content-Type': 'application/json', 'x-api-key': API_KEY}
# People search (free)
resp = requests.post(f'{BASE}/mixed_people/api_search', headers=HEADERS, json={
'q_organization_domains_list': ['apollo.io'],
'person_titles': ['engineer'],
'page': 1, 'per_page': 5,
})
for p in resp.json().get('people', []):
print(f" {p['name']} — {p.get('title', 'N/A')}")
# Org enrichment (1 credit)
resp = requests.get(f'{BASE}/organizations/enrich',
headers=HEADERS, params={'domain': 'apollo.io'})
org = resp.json().get('organization', {})
print(f"Company: {org.get('name')} ({org.get('estimated_num_employees')} employees)")
| Error | Cause | Solution |
|---|---|---|
| 401 Unauthorized | Missing or invalid x-api-key header | Check APOLLO_API_KEY env var |
| 422 Unprocessable | Malformed request body | Verify JSON payload structure |
| 429 Rate Limited | Exceeded requests/minute | Wait and retry with exponential backoff |
Empty people array | No matches for filters | Broaden titles/seniority or use different domain |
Proceed to apollo-local-dev-loop for development workflow setup.