Requests are metered two ways - how fast you call, and how many credits you spend. Both are visible in your responses.
Requests are rate-limited per token, about 1 request per second. Sending faster returns 429 with rate limit exceeded.
Every search and segmentation request costs 1 credit from your monthly quota:
requestsLeft in every response shows your remaining balance (also in the X-WebHose-Requests-Left header).429 with Too many requests: used X out of Y allowed in a month.| Status | When |
|---|---|
400 | Unknown sort or order value, or an invalid segmentation field |
401 | Missing or unknown token |
429 | Rate limit exceeded, monthly quota used up, account not activated, or trial ended |
500 | Internal error, including unbalanced quotes or parentheses in q |
Need more credits? Contact [email protected].