# Mention stats API endpoint

Source: https://subalytics.com/docs/entity-mention-stats/

> GET /api/v1/entity-mention-stats/: daily or weekly mention counts for one company, with no gaps in the series. Parameters and example.

`GET /api/v1/entity-mention-stats/` (No pagination · up to 100 periods). Base URL `https://subalytics.com/api/v1/`, API key in the `X-API-key` header; authentication, pagination, dates and errors: https://subalytics.com/docs/

Mention counts for one company over time: one row per day or week, oldest first. Counts include only mentions with `confidence` of 0.7 or above. Periods with no mentions are returned with zero counts, so a series has no gaps. To rank companies against each other, use [trending companies](https://subalytics.com/docs/entity-trending/).

This endpoint doesn't use cursors: `limit` caps the number of periods and `next_cursor` is always `null`. To cover a longer range, use `interval=week` or split the range into several requests.

## Query parameters

| Parameter | Type | Description |
|---|---|---|
| `symbol` | string | Required. The company |
| `source` | string | substack, bluesky or podcast; omit for all sources combined |
| `interval` | string | day (default) or week (ISO weeks, starting Monday) |
| `period_from` | date | First period returned. Default: 30 days before today |
| `period_to` | date | Last period returned. Default: yesterday (the last full day) |
| `limit` | int | Periods returned (default 100, max 100) |

## Response fields

| Field | Type | Description |
|---|---|---|
| `symbol` | string | Company ticker |
| `company_name` | string | Official company name |
| `period_start` | date | Start of the day or week |
| `interval` | string | day or week |
| `mention_count` | integer | Mentions in the period |
| `content_count` | integer | Distinct posts or episodes with at least one mention |
| `creator_count` | integer | Distinct creators and podcasts (sub_id) |
| `by_source` | object | {substack, bluesky, podcast} mention counts; only when source is omitted |

## Example

```
GET /api/v1/entity-mention-stats/?symbol=META&period_from=2026-09-25&period_to=2026-09-27
```

```
{
  "success": true,
  "results": [
    { "symbol": "META", "company_name": "Meta Platforms, Inc.", "period_start": "2026-09-25T00:00:00Z", "interval": "day", "mention_count": 41, "content_count": 37, "creator_count": 33, "by_source": { "substack": 3, "bluesky": 36, "podcast": 2 } },
    { "symbol": "META", "company_name": "Meta Platforms, Inc.", "period_start": "2026-09-26T00:00:00Z", "interval": "day", "mention_count": 58, "content_count": 51, "creator_count": 44, "by_source": { "substack": 5, "bluesky": 52, "podcast": 1 } },
    { "symbol": "META", "company_name": "Meta Platforms, Inc.", "period_start": "2026-09-27T00:00:00Z", "interval": "day", "mention_count": 132, "content_count": 118, "creator_count": 97, "by_source": { "substack": 4, "bluesky": 125, "podcast": 3 } }
  ],
  "returned_results": 3,
  "limit": 100,
  "next_cursor": null
}
```