# Company mentions API endpoint

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

> GET /api/v1/entity-mentions/: one row per company mention in podcasts, Substack and Bluesky, with snippet and link. Parameters and example.

`GET /api/v1/entity-mentions/` (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/

One row per company mention in one piece of content, across all three sources. Filter by `symbol` to see who is talking about a company, or by `sub_id` to see which companies a creator or podcast talks about.

## Query parameters

| Parameter | Type | Description |
|---|---|---|
| `mention_id` | string | One mention |
| `symbol` | string | Mentions of one company |
| `source` | string | substack, bluesky or podcast; omit for all |
| `sub_id` | string | Mentions by one creator or in one podcast |
| `content_id` | string | Mentions in one post or episode (post_id, post_uri or episode_sub_id) |
| `match_type` | string | cashtag, company_name, alias, product or ticker |
| `min_confidence` | number | 0.5–1.0, default 0.7 |
| `published_from` | date | Content published on or after |
| `published_to` | date | Content published on or before |
| `updated_from` | date | Mention last changed on or after (use for sync) |
| `updated_to` | date | Mention last changed on or before |
| `limit` | int | Results per page (default 25, max 100) |
| `cursor` | string | next_cursor from the previous page |

## Response fields

| Field | Type | Description |
|---|---|---|
| `mention_id` | string | Public mention ID |
| `symbol` | string | Company ticker |
| `company_name` | string | Official company name |
| `source` | string | substack, bluesky or podcast |
| `content_id` | string | ID of the post or episode on its content endpoint |
| `sub_id` | string | The creator or podcast |
| `content_url` | string \| null | Link to the original post or episode page |
| `published_utc` | date | When the content was published |
| `match_type` | string | What was matched: cashtag, company_name, alias, product or ticker |
| `matched_text` | string | The text as it appeared in the content |
| `confidence` | number | 0–1 |
| `snippet` | string | The sentence or passage around the mention |
| `field` | string \| null | Posts only: where the match was found |
| `start, end` | number \| null | Podcasts only: seconds from the start of the audio |
| `created_at` | date | When the mention was first found |
| `updated_at` | date | When the mention last changed (e.g. re-scored) |

## Example

```
GET /api/v1/entity-mentions/?symbol=META&published_from=2026-09-20&limit=2
```

```
{
  "success": true,
  "results": [
    {
      "mention_id": "9f2c41d07ab35e18",
      "symbol": "META",
      "company_name": "Meta Platforms, Inc.",
      "source": "bluesky",
      "content_id": "at://did:plc:exampleaccount000000000/app.bsky.feed.post/3lqz7x2kfbc2s",
      "sub_id": "e81a3f90c2",
      "content_url": "https://bsky.app/profile/did:plc:exampleaccount000000000/post/3lqz7x2kfbc2s",
      "published_utc": "2026-09-27T14:02:11Z",
      "match_type": "cashtag",
      "matched_text": "$META",
      "confidence": 0.95,
      "snippet": "$META up 4% premarket after ad revenue beat.",
      "field": "text",
      "start": null,
      "end": null,
      "created_at": "2026-09-27T14:03:40Z",
      "updated_at": "2026-09-27T14:03:40Z"
    },
    {
      "mention_id": "c07e5b1a94d2f836",
      "symbol": "META",
      "company_name": "Meta Platforms, Inc.",
      "source": "podcast",
      "content_id": "c41f7a09e2b85d13",
      "sub_id": "a1b2c3d4e5",
      "content_url": "https://example.com/podcast/episodes/248",
      "published_utc": "2026-09-24T16:38:09Z",
      "match_type": "product",
      "matched_text": "instagram",
      "confidence": 0.78,
      "snippet": "and instagram is basically where every small brand does its marketing now",
      "field": null,
      "start": 1834.2,
      "end": 1841.9,
      "created_at": "2026-09-25T07:15:03Z",
      "updated_at": "2026-09-25T07:15:03Z"
    }
  ],
  "returned_results": 2,
  "limit": 2,
  "next_cursor": "6a7d9a11c8173839e2253ae4"
}
```