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

# Search stocks

`GET /reddit/stocks/v1/search`

## Request

- Base URL: `https://api.adanos.com`
- URL: `https://api.adanos.com/reddit/stocks/v1/search`
- Auth: API key in header `X-API-Key`

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.dev/adanos/apis/adanos-market-sentiment-api.md) - [All operations](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/revisions/7e8bdb1e7e75?raw)