v1

latestOpenAPI 3.1.0MIT2026-08-0453113564.4 KB

X/Twitter Stocks

Search stocks

Search stocks by ticker, company name or alias in the X/Twitter universe. Results prioritize exact ticker matches first, then prefixes, then name/alias matches and include a compact summary block for the last 7 UTC calendar days.

get/x/stocks/v1/search

Query parameters

qstring required

Search query (minimum 2 non-$ characters after trimming)

Example:tesla

Search query (minimum 2 non-$ characters after trimming)

limitinteger

Maximum number of results to return

Example:20

Maximum number of results to return

Response

Successful Response

querystring required

Original search query

countinteger required

Total number of matching results before the limit is applied

period_daysinteger required

Fixed lookback window used for each summary block

Example response

{
  "query": "tesla",
  "count": 1,
  "period_days": 7,
  "results": [
    {
      "ticker": "TSLA",
      "name": "Tesla Inc.",
      "type": "Stock",
      "exchange": "NASDAQ",
      "sector": "Consumer Discretionary",
      "country": "United States",
      "aliases": [
        "Tesla",
        "Elon"
      ],
      "summary": {
        "mentions": 156,
        "buzz_score": 72.5,
        "trend": "rising",
        "sentiment_score": 0.35
      }
    }
  ]
}