World News
Get the top or latest news stories, by topic, country or edition
Request
- Base URL: https://api.apiverve.com
- URL: https://api.apiverve.com/v1/news
- Auth: API key in header x-api-key
Query parameters
Only stories on this topic. A story is in every topic its headline and summary name, not only its feed's section.
Only stories about this country, from any outlet: an ISO 3166 code or English name, for example JP or Japan.
Only stories run by outlets based in this country: what its press is covering, in the languages it writes in. See list=editions.
Only stories in this language. Defaults to English, or with edition to the languages that edition's press writes in. Stories are never translated.
top ranks stories by how many outlets carry them, favouring the last 12 hours; latest is newest first.
Only stories whose headlines or summaries contain every word given, in any case.
Only stories published at or after this date or date-time (ISO 8601), for example 2026-10-01 or 2026-10-01T14:00:00Z.
Maximum number of stories to return: up to 10 on the free plan, 50 on paid plans.
Response
Successful Response
Changes
No recorded changes to this operation across all 1 revision of this API.