Get Sources

Go to Product

This endpoint returns the subset of news publishers that top articles (`/v2/top-headlines`) are available from. It's mainly a convenience endpoint that you can use to keep track of the publishers available on the API, and you can pipe it straight through to your users.

Options

Category (*)

The category you want to get articles for. Possible options: business entertainment general health science sports technology. Default: all categories.

Language (*)

Find sources that display news in a specific language. Possible options: ar de en es fr he it nl no pt ru sv ud zh. Default: all languages returned.

Country (*)

Find sources that display news in a specific country. 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. Default: all countries.

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.
    • ID: The identifier of the news source. You can use this with our other endpoints.
    • Name: The name of the news source.
    • Description: A description of the news source.
    • URL: The URL of the homepage.
    • Category: The type of news to expect from this news source.
    • Language: The language that this news source writes in.
    • Country: The country this news source is based in (and primarily writes about).
  • Raw Response: Returns the raw response in a single row with the following columns:
    • body: Response body
    • status: HTTP status code

Input Ports

Icon
Configuration data.

Output Ports

Icon
Result of the request depending on the selected Result Format.
Icon
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

Views

This node has no views

Workflows

  • No workflows found

Links

Developers

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.