ADadanos
News Stocks

Raw mentions

Changed on

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
  • supported tickers with no rows return 200 with results=[]
  • unsupported tickers return 404, regardless of the requested window or offset
get/news/stocks/v1/stock/{ticker}/mentions

Request

  • Base URL
    https://api.adanos.com
  • Auth
    API key in header X-API-Key

Path parameters

tickerstring required

News company key: 1-32 ASCII letters/digits with an optional documented venue suffix, case-insensitive. Examples: BRK, EADSY, ABX.DE. Share classes (BRK.A, BRK.B, BRK-B), hyphens, ampersands, cashtags and unknown suffixes return 422. A documented suffix resolves only if assigned to that issuer; other well-formed keys return 404 on individual endpoints. One issuer is one time series; ETFs stay separate issuers. Venue suffixes: .AE, .AS, .AT, .AX, .BA, .BD, .BK, .BO, .BR, .CA, .CL, .CN, .CO, .DE, .DU, .F, .HA, .HE, .HK, .HM, .IC, .IR, .IS, .JK, .JO, .KL, .KQ, .KS, .KW, .L, .LS, .MC, .MI, .MU, .MX, .NE, .NS, .NZ, .OL, .PA, .PR, .PS, .QA, .RO, .SA, .SAU, .SG, .SI, .SN, .SS, .ST, .SW, .SZ, .T, .TA, .TO, .TW, .TWO, .V, .VI, .VN, .WA.

Query parameters

fromstring date nullable

Start date in YYYY-MM-DD. Inclusive UTC date.

tostring date nullable

End date in YYYY-MM-DD. Inclusive UTC date. Omit to use the current UTC date.

limitinteger

Maximum number of raw mentions to return

offsetinteger

Number of raw mention rows to skip for offset-based pagination.

Response

Successful Response

tickerstring required

Stock ticker symbol

period_daysinteger required

Lookback window used for the query

countinteger required

Total number of matching raw rows before limit and offset are applied; only the requested page is returned

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"
    }
  ]
}

Changes

  • a74a23b969c4Revision changes
    • info

      deleted the query request parameter days with deprecation

  • 559b660fa744Revision changes
    • warning

      changed the pattern of the path request parameter ticker from ^(?=[A-Za-z0-9]{1,32}$)[A-Za-z0-9]+$(?![\s\S]) to ^(?=[A-Za-z0-9.]{1,32}$)[A-Za-z0-9]+(?:\.(?:[Aa][Ee]|[Aa][Ss]|[Aa][Tt]|[Aa][Xx]|[Bb][Aa]|[Bb][Dd]|[Bb][Kk]|[Bb][Oo]|[Bb][Rr]|[Cc][Aa]|[Cc][Ll]|[Cc][Nn]|[Cc][Oo]|[Dd][Ee]|[Dd][Uu]|[Ff]|[Hh][Aa]|[Hh][Ee]|[Hh][Kk]|[Hh][Mm]|[Ii][Cc]|[Ii][Rr]|[Ii][Ss]|[Jj][Kk]|[Jj][Oo]|[Kk][Ll]|[Kk][Qq]|[Kk][Ss]|[Kk][Ww]|[Ll]|[Ll][Ss]|[Mm][Cc]|[Mm][Ii]|[Mm][Uu]|[Mm][Xx]|[Nn][Ee]|[Nn][Ss]|[Nn][Zz]|[Oo][Ll]|[Pp][Aa]|[Pp][Rr]|[Pp][Ss]|[Qq][Aa]|[Rr][Oo]|[Ss][Aa]|[Ss][Aa][Uu]|[Ss][Gg]|[Ss][Ii]|[Ss][Nn]|[Ss][Ss]|[Ss][Tt]|[Ss][Ww]|[Ss][Zz]|[Tt]|[Tt][Aa]|[Tt][Oo]|[Tt][Ww]|[Tt][Ww][Oo]|[Vv]|[Vv][Ii]|[Vv][Nn]|[Ww][Aa]))?$(?![\s\S])