Some API endpoints consume Apollo credits. Credit consumption varies by Apollo plan. Check out the following sections to understand credits with Apollo API.
Credit usage on API depends on the endpoint you call and whether Apollo finds credit-consuming data.
In general:
- Endpoints that create, update, list, or manage records don't consume credits.
- Enrichment, organization search, news search, and AI-insight endpoints may consume credits when qualifying data is returned.
- Credit usage is conditional; if Apollo doesn't find credit-consuming data, the request consumes 0 credits.
📖Some credit-consuming endpoints may use credits across multiple requests. If you paginate through results or run repeated searches, your total credit usage can increase. Before running a large workflow, test with a small request and verify credit usage in Apollo.
Check out the following table to understand whether an endpoint consumes credits and under what conditions. For your organization's exact credit consumption, review your Apollo plan and credit usage.
| Endpoint | Uses credits |
|---|
| People enrichment | Yes, charged per enriched record when Apollo finds credit-consuming data. Usage depends on whether you enrich emails, phone numbers, or both, and whether you use waterfall enrichment. |
| Bulk people enrichment | Yes, charged per enriched record when Apollo finds credit-consuming data for matched people. Usage depends on whether you enrich emails, phone numbers, or both, and whether you use waterfall enrichment. |
| Organization enrichment | Yes, charged per enriched record when Apollo finds credit-consuming data for a matched organization. |
| Bulk organization enrichment | Yes, charged per enriched record when Apollo finds credit-consuming data for matched organizations. |
| Organization search | Yes, charged per page when results are returned. |
| Organization job postings | Yes, charged per page when results are returned. |
| Get complete organization info | Yes, charged per record when an organization is found. |
| News articles search | Yes, charged per page when results are returned. |
| Get conversations info | Yes, charged per record when a conversation has AI insights. |
| Export conversations | Yes, charged per record exported with AI insights. |
| Get complete person info | Yes, charged per record when results are returned. |
| People API search | ✗ |
| Create an account | ✗ |
| Update an account | ✗ |
| Bulk create accounts | ✗ |
| Bulk update accounts | ✗ |
| Search for accounts | ✗ |
| View an account | ✗ |
| Update account owner for multiple accounts | ✗ |
| List account stages | ✗ |
| Create a contact | ✗ |
| Update a contact | ✗ |
| Bulk create contacts | ✗ |
| Bulk update contacts | ✗ |
| Search for contacts | ✗ |
| View a contact | ✗ |
| Update contact stage for multiple contacts | ✗ |
| Update contact owner for multiple contacts | ✗ |
| List contact stages | ✗ |
| View associated deals | ✗ |
| Search conversations | ✗ |
| Get conversations export | ✗ |
| Create deal | ✗ |
| List all deals | ✗ |
| View deal | ✗ |
| Update deal | ✗ |
| List deal stages | ✗ |
| Create a sequence | ✗ |
| Update a sequence | ✗ |
| Search for sequences | ✗ |
| Add contacts to a sequence | ✗ |
| Update contact status in a sequence | ✗ |
| Activate a sequence | ✗ |
| Deactivate a sequence | ✗ |
| Archive a sequence | ✗ |
| Search for outreach emails | ✗ |
| Check email stats | ✗ |
| Create a task | ✗ |
| Bulk create tasks | ✗ |
| Search for tasks | ✗ |
| Query analytics report | ✗ |
| Create call records | ✗ |
| Search for calls | ✗ |
| Update call records | ✗ |
| Poll webhook result | ✗ |
| View API usage stats and rate limits | ✗ |
| Get a list of users | ✗ |
| Get authenticated user profile | ✗ |
| Get a list of email accounts | ✗ |
| Get a list of all lists | ✗ |
| Get a list of all custom fields | ✗ |
| Get a list of fields | ✗ |
| Create a custom field | ✗ |
| Get a list of notes | ✗ |
Use the following approach before running a large API job:
- Identify whether the endpoint consumes credits with this table.
- Check the charging unit, such as per matched record or per page.
- Run a small test request of your workflow.
- Review your credit usage in Apollo.
- Scale the workflow after you understand the credit impact.
You can review API usage and rate limits any time in Apollo.
To view your credit usage, go to Settings > Billing and credits > Credit usage. You can check usage by team or individual.
Apollo applies rate limits to API calls to protect platform performance and reliability. Rate limits vary by endpoint and your Apollo plan.
To view your rate limits, go to Settings > Integrations > API Usage. Alternatively, use the view usage endpoint to programmatically call usage data.
If you exceed a rate limit, Apollo returns a 429 Too Many Requests response. Reduce request volume, wait for the limit window to reset, or upgrade your plan if your workflow requires higher limits.
