Search for news articles that mention a specific topic or keyword

The main use of our News API is to search through every article published by a wide range of news sources and blogs in recent years. Think of this as Google News that you can interact with programmatically.

In this example we want to find all articles that mention Apple published today, and sort them by most popular source first. For this we need to use the /everything endpoint.

For more information about the /everything endpoint, including valid parameters for narrowing your search, see the endpoint reference below.

Authentication

Include your API key in the x-api-key header for every request.

Endpoint: GET /search

• query — keyword or phrase (required)
• from — ISO start date
• sortBy — relevance | popularity | publishedAt
• limit — number of results per page (default 10)

Endpoint: GET /headlines

Curated breaking news by category, language and region.

Endpoint: GET /sources

List supported publishers and domains.

Get curated breaking news headlines

Use the headlines endpoint for fast access to trending news.