curl -H "X-API-Key: YOUR_KEY" \
"https://api.tradingnews.press/v1/news/search?q=Fed%20interest%20rate%20decision&limit=5"
import httpx
resp = httpx.get(
"https://api.tradingnews.press/v1/news/search",
headers={"X-API-Key": "YOUR_KEY"},
params={"q": "Fed interest rate decision", "limit": 5},
)
articles = resp.json()["articles"]
{
"count": 2,
"query": "Fed interest rate decision",
"articles": [
{
"id": "01KP8JCVDPYSS17HNRZPXNAZCP",
"content": "Federal Reserve official Hammack stated that there are risks regarding the direction of interest rate targets...",
"urgency": "regular",
"sentiment": null,
"published_at": "2026-04-15T12:38:07+00:00",
"received_at": "2026-04-15T12:38:28.022468+00:00",
"tickers": []
},
{
"id": "01KP8JCVDPYSS17HNRZPXNAZCQ",
"content": "Bank of America raises terminal rate forecast after stronger-than-expected payrolls print.",
"urgency": "flash",
"sentiment": "hawkish",
"published_at": "2026-04-15T12:35:00+00:00",
"received_at": "2026-04-15T12:35:18.114002+00:00",
"tickers": [
{"ticker": "BAC", "sentiment": "neutral"}
]
}
]
}
{
"detail": "Semantic search is available on the Max plan only."
}
{
"detail": "Embedding service temporarily unavailable; please retry shortly."
}
API Reference
Search News
Semantic search over the article archive
GET
/
v1
/
news
/
search
curl -H "X-API-Key: YOUR_KEY" \
"https://api.tradingnews.press/v1/news/search?q=Fed%20interest%20rate%20decision&limit=5"
import httpx
resp = httpx.get(
"https://api.tradingnews.press/v1/news/search",
headers={"X-API-Key": "YOUR_KEY"},
params={"q": "Fed interest rate decision", "limit": 5},
)
articles = resp.json()["articles"]
{
"count": 2,
"query": "Fed interest rate decision",
"articles": [
{
"id": "01KP8JCVDPYSS17HNRZPXNAZCP",
"content": "Federal Reserve official Hammack stated that there are risks regarding the direction of interest rate targets...",
"urgency": "regular",
"sentiment": null,
"published_at": "2026-04-15T12:38:07+00:00",
"received_at": "2026-04-15T12:38:28.022468+00:00",
"tickers": []
},
{
"id": "01KP8JCVDPYSS17HNRZPXNAZCQ",
"content": "Bank of America raises terminal rate forecast after stronger-than-expected payrolls print.",
"urgency": "flash",
"sentiment": "hawkish",
"published_at": "2026-04-15T12:35:00+00:00",
"received_at": "2026-04-15T12:35:18.114002+00:00",
"tickers": [
{"ticker": "BAC", "sentiment": "neutral"}
]
}
]
}
{
"detail": "Semantic search is available on the Max plan only."
}
{
"detail": "Embedding service temporarily unavailable; please retry shortly."
}
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.curl -H "X-API-Key: YOUR_KEY" \
"https://api.tradingnews.press/v1/news/search?q=Fed%20interest%20rate%20decision&limit=5"
import httpx
resp = httpx.get(
"https://api.tradingnews.press/v1/news/search",
headers={"X-API-Key": "YOUR_KEY"},
params={"q": "Fed interest rate decision", "limit": 5},
)
articles = resp.json()["articles"]
{
"count": 2,
"query": "Fed interest rate decision",
"articles": [
{
"id": "01KP8JCVDPYSS17HNRZPXNAZCP",
"content": "Federal Reserve official Hammack stated that there are risks regarding the direction of interest rate targets...",
"urgency": "regular",
"sentiment": null,
"published_at": "2026-04-15T12:38:07+00:00",
"received_at": "2026-04-15T12:38:28.022468+00:00",
"tickers": []
},
{
"id": "01KP8JCVDPYSS17HNRZPXNAZCQ",
"content": "Bank of America raises terminal rate forecast after stronger-than-expected payrolls print.",
"urgency": "flash",
"sentiment": "hawkish",
"published_at": "2026-04-15T12:35:00+00:00",
"received_at": "2026-04-15T12:35:18.114002+00:00",
"tickers": [
{"ticker": "BAC", "sentiment": "neutral"}
]
}
]
}
{
"detail": "Semantic search is available on the Max plan only."
}
{
"detail": "Embedding service temporarily unavailable; please retry shortly."
}