openclaw-workspace/skills/api-gateway/references/apollo.md

Apollo Routing Reference

App name: apollo Base URL proxied: api.apollo.io

API Path Pattern

/apollo/v1/{endpoint}

Common Endpoints

People

Search People

POST /apollo/v1/mixed_people/api_search
Content-Type: application/json

{
  "q_organization_name": "Google",
  "page": 1,
  "per_page": 25
}

Get Person

GET /apollo/v1/people/{personId}

Enrich Person

POST /apollo/v1/people/match
Content-Type: application/json

{
  "email": "john@example.com"
}

Or by LinkedIn:

POST /apollo/v1/people/match
Content-Type: application/json

{
  "linkedin_url": "https://linkedin.com/in/johndoe"
}

Organizations

Search Organizations

POST /apollo/v1/organizations/search
Content-Type: application/json

{
  "q_organization_name": "Google",
  "page": 1,
  "per_page": 25
}

Enrich Organization

POST /apollo/v1/organizations/enrich
Content-Type: application/json

{
  "domain": "google.com"
}

Contacts

Search Contacts

POST /apollo/v1/contacts/search
Content-Type: application/json

{
  "page": 1,
  "per_page": 25
}

Create Contact

POST /apollo/v1/contacts
Content-Type: application/json

{
  "first_name": "John",
  "last_name": "Doe",
  "email": "john@example.com",
  "organization_name": "Acme Corp"
}

Update Contact

PUT /apollo/v1/contacts/{contactId}
Content-Type: application/json

{
  "first_name": "Jane"
}

Accounts

Search Accounts

POST /apollo/v1/accounts/search
Content-Type: application/json

{
  "page": 1,
  "per_page": 25
}

Create Account

POST /apollo/v1/accounts
Content-Type: application/json

{
  "name": "Acme Corp",
  "domain": "acme.com"
}

Sequences

Search Sequences

POST /apollo/v1/emailer_campaigns/search
Content-Type: application/json

{
  "page": 1,
  "per_page": 25
}

Add Contact to Sequence

POST /apollo/v1/emailer_campaigns/{campaignId}/add_contact_ids
Content-Type: application/json

{
  "contact_ids": ["contact_id_1", "contact_id_2"]
}

Email

Search Email Messages

POST /apollo/v1/emailer_messages/search
Content-Type: application/json

{
  "contact_id": "{contactId}"
}

Labels

List Labels

GET /apollo/v1/labels

Search Filters

Common search parameters:

• q_organization_name - Company name
• q_person_title - Job title
• person_locations - Array of locations
• organization_num_employees_ranges - Employee count ranges
• q_keywords - General keyword search

Notes

• Authentication is automatic - the router injects the API key
• Pagination uses page and per_page parameters in POST body
• Most list endpoints use POST with /search suffix (not GET)
• Email enrichment consumes credits
• Rate limits apply per endpoint
• people/search and mixed_people/search are deprecated - use mixed_people/api_search instead

Resources

• API Overview
• Search People
• Enrich Person
• Search Organizations
• Enrich Organization
• Search Contacts
• Create Contact
• Update Contact
• Search Accounts
• Create Account
• Search Sequences
• Add Contacts to Sequence
• Search Email Messages
• List Labels
• LLM Reference