Trending companies 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.

Companies ranked by mention volume, or by how much their volume changed, over a time window. Each company is compared with the window of the same length immediately before it: for a 7-day window, the previous 7 days. Counts include only mentions with confidence of 0.7 or above.

This endpoint doesn't use cursors: limit caps the number of companies and next_cursor is always null.

Query parameters

Parameter	Type	Description
`source`	string	substack, bluesky or podcast; omit for all sources combined
`period_from`	date	Start of the window to rank (whole days). Default: 7 days before today
`period_to`	date	End of the window to rank. Default: yesterday (the last full day)
`sort`	string	volume (default, most mentions in the window) or change (largest change_pct)
`min_mentions`	int	Only rank companies with at least this many mentions in the window (default 10), so sort=change isn't dominated by moves like 1 → 5 mentions
`sector`	string	Rank only companies in one sector (the sector value from entity-companies)
`limit`	int	Companies returned (default 25, max 100)

Response fields

Field	Type	Description
`rank`	integer	1 = top
`symbol`	string	Company ticker
`company_name`	string	Official company name
`mention_count`	integer	Mentions in the window
`previous_mention_count`	integer	Mentions in the equal-length window before
`change_pct`	number \| null	Percentage change vs. the previous window; null when previous_mention_count is 0
`creator_count`	integer	Distinct creators and podcasts in the window

With sort=change, companies whose change_pct is null (no mentions in the previous window) are ranked after every company with a number.

Example

GET /api/v1/entity-trending/?sort=change&period_from=2026-09-21&period_to=2026-09-27&limit=2

{
  "success": true,
  "results": [
    { "rank": 1, "symbol": "META", "company_name": "Meta Platforms, Inc.", "mention_count": 412, "previous_mention_count": 139, "change_pct": 196.4, "creator_count": 301 },
    { "rank": 2, "symbol": "TSLA", "company_name": "Tesla, Inc.", "mention_count": 5210, "previous_mention_count": 2884, "change_pct": 80.7, "creator_count": 3120 }
  ],
  "returned_results": 2,
  "limit": 2,
  "next_cursor": null
}

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