The Web Content API is deprecated. Use the News, Blogs & Forums APIs instead - same content, one endpoint per content type, and where new features land.
With no time parameter, the API returns posts crawled in the last 3 days.
ts parameterts is a Unix timestamp in milliseconds. The API returns posts crawled at or after ts:
&ts=1748736000000
ts is also how pagination walks backward in time - the next URL sets it for you.
Going back more than 31 days is a premium feature that consumes credits. Enable it explicitly:
&allowNewsHistory=true
Without allowNewsHistory=true, a ts older than 31 days is clamped to the last 3 days and the response includes a warning.
Each call costs credits based on how far back ts reaches. The deeper into history, the more credits per call:
How far back ts reaches | Credits per call |
|---|---|
| Last 31 days | 1 |
| 31 days - 3 months | 2 |
| 3 - 6 months | 3 |
| Older than 6 months | 4 |
requestsLeft in each response reflects the credits remaining after this cost.
News history beyond 31 days uses credits, and a single deep-history call can cost up to 4 credits. Only set allowNewsHistory=true when you intend to query the archive window.