API Reference
Search News
Semantic search over the article archive
GET
Available on the Max plan only. Requests from Starter or Pro keys return
403.Query Parameters
string
required
Natural-language query. 2 to 500 characters.
integer
default:"20"
Number of articles to return. Min: 1, Max: 100.
Response
integer
Number of articles returned.
string
The original query string, echoed back.
Article[]
Articles ranked by semantic relevance to the query. Same schema as
/v1/news. Because semantic search is Max-only, each article includes a tickers array with per-ticker sentiment (e.g. [{"ticker": "AAPL", "sentiment": "positive"}]); the array is empty when no tickers were detected.