Get Everything

Options

Query (*)

Keywords or phrases to search for in the article title and body.

Advanced search is supported here:

• Surround phrases with quotes (") for exact match.
• Prepend words or phrases that must appear with a + symbol. Eg: +bitcoin
• Prepend words that must not appear with a - symbol. Eg: -bitcoin
• Alternatively you can use the AND / OR / NOT keywords, and optionally group these with parenthesis. Eg: crypto AND (ethereum OR litecoin) NOT bitcoin.

The complete value for q must be URL-encoded. Max length: 500 chars.

Search In (*)

The fields to restrict your q search to.

The possible options are:

• title
• description
• content

Multiple options can be specified by separating them with a comma, for example: title,content.

This parameter is useful if you have an edge case where searching all the fields is not giving the desired outcome, but generally you should not need to set this.

Default: all fields are searched.

Sources (*)

A comma-seperated string of identifiers (maximum 20) for the news sources or blogs you want headlines from. Use the /sources endpoint to locate these programmatically or look at the sources index.

Domains (*)

A comma-seperated string of domains (eg bbc.co.uk, techcrunch.com, engadget.com) to restrict the search to.

Exclude Domains (*)

A comma-seperated string of domains (eg bbc.co.uk, techcrunch.com, engadget.com) to remove from the results.

From (*)

A date and optional time for the oldest article allowed. This should be in ISO 8601 format (e.g. 2022-10-25 or 2022-10-25T15:32:33)

Default: the oldest according to your plan.

To (*)

A date and optional time for the newest article allowed. This should be in ISO 8601 format (e.g. 2022-10-25 or 2022-10-25T15:32:33)

Default: the newest according to your plan.

Language (*)

The 2-letter ISO-639-1 code of the language you want to get articles for. Possible options: ar de en es fr he it nl no pt ru sv ud zh.

Default: all languages returned.

Sort By (*)

The order to sort the articles in. Possible options: relevancy, popularity, publishedAt.

relevancy = articles more closely related to q come first. popularity = articles from popular sources and publishers come first. publishedAt = newest articles come first.

Default: publishedAt

Page Size (*)

The number of results to return per page.

Default: 100. Maximum: 100.

Page (*)

Use this to page through the results.

Default: 1.

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

Views

This node has no views

Workflows

• No workflows found

Links

• No links available

Developers