# get_peers

A company's researched competitor set (business first, size second): each peer's ticker, name, exchange and CIK, plus unlisted competitors by name. No multiples or market data.

- Group: Companies
- REST: `GET https://api.fundalyze.ai/api/public/v1/get_peers` with the parameters as the query string
- MCP: the `get_peers` tool on `https://api.fundalyze.ai/mcp`
- HTML page: https://fundalyze.ai/developers/reference/get_peers

## Parameters

| Parameter | Type | Default | Description |
|---|---|---|---|
| `ticker` (required) | string (up to 12 characters) | — | US ticker symbol, e.g. AAPL or BRK-B. Use search_companies when unsure. |

## Example

REST:

```bash
curl -H "Authorization: Bearer fdz_live_YOUR_KEY" "https://api.fundalyze.ai/api/public/v1/get_peers?ticker=AAPL"
```

MCP `tools/call`:

```json
{
  "name": "get_peers",
  "arguments": {
    "ticker": "AAPL"
  }
}
```

Response `text` (generated Oct 7, 2026):

```text
AAPL · researched peers (business first, size second) · as of 2026-10-01
ticker,name,exchange,cik
MSFT,MICROSOFT CORP,NASDAQ,789019
GOOG,Alphabet Inc.,NASDAQ,1652044
SONY,Sony Group Corp,NYSE,313838
DELL,Dell Technologies Inc.,NYSE,1571996
HPQ,HP INC,NYSE,47217
... 2 more rows in the full answer (trimmed for the docs)
Basis: Consumer hardware plus a services ecosystem: devices, PCs and platform software.
Unlisted competitors: Samsung Electronics; Xiaomi; Huawei; Lenovo
More: https://fundalyze.ai/stocks/nasdaq/aapl?tab=comps
```

Response `data`:

```json
{
  "ticker": "AAPL",
  "peers": [
    {
      "ticker": "MSFT",
      "name": "MICROSOFT CORP",
      "exchange": "NASDAQ",
      "cik": 789019,
      "url": "https://fundalyze.ai/stocks/nasdaq/msft"
    },
    {
      "ticker": "GOOG",
      "name": "Alphabet Inc.",
      "exchange": "NASDAQ",
      "cik": 1652044,
      "url": "https://fundalyze.ai/stocks/nasdaq/goog"
    },
    {
      "ticker": "SONY",
      "name": "Sony Group Corp",
      "exchange": "NYSE",
      "cik": 313838,
      "url": "https://fundalyze.ai/stocks/nyse/sony"
    },
    {
      "ticker": "DELL",
      "name": "Dell Technologies Inc.",
      "exchange": "NYSE",
      "cik": 1571996,
      "url": "https://fundalyze.ai/stocks/nyse/dell"
    },
    {
      "ticker": "HPQ",
      "name": "HP INC",
      "exchange": "NYSE",
      "cik": 47217,
      "url": "https://fundalyze.ai/stocks/nyse/hpq"
    }
  ],
  "unlisted_competitors": [
    "Samsung Electronics",
    "Xiaomi",
    "Huawei",
    "Lenovo"
  ],
  "rationale": "Consumer hardware plus a services ecosystem: devices, PCs and platform software.",
  "researched_at": "2026-10-01T22:12:02.782161+00:00"
}
```

Rows trimmed to the first 5 for the docs: peers had 7.

## Fields of `data`

| Field | Meaning |
|---|---|
| `peers` | The researched peers (list; see peers[]). |
| `ticker` | The subject's ticker. |
| `peers[].ticker` | Peer's ticker, most comparable first. |
| `peers[].name` | Peer's name from the SEC directory. |
| `peers[].exchange` | Peer's exchange. |
| `peers[].cik` | Peer's SEC CIK. |
| `peers[].url` | Peer's page on fundalyze.ai. |
| `unlisted_competitors` | Competitors with no US listing, as names. |
| `rationale` | How the set was chosen. |
| `researched_at` | When the set was researched (ISO timestamp). |

## The link

Every answer ends with `More: <link>`, and REST returns the same URL as `link`: the fundalyze.ai page where the figures can be checked. Cite it when you show the data to others.