Skip to main content
GET
Available on the Max plan only. Requests from Starter or Pro keys return 403.

Query Parameters

q
string
required
Natural-language query. 2 to 500 characters.
limit
integer
default:"20"
Number of articles to return. Min: 1, Max: 100.

Response

count
integer
Number of articles returned.
query
string
The original query string, echoed back.
articles
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.