---
title: "Search stocks"
method: GET
path: "/reddit/stocks/v1/search"
tags: ["Reddit Stocks"]
---

# Search stocks

`GET /reddit/stocks/v1/search`

Search stocks by ticker, company name or alias. Results prioritize match relevance first (exact ticker matches, then prefixes, then name/alias matches) and include a compact summary block for the last 7 UTC calendar days. Summary mentions include inherited thread-context mentions; use raw /mentions without include_inherited for explicit-only rows.

## Query parameters

- `q` string, required — Search query (minimum 2 non-$ characters after trimming)
- `limit` integer — Maximum number of results to return

## Response `200`

Successful Response

- SearchResponse — Search results for stocks.
  - `query` string, required — Original search query
  - `count` integer, required — Total number of matching results before the limit is applied
  - `period_days` integer, required — Fixed lookback window used for each summary block
  - `results` SearchResultItem[], required — Top matching stocks capped by the requested limit
    - `ticker` string, required — Stock ticker symbol
    - `name` string, required — Company name
    - `type` string, nullable — Asset type (Stock, ETF, etc.)
    - `exchange` string, nullable — Stock exchange (NYSE, NASDAQ, etc.)
    - `sector` string, nullable — Industry sector
    - `country` string, nullable — Country of headquarters
    - `aliases` string[] — Alternative names/aliases
    - `summary` StockSearchSummary, required — Compact last-7-days summary attached to stock search results.
      - `mentions` integer, required — Attributed mentions in the last 7 UTC calendar days, including inherited thread-context mentions
      - `buzz_score` number, nullable, required — Buzz score over the last 7 UTC calendar days
      - `trend` 'rising' | 'falling' | 'stable', nullable — Activity momentum over the current 3 UTC days vs previous 3 UTC days using mentions, upvotes and subreddit breadth; not price movement. For `from`/`to`, anchors at `to` (or now when `to` is today).
      - `sentiment_score` number, nullable — Average sentiment score over the last 7 UTC calendar days

## Other responses

- `401` — Authentication failed
- `422` — Invalid search query parameters
- `429` — Rate limit exceeded
- `503` — Database temporarily unavailable
- `504` — Analytics request deadline exceeded

---

[API](https://skmtc.net/adanos/apis/adanos-market-sentiment-api.md) · [All operations](https://skmtc.net/adanos/apis/adanos-market-sentiment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adanos/adanos-market-sentiment-api/versions/351caf64ba81/schema)