Get Top Headlines

Go to Product

This endpoint provides live top and breaking articles for a country, specific category in a country, single source, or multiple sources. You can also search with keywords. Articles are sorted by the earliest date published first.


Country (*)

The 2-letter ISO 3166-1 code of the country you want to get articles for. Possible options: ae ar at au be bg br ca ch cn co cu cz de eg fr gb gr hk hu id ie il in it jp kr lt lv ma mx my ng nl no nz ph pl pt ro rs ru sa se sg si sk th tr tw ua us ve za. Note: you can't mix this param with the sources param.

Category (*)

The category you want to get articles for. Possible options: business entertainment general health science sports technology. Note: you can't mix this param with the sources param.

Sources (*)

A comma-seperated string of identifiers for the news sources or blogs you want articles from. Use the /top-headlines/sources endpoint to locate these programmatically or look at the sources index. Note: you can't mix this param with the country or category params.

Query (*)
Keywords or a phrase to search for.
Page Size (*)
The number of results to return per page (request). 20 is the default, 100 is the maximum.
Page (*)
Use this to page through the results if the total results found is greater than the page size.
Result Format
Specify how the response should be mapped to the table output. The following formats are available:
  • Structured Table: Returns a parsed table with data split into rows and columns.
    • Source ID: The identifier of the news source. You can use this with our other endpoints.
    • Source Name: The name of the news source.
    • Author: The author of the article.
    • Title: The title of the article web page.
    • Description: A description or snippet from the article.
    • URL: The direct URL to the article.
    • URL to Image: The URL to a relevant image for the article.
    • Published At: The date and time that the article was published, in UTC (+000).
    • Content: The unformatted content of the article, where available. This is truncated to 200 chars.
  • Raw Response: Returns the raw response in a single row with the following columns:
    • body: Response body
    • status: HTTP status code

Input Ports

Configuration data.

Output Ports

Result of the request depending on the selected Result Format.
Configuration data (this is the same as the input port; it is provided as passthrough for sequentially chaining nodes to declutter your workflow connections).

Popular Predecessors

  • No recommendations found

Popular Successors

  • No recommendations found


This node has no views


  • No workflows found



You want to see the source code for this node? Click the following button and we’ll use our super-powers to find it for you.