Usage and limits
Know what counts toward your plan before you scale.
What is metered
Each successful request to these routes counts one unit against your account's credits, whichever key sends it. Failed requests count nothing.
- search_standard
- One standard search: one page of POST /v1/search.
- search_deep
- Deep search is off on every plan right now, so
"depth": "deep"is refused (400 request.out_of_plan). - feed_page
- One page of a feed: GET /v1/content or a company's events.
- screener_search
- One screen: one page of POST /v1/screener, 10 credits on every plan.
- search_research
- One research answer, on plans that include research.
Everything else is free: record reads and Search fields.
Limits
Your plan sets each limit, and each has its own error code.
| Limit | What it counts | Refused with |
|---|---|---|
| Rate limit | Requests per minute, on every route. | 429 rate_limit.exceeded, with Retry-After |
| Quota | The usage your plan includes each billing period, which starts on your signup date. | 429 quota.exceeded |
| Spend cap | The most the account may spend in a billing period, when one is set. | 429 spend_cap.exceeded, with details.resets_at |
| Page cap and history | The largest page and the earliest date your plan reads. | 400 request.out_of_plan |