Why Am I Getting a "Not Enough Credits" Error?
Why the 403 Not Enough Credits error occurs and how to fix it by adjusting page_size.
A 403 Not Enough Credits error means the request you're sending is trying to use more credits than you currently have in your account.
The most common cause: page_size
If you don't explicitly set a page_size, the API defaults to 100 results per request. Depending on the endpoint, each result may cost multiple credits.
For example:
- Endpoint costs 3 credits per result
- Default
page_sizeis 100 - Request attempts to use 300 credits (3 × 100)
If your balance is under 300 credits, this triggers the error.
How to fix it
Lower your page_size to fit within your available credit balance:
{
"page_size": 40
}For example, with 120 credits on a 3-credits-per-result endpoint, set page_size to 40 or lower.
Quick reference
| Issue | Likely cause | Fix |
|---|---|---|
403 Not Enough Credits | Request exceeds current credit balance | Lower your page_size |
If you're unsure whether the issue is related to your plan, API key access, or something else, reach out to [email protected] or use the in-app messenger.