Can I access historical news archives?
Find older articles by date and fetch them page by page
Written by Tasha Tatum
July 4, 2026
Updated October 16, 2026
Can I access historical news archives?
Yes. Use /v1/news/everything with published_at.start and published_at.end to find older articles. You can combine dates with language, publisher, entity, and other filters, then fetch matching results in pages.
Historical news uses the same endpoint as recent news.
Is there a separate archive endpoint?
No. Add a date range to /v1/news/everything. Send your key in api_key or the X-API-Key header:
curl "https://api.apitube.io/v1/news/everything?published_at.start=2024-01-01&published_at.end=2024-01-31&api_key=YOUR_API_KEY"
This requests articles published in January 2024. See how to filter news by date range.
What date formats does the range accept?
Both date parameters accept:
- Absolute dates:
2024-01-01,01-01-2024,01.01.2024, an ISO timestamp such as2024-01-01T00:00:00Z, or Unix seconds. - Relative dates:
NOW,NOW-1WEEK,NOW-6MONTHS,NOW-1YEAR, or short forms such as1w,6m,3d, and5y. A bare duration means the past.NOW/DAYmeans the start of today.
Each value must be 1–30 characters. Invalid start and end dates return 400 ER0104 and ER0106. Values longer than 30 characters return ER0105 and ER0107 respectively. See the official parameters reference.
This example requests the last twelve months:
curl "https://api.apitube.io/v1/news/everything?published_at.start=NOW-1YEAR&published_at.end=NOW&api_key=YOUR_API_KEY"
How do I page through a long historical window?
Searches are newest first by default. Use sort.by=published_at&sort.order=asc for oldest first, then increase page:
curl "https://api.apitube.io/v1/news/everything?published_at.start=2024-01-01&published_at.end=2024-01-31&sort.by=published_at&sort.order=asc&per_page=250&page=1&api_key=YOUR_API_KEY"
Maximum page sizes are 250 on Professional and Corporate, 200 on Basic, 50 on Starter, and 10 on Free. Reduce per_page in the example for a lower plan; too high a value returns ER0171. The default is 100 or your plan’s maximum, whichever is lower.
Continue with page=2, page=3, and so on. Invalid page values return ER0172. Free stops after five pages, returning ER0173 for more. At ten articles per page, that gives up to 50 per query. See how to paginate through results.
How far back does the archive go for my query?
Coverage varies by source, language, and topic. To find the oldest available result for your filters, sort oldest first and request one article:
curl "https://api.apitube.io/v1/news/everything?sort.by=published_at&sort.order=asc&per_page=1&api_key=YOUR_API_KEY"
Read its published_at. Add the source, language, or entity filters you intend to use to check the history relevant to your project.
How do I count how much history exists in a period?
Use /v1/news/count with your date range and a live key:
curl "https://api.apitube.io/v1/news/count?published_at.start=2023-01-01&published_at.end=2023-12-31&api_key=YOUR_API_KEY"
You get the matching count without downloading articles. Compare smaller date ranges, such as months, before fetching a larger dataset. See how to count matching articles for details and test-key limitations.
Common Questions
- Can I pull the entire archive in one request?
- Why am I limited to 5 pages of history?
- Does the trends endpoint work on old data?
- What does published_at without start or end do?
Can I pull the entire archive in one request?
No. Fetch a date range in pages within your plan’s page-size limit. For larger downloads, split by day, week, source, or language, then fetch each part.
Why am I limited to 5 pages of history?
That is the Free plan’s limit for every query. Upgrade to fetch more pages. You can still choose historical dates on Free.
Does the trends endpoint work on old data?
/v1/news/trends accepts a date range of up to 30 days. For articles across longer historical periods, use /v1/news/everything with date filters appropriate to your search.
What does published_at without start or end do?
A single published_at value selects that day and the following 24-hour window. An invalid value returns ER0109. Use the .start and .end parameters for a different window.