Limits and caching
Fast, public, and cacheable.
The API uses GET requests so identical URLs and formats can be cached at Cloudflare’s edge.
Rate limits
- 10 successful uncached operations per anonymous IP per UTC day.
- 1,000 non-expiring welcome credits once for each new account.
- 60 uncached search or extraction requests per client per 60 seconds.
- 5 high-cost extraction requests per client per 60 seconds.
An exhausted anonymous allowance or rate limit uses HTTP 429 and may include a Retry-After header. Signed-in website tools and account keys use the account credit balance; when it is empty, the response uses 402. Errors consume neither the anonymous allowance nor account credits. Reuse identical request URLs so cached responses can be served efficiently.
Successful API responses include X-Extractor-Cache: MISS when extraction work ran and X-Extractor-Cache: HIT when the versioned edge cache served the result.
Cache lifetimes
| Result type | Edge cache lifetime |
|---|---|
| Single entities and pages | Up to 30 days |
| Products, profiles, and feeds | Up to 1 hour |
| Yahoo Finance market documents | Up to 5 minutes |
| Stock-symbol search feeds | Up to 1 hour |
| Finance API requests | Up to 5 minutes |
| Web searches | Up to 1 hour |
| News searches | Up to 1 hour |
| Image searches | Up to 1 hour |
| Place searches | Up to 1 hour |
| Errors | Not cached |
Input and output limits
- URLs may contain up to 2,048 characters.
- Only public HTTP and HTTPS URLs are accepted.
- Private networks, local addresses, direct IP targets, embedded credentials, and non-standard ports are rejected.
- Maximum extracted result size is 2 MB.
Authentication
No account is required for the 10-request daily allowance. New accounts receive 1,000 welcome credits once, used automatically in the homepage form and platform playgrounds after sign-in. External integrations add Authorization: Bearer ext_live_… to use the same balance after the cache lookup. Invalid keys return 401; an account with no credits returns 402. Never place credentials, cookies, authorization tokens, or private data in the url parameter.
Prepaid credits cost $0.49 per 1,000 and never expire. One-time pay-as-you-go top-ups are available in the dashboard.