Mention stats API endpoint

All requests go to https://subalytics.com/api/v1/ with your key in the X-API-key header. Authentication, pagination, date filters and responses & errors apply to every endpoint.

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.

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
}

This page as Markdown: /docs/entity-mention-stats.md. All docs in one file: /llms-full.txt.