--- name: apollo description: Interact with Apollo.io REST API (people/org enrichment, search, lists). metadata: {"clawdbot":{"emoji":"🛰️","os":["darwin","linux"]}} ---

Apollo.io

Interact with Apollo.io via REST API.

Config

Create config/apollo.env (example at config/apollo.env.example):

• APOLLO_BASE_URL (usually https://api.apollo.io)
• APOLLO_API_KEY

Scripts load this automatically.

Commands

Low-level helpers

• GET: skills/apollo/scripts/apollo-get.sh "/api/v1/users" (endpoint availability may vary)
• People search (new): skills/apollo/scripts/apollo-people-search.sh "vp marketing" 1 5
• POST (generic): skills/apollo/scripts/apollo-post.sh "/api/v1/mixed_people/api_search" '{"q_keywords":"vp marketing","page":1,"per_page":5}'

Enrichment (common)

• Enrich website/org by domain: skills/apollo/scripts/apollo-enrich-website.sh "apollo.io"
• Get complete org info (bulk): skills/apollo/scripts/apollo-orgs-bulk.sh "6136480939c707388501e6b9"

Notes

• Apollo authenticates via X-Api-Key header (these scripts send it automatically).
• Some endpoints require a master API key and a paid plan (Apollo returns 403 in that case).
• Rate limiting is common (e.g. 600/hour on many endpoints); handle 429 responses.