Raw Mentions
Returns raw news mention rows for a specific stock ticker within the live raw-data retention window. Professional account required. Free and Hobby accounts cannot use this endpoint.
Use this endpoint when you need:
- article-level snippets
- original timestamps
- source attribution for raw rows
Notes:
- Use from and to for explicit UTC date windows
- Results are ordered newest first and support deterministic offset + limit pagination
- empty result sets return 200 with results=[]
Path parameters
Stock ticker symbol (e.g., TSLA, aapl, BRK.A, $GME)
Stock ticker symbol (e.g., TSLA, aapl, BRK.A, $GME)
Query parameters
Start date in YYYY-MM-DD. Inclusive UTC date.
Start date in YYYY-MM-DD. Inclusive UTC date.
End date in YYYY-MM-DD. Inclusive UTC date. Omit to use the current UTC date.
End date in YYYY-MM-DD. Inclusive UTC date. Omit to use the current UTC date.
Deprecated v1 compatibility shorthand. Prefer from and to for reproducible UTC date windows.
Deprecated v1 compatibility shorthand. Prefer from and to for reproducible UTC date windows.
Maximum number of raw mentions to return
Maximum number of raw mentions to return
Number of raw mention rows to skip for offset-based pagination.
Number of raw mention rows to skip for offset-based pagination.
Response
Successful Response
Example response
{
"ticker": "AAPL",
"period_days": 7,
"count": 1,
"results": [
{
"article_id": "news-123",
"source": "reuters",
"url": "https://example.com/article",
"title": "Apple supplier outlook lifts sentiment",
"summary": "Suppliers signaled stronger-than-expected demand...",
"text_snippet": "Suppliers signaled stronger-than-expected demand...",
"author": "Jane Doe",
"created_utc": "2026-03-20T09:03:00Z",
"sentiment_score": 0.21,
"sentiment_label": "positive"
}
]
}