Agent skill · software engineering · jeremylongshore
apollo-sdk-patterns
Apply production-ready Apollo.io SDK patterns.
Why this skill is useful
Adds production-ready TypeScript patterns for Apollo.io API integration, including type safety, error handling, and retry logic that are not publicly documented.
What it needs
Requires axios, typescript installed locally. Requires apollo account access. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Apollo SDK Patterns Overview Production-ready patterns for Apollo.io API integration. Apollo has no official SDK — these patterns wrap the REST API (https://api.apollo.io/api/v1/) with type safety, retry logic, pagination, and bulk operations. All requests use the x-api-key header. Prerequisites Completed apollo-install-auth setup TypeScript 5+ with strict mode Instructions Step 1: Type-Safe Client with Zod Validation Step 2: Custom Error Classes Step 3: Retry with Exponential Backoff Step 4: Async Pagination Iterator Apollo endpoints return pagination.totalentries and accept page/perpage. The People Search API limits to 500 pages (50,000 records). Step 5: Bulk Enrichment with Rate Awareness Apollo's Bulk People Enrichment endpoint handles up to 10 records per call. Output src/apollo/client.ts — Zod-validated singleton with x-api-key header src/apollo/errors.ts — ApolloApiError + ApolloRateLimitError with retryable flag src/apollo/retry.ts — Exponential backoff with jitter src/apollo/paginator.ts — Async generator for paginated endpoints (500-page limit) src/apollo/bulk-enrich.ts — Batch enrichment via /people/bulkmatch (10 per call) Error Handling Pattern When to Use --------- ------------- Singleton client Always — one client instance per process Retry 429 rate limits, 5xx server errors Pagination Search results > 100 records Bulk enrichment Multiple contacts need email/phone data Custom errors Typed catch blocks distinguishing auth vs rate limit vs server Examples Full Pipeline: Search, Paginate, Enrich Resources Apollo API Overview Bulk People Enrichment Zod Schema Validation Next Steps Proceed to apollo-core-workflow-a for lead search implementation.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/apollo-sdk-patterns--de88f7