/api/v1/public/indices/{id}/newsGETNews articles related to this index. An index's news is drawn from its constituent markets: each article is matched against every market in the index (composite indices include their sub-indices' markets) and ranked by its closest match, with via_market_id and via_market_question identifying that market. Returns up to 3 articles per request, each published at least 24 hours ago, best match first, as a single page. Paid plans lift these limits: the authenticated endpoint returns the full ranked list, including the most recent articles, with pagination and a tunable min_similarity threshold. Responses are cached at the edge for up to 60 seconds.
Query Parameters
per_page?integer
Articles to return (1-3).
Default:
3Min: 1Max: 3Response
200 · Related articles
data?object[]
Show item properties
article_id *string
similarity *number (double)
Cosine similarity of the best embedding match.
title?stringnull
url?stringnull
image_url?stringnull
published_date?string,null (date-time)
source?stringnull
Where the article was published: the publisher's name when known, otherwise the site's hostname.
via_market_id?stringnull
The constituent market this article matched most closely. Present only on index news, where results are drawn from the index's constituent markets.
via_market_question?stringnull
The question text of that market.
meta?object
Show properties
total?integer
Total number of records matching the request across every page, not just the number returned in this one.
page?integer
The 1-based page number this response covers.
per_page?integer
Maximum number of items on a page. The last page may hold fewer.
total_pages?integer
Number of pages available at this
per_page. It is at least 1, even when nothing matched.has_next?boolean
True when a page exists after this one.
has_prev?boolean
True when this is not the first page.
404 · Unknown index id
Unknown index id