Skip to main content
GET
Search news stories
Find coverage of a topic, then use Fetch a web page to read a story before summarizing it. Publication labels can be relative, such as 2 hours ago. Preserve source links and do not assume every date is a timestamp. Follow next_page until it is null.

Authorizations

Authorization
string
header
required

Public API key: Authorization: Bearer san_....

Query Parameters

page
number

1 based, up to 5.

Example:

1

country
string

ISO 3166-1 alpha-2. Defaults to us.

Example:

"us"

query
string
required
Example:

"coffee prices"

Response

id
string<uuid>
required

Id of this request. Quote it when reporting a problem.

took_ms
number
required

How long the request took, in milliseconds.

Example:

1420

request
object
required

The parameters as accepted, after defaults and normalization. What the request actually ran with.

Example:
next_page
number | null
required

The next page to ask for, or null when there is no further page. Never a page this endpoint would reject.

Example:

2

results
object[]
required