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.
| Plan | Historical data | Data freshness |
|---|---|---|
| Free | Last 30 days | 12-hour delay |
| Paid plans | Since 2020 | Real-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
tolater 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.