/api/v1/newsGETList stored articles newest first, with optional source and language filters. Offset-paginated; use /api/v1/news/latest for the page-based variant. Requires the org:news:read scope.
Authorization
bearerAuth *Bearer <token>
Clerk session JWT, or an API key (the
ak_ prefix), sent as a Bearer token or an ?api_key= query parameter. Each endpoint requires the read scope for its resource (e.g. org:rates:read for rates). Token in: headerQuery Parameters
limit?integer
Page size. Values outside the range are clamped.
Default:
50Min: 1Max: 500offset?integer
Row offset.
Default:
0Min: 0source?string
Restrict to one NewsAPI source id. See /api/v1/news/filters.
language?string
Restrict to one ISO 639-1 code. Articles whose source is absent from the catalog have no language and are excluded when this is set.
Response
200 · Articles plus total/limit/offset
data *object[]
Show item properties
id *string
Opaque, stable article identifier.
title?stringnull
Headline, where the source reported one.
url *string
Link to the article on the publisher's site.
source *string
NewsAPI source id the article was collected under.
published_date?string,null (date-time)
Publication time reported by the source, never later than when we ingested it.
language?stringnull
ISO 639-1 code, resolved from the source catalog. Null when the source is not in the catalog.
image_url?stringnull
Lead image URL where the source provides one.
publisher?stringnull
Publishing outlet name as reported by the source.
created_at?string,null (date-time)
When this row was first recorded.
embedded *boolean
Whether a semantic-search embedding exists for this article. False whenever embeddings are disabled.
meta *object
Show properties
total *integer
Total articles matching the filters, ignoring limit/offset.
limit *integer
Page size actually applied after clamping.
offset *integer
Row offset applied.