Podcasts 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.

The podcasts tracked by Subalytics. Podcasts, episodes and transcripts are linked by stable public IDs: a podcast's sub_id (10 hex characters) and an episode's episode_sub_id (16 hex characters). They never change, so they are safe to store as foreign keys. To fetch one item, filter by its ID.

Query parameters

Parameter	Type	Description
`sub_id`	string	One podcast
`language`	string	Exact match, e.g. en
`category`	string	Podcasts whose categories include this value, e.g. Business
`latest_episode_from`	date	Newest episode published on or after (see Date filters)
`latest_episode_to`	date	Newest episode published 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
`sub_id`	string	Public podcast ID
`podcast_name`	string	Podcast name
`feed_title`	string \| null	Title as published in the podcast feed (may differ from podcast_name)
`author`	string \| null	Author as published in the feed
`owner_name`	string \| null	Owner as published in the feed
`owner_email`	string \| null	Owner email as published in the feed
`description`	string \| null	Podcast description
`categories`	string[]	Categories
`language`	string \| null	Language declared by the feed, e.g. en
`explicit`	boolean \| null	Explicit flag as declared in the feed; null when the feed doesn't say
`image_url`	string \| null	Podcast artwork
`website_link`	string	Podcast website; only present when the feed has one
`latest_published_episode_utc`	date \| null	Publish date of the newest episode

Example

GET /api/v1/podcasts/?category=Business&limit=1

{
  "success": true,
  "results": [
    {
      "sub_id": "a1b2c3d4e5",
      "podcast_name": "Example Business Show",
      "feed_title": "Example Business Show",
      "author": "Example Media",
      "owner_name": "Example Media",
      "owner_email": "podcast@example.com",
      "description": "Weekly conversations about business, markets and culture.",
      "categories": ["Business", "News"],
      "language": "en",
      "explicit": null,
      "image_url": "https://example.com/artwork.jpg",
      "website_link": "https://example.com/podcast",
      "latest_published_episode_utc": "2026-09-24T16:38:09Z"
    }
  ],
  "returned_results": 1,
  "limit": 1,
  "next_cursor": "6a7cdd39fdbbf69e21a9ffbe"
}

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