# search_companies

Find US-listed companies by name or ticker in the SEC EDGAR directory. Returns ticker, name, exchange, country and CIK, best match first. Use it first when you are not sure of a ticker.

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

## Parameters

| Parameter | Type | Default | Description |
|---|---|---|---|
| `query` (required) | string (up to 100 characters) | — | Company name or ticker, e.g. 'apple' or 'AAPL'. |
| `limit` | integer (1–25) | 10 | Rows to return, 1-25. |

## Example

REST:

```bash
curl -H "Authorization: Bearer fdz_live_YOUR_KEY" "https://api.fundalyze.ai/api/public/v1/search_companies?query=berkshire&limit=5"
```

MCP `tools/call`:

```json
{
  "name": "search_companies",
  "arguments": {
    "query": "berkshire",
    "limit": 5
  }
}
```

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

```text
Companies matching 'berkshire' · SEC EDGAR directory · best match first
ticker,name,exchange,country,cik
BRK-A,BERKSHIRE HATHAWAY INC,NYSE,US,1067983
BRK-B,BERKSHIRE HATHAWAY INC,NYSE,US,1067983
More: https://fundalyze.ai/stocks
```

Response `data`:

```json
{
  "query": "berkshire",
  "companies": [
    {
      "ticker": "BRK-A",
      "name": "BERKSHIRE HATHAWAY INC",
      "exchange": "NYSE",
      "country": "US",
      "cik": 1067983
    },
    {
      "ticker": "BRK-B",
      "name": "BERKSHIRE HATHAWAY INC",
      "exchange": "NYSE",
      "country": "US",
      "cik": 1067983
    }
  ]
}
```

## 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.
