Skip to main content
GET
List news articles

Authorizations

Authorization
string
header
required

Bearer token authentication used for standard API calls. Format: 'Bearer YOUR_API_KEY'

Query Parameters

publication
string

Comma-separated publication slugs to filter by (e.g. nytimes,wsj)

tag
string

Comma-separated tags to filter by (e.g. technology,business)

q
string

Case-insensitive keyword search across article title and summary. Tokens are split on whitespace and every token must appear in the title or summary (order-independent). Wildcards and operators are not supported — each token is matched literally.

Maximum string length: 200
since
string<date-time>

ISO 8601 date string. Only articles published after this date are returned. Defaults to 24 hours ago.

limit
integer
default:50

Page size (default 50, max 200)

Required range: 1 <= x <= 200
offset
integer
default:0

Pagination offset (default 0)

Required range: x >= 0

Response

Paginated list of articles

articles
object[]
total
integer
limit
integer
offset
integer