OpenParable
Skip to content
← Back to skills

Apollo

Apps & Automation
apollo

Apollo is an Agent Skill for apps & automation published in the BuilderIO/agent-native repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Enrich contacts and companies via Apollo.io for prospecting and sales intelligence. Use this skill when the user asks about contact details, company research, or finding decision-makers.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/BuilderIO/agent-native/blob/HEAD/templates/analytics/.builder/skills/apollo/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/apollo, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Apollo.io Integration (Contact & Company Enrichment)

Connection

  • Base URL: https://api.apollo.io
  • Auth: x-api-key: $APOLLO_API_KEY
  • Env vars: APOLLO_API_KEY
  • Caching: 10-minute in-memory cache, max 120 entries

Server Lib & API Routes

  • File: server/lib/apollo.ts

Exported Functions

FunctionDescription
searchPeople(params)Search people by criteria
enrichPerson(email)Enrich a contact by email (returns null on failure)
searchOrganizations(query, params?)Search companies
enrichOrganization(domain)Enrich company by domain (returns null on failure)

API Routes

RouteDescription
GET /api/apollo/searchSearch contacts/companies

Script Usage

# Search by email
pnpm action apollo-search [email protected]

# Search by company
pnpm action apollo-search --company=Example Inc

# Search by domain
pnpm action apollo-search --domain=example.com

# Find decision-makers
pnpm action apollo-search --company=Example Inc --title=CTO

# Search by name
pnpm action apollo-search --name="John Smith"

Key Patterns & Gotchas

  • enrichPerson and enrichOrganization swallow errors and return null on failure (try/catch)
  • API uses POST for all searches and enrichment — POST responses are cached for 10 minutes
  • API endpoints: /v1/mixed_people/search, /v1/people/match, /v1/mixed_companies/search, /v1/organizations/enrich
  • Pagination info available via response.pagination?.total_entries