Skip to main content
Topics form a tree. Broad categories like Politics and Business contain subtopics like politics/elections and business/technology. Episodes are classified into topics automatically — fetch the taxonomy to power category navigation, route episodes to topic-specific feeds, or filter content by interest.
Available to MCP agents as particle_topic_browse.

​
Browse the taxonomy

Top-level topics:
Response (truncated)
The ancestry_path is an opaque hash-based path used for programmatic ancestor filtering. Slugs follow a parent/child convention for subtopics (e.g. politics/elections). Get direct children of a topic by passing parent_id:
Response (truncated)

​
Get a single topic

The topic detail endpoint accepts any of three identifier forms in the path:
  • The encoded id returned by the list endpoint (e.g. 4FZ4EFh)
  • The full slug, including multi-level slugs with / (e.g. politics/elections)
  • The ancestry_path hash (e.g. GtizK, Qcqm_)
Response
Response fields:
  • ancestors — array of topic names from root to parent. Absent for root topics.
  • ancestry — single human-readable breadcrumb string. Absent for root topics.
  • total_children — total number of direct child topics. Always present (0 for leaves).
  • children — the top direct children ordered by prominence (url_cluster_count descending, ties broken by name). Capped at 100; when total_children exceeds 100, paginate the full set via /v1/topics?parent_id={id}.

​
Topics for an episode

Podcast episodes are classified into topics automatically. Fetch the topics for any episode:
See Episodes → Topics for the integrated discovery flow.
  • Entities — the people, organizations, and places counterpart to topics
  • Episodes — filter by topic, then drill into transcripts and clips