# Companies API endpoint (entity mentions)

Source: https://subalytics.com/docs/entity-companies/

> GET /api/v1/entity-companies/: every public company monitored for mentions, with ticker, CIK, exchange, sector and industry.

`GET /api/v1/entity-companies/` (Cursor pagination · newest first). Base URL `https://subalytics.com/api/v1/`, API key in the `X-API-key` header; authentication, pagination, dates and errors: https://subalytics.com/docs/

Every company monitored for mentions; a company not listed here is never matched. This is the reference for official company data. Other `entity-*` endpoints give only `symbol` and `company_name`, so join on `symbol` to get the rest. Newly monitored companies appear first.

## Query parameters

| Parameter | Type | Description |
|---|---|---|
| `symbol` | string | One company, exact match, e.g. META |
| `cik` | string | One company by SEC CIK |
| `q` | string | Case-insensitive search on symbol and company name, e.g. q=meta |
| `sector` | string | Exact match, e.g. Technology |
| `exchange` | string | Exact match, e.g. NASDAQ |
| `limit` | int | Results per page (default 25, max 100) |
| `cursor` | string | next_cursor from the previous page |

## Response fields

| Field | Type | Description |
|---|---|---|
| `symbol` | string | Ticker |
| `company_name` | string | Official company name |
| `cik` | string \| null | SEC CIK |
| `exchange` | string \| null | Listing exchange |
| `sector` | string \| null | Sector |
| `industry` | string \| null | Industry |

## Example

```
GET /api/v1/entity-companies/?q=meta
```

```
{
  "success": true,
  "results": [
    {
      "symbol": "META",
      "company_name": "Meta Platforms, Inc.",
      "cik": "0001326801",
      "exchange": "NASDAQ",
      "sector": "Communication Services",
      "industry": "Internet Content & Information"
    }
  ],
  "returned_results": 1,
  "limit": 25,
  "next_cursor": null
}
```