Skip to main content

Article Availability

This page shows which articles each plan can return, to help you choose a plan and set from and to.

Your plan sets how far back the archive goes and how soon a new article becomes available. This applies to both the Search endpoint and the Top Headlines endpoint, and it sets the range of the from and to parameters.

PlanHistorical dataData freshness
FreeLast 30 days12-hour delay
Paid plansSince 2020Real-time

The full comparison of the plans is on the Pricing page.

What happens outside your range​

Asking for a period outside your plan isn't an error. The API returns no articles for the part you can't reach, so an empty articles array is a normal result.

On the Free plan:

  • A to later than 12 hours ago is moved back to 12 hours ago.
  • Articles older than 30 days are left out, and the response says how many in articlesRemovedFromResponse.historicalArticles: see Free plan notices.

If you get fewer articles than you expect, check totalArticles in the response: it counts every article that matched your request. See JSON Response.