Newsapi · News

NewsAPI.org / Top and breaking headlines

Live top and breaking headlines for a country, a category, specific sources, or a keyword. sources cannot be mixed with country or category. Answer: status, totalResults, articles[].

Live data

You are looking at the live public catalog.

unverifiedRequest shape unavailableUnverified

Published API evidence

Public metadata only. Response bodies, credentials, and internal review notes are never displayed.

No verification date is claimed. No response capture is claimed.

Request parameters

category query · optional
Category of headlines. Not with sources.
country query · optional
2-letter ISO 3166-1 country code, e.g. us. Not with sources.
page query · optional
Page number.
pageSize query · optional
Results per page, default 20, max 100.
q query · optional
Keywords or a phrase to search for.
sources query · optional
Comma separated source identifiers. Not with country or category.

No allowlisted official documentation or pricing reference is available.