News API Frequently Asked Questions
Answers about requests, keys, results and limits
Written by Kent Hudson
June 28, 2026
Updated October 16, 2026
Frequently asked questions
Send news searches to /v1/news/everything with your API key and filters. The answers below explain authentication, request costs, article previews, sorting, limits and errors, with links to detailed guides.
What is the base URL and main endpoint?
Use https://api.apitube.io as the base URL. /v1/news/everything accepts GET with query parameters or POST with a JSON body:
curl "https://api.apitube.io/v1/news/everything?language.code=en&api_key=YOUR_API_KEY"
Other routes include /v1/news/count for matching article counts and /v1/balance for available request quota.
How do I authenticate my requests?
Send X-API-Key, the api_key query parameter, or Authorization: Bearer <key>. A missing key returns 401 ER0201, an invalid or revoked key ER0202, and an expired key ER0230. See authentication errors.
What counts as one request, and when am I charged?
An article search uses one request when it returns at least one article. Empty searches are free. Other endpoints have their own charges: counting matches, for example, uses one request even for a zero count.
See how to check your balance for remaining quota.
Why is article content shortened or showing placeholder text?
Free plans and test keys return previews of body and body_html. Their markers are [Upgrade subscription plan] and [Test mode — use a live key for full content] respectively. Headlines, descriptions and URLs stay complete.
Use a paid plan with a live key for full article text. See masked results.
What is the default sort order, and how many results can I get per page?
Newest publication dates come first by default. Use sort.by and sort.order to change this; see sort modes.
per_page defaults to 100, or your plan limit if lower. Maximums are 250 on Professional and Corporate, 200 on Basic, 50 on Starter and 10 on Free. Higher values return 400 ER0171. Use page to fetch more; see pagination.
Why does my search return no results?
200 with results: [] means no articles matched. Different filters combine with AND, so try removing conditions one at a time. See empty search results.
What are the rate limits?
Free allows 10 requests per minute; Starter, Basic and Professional allow 50; Corporate allows 200. Test keys allow 15, and Fact Check has a separate 10-per-minute limit.
429 ER0203 means wait before retrying. Repeated violations can trigger a temporary ER0204 ban. See rate-limit errors.
What export formats are available?
On a paid plan, add export=csv, tsv, xml, rss, xlsx, parquet or jsonl. ndjson is an alias for JSONL. Leave out export for JSON, which is also available on Free.
Common Questions
How do I read an API error?
Read the HTTP status, then errors[0].code and errors[0].message. Keep request_id, also returned as X-Request-ID, when contacting support. See API error codes.
Does the API return cached data?
Responses use Cache-Control: no-store. A later request can return different articles as news changes. Check how your own app handles stored responses if it keeps showing an older result.