APITube Help Center

How far back does the news archive go?

Find the oldest available article for your search

Kent Hudson

Written by Kent Hudson

July 4, 2026

Updated October 16, 2026

Open this example in the API Playground ↗

How far back does the news archive go?

Archive coverage varies by source, language, and topic. To check how far back your search reaches, sort results oldest first and read the first article’s publication date. APITube does not provide one cut-off date that applies to every search.

Use /v1/news/everything for both historical and recent articles. There is no separate archive endpoint.

Is there a fixed cut-off date for the archive?

No. The earliest available article depends on your filters. A search for one publisher can reach only that publisher’s available articles. A broader search may find older coverage from other sources.

The API does not return a global earliest-date field. Check the oldest result for the source, language, country, or entity you need.

How do I find the earliest article for my query?

Set sort.by=published_at, sort.order=asc, and per_page=1:

curl "https://api.apitube.io/v1/news/everything?sort.by=published_at&sort.order=asc&per_page=1&api_key=YOUR_API_KEY"

Read published_at in the returned article. With no filters, it is the oldest available result for that request. Add your filters to check a particular part of the archive. For example, this finds the oldest German-language result:

curl "https://api.apitube.io/v1/news/everything?language.code=de&sort.by=published_at&sort.order=asc&per_page=1&api_key=YOUR_API_KEY"

Send your key in the api_key parameter or the X-API-Key header. This is billed as a regular search.

How much history exists in a given period?

Use /v1/news/count with a live key and a date range to count matching articles without downloading them:

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"

Include filters when you need an actual count. An unfiltered count returns a rounded overview figure, and a test key returns a demonstration figure. Neither gives an exact count for a period.

Try one month at a time to compare coverage across dates. See how to count news articles.

Can I read the whole archive at once?

No. Fetch it in pages. The page-size limit is 250 on Professional and Corporate, 200 on Basic, 50 on Starter, and 10 on Free. Asking for more returns ER0171.

Choose a date range, sort oldest first, and increase page until no results remain. Then move to the next date range. Free can fetch only the first five pages of each query.

See can I access historical news archives? for pagination, how to filter news by date range for date filters, and the official parameters reference for the full syntax.

For the time it takes new articles to become available, see how fresh is the data and what is the latency?.

Common Questions

Does APITube have a separate archive endpoint?

No. Use /v1/news/everything with published_at.start and published_at.end. You can combine those dates with language, source, entity, or country filters as you would for recent news.

Why isn’t there a single “N years” number?

The oldest available date differs by source, language, and topic. Sorting your filtered search with sort.order=asc&per_page=1 shows the date that applies to your query.

Can I reach older articles on the Free plan?

Yes. You can search past dates, but Free allows only five pages of ten articles per query: up to 50 articles. Going past page 5 returns ER0173. The oldest-article example works because it needs only the first page. Upgrade if you need more results from the same historical query.


Related Articles