Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.particle.pro/llms.txt

Use this file to discover all available pages before exploring further.

Find a podcast by free-text title or exact slug. Returns slug, title, episode count, bias, and the top recurring speakers (with entity slugs). Use the slug as the agent-facing handle to feed into other podcast tools. With both query and slug omitted, returns the most recently updated podcasts — useful for browsing the catalog when you don’t have a name in mind. Set include_external_links=true to also pull each podcast’s third-party platform presences (Apple Podcasts, Spotify, YouTube, X, publisher website, etc.) in the same response.

​
Inputs

FieldTypeRequiredDefaultDescription
querystringno—Free-text search across podcast titles and descriptions (case-insensitive partial match).
slugstringno—Exact slug match for a known handle (e.g. "all-in").
limitinteger (1–25)no5Maximum candidates to return.
include_external_linksbooleannofalseAlso fetch each result’s third-party platform presences — directories (Apple Podcasts, Spotify, …), social profiles (X, Instagram, …), video channels (YouTube), and the publisher’s website. Off by default; opt in only when the agent needs subscription/profile URLs or per-platform handles.

​
Output

A markdown document with ## Podcast matches (N) and one ### Title section per podcast. Each section carries **Slug:**, **Episodes:**, **Bias:** (when rated; values: EXTREME_LEFT, LEANS_LEFT, LEFT, CENTER, RIGHT, LEANS_RIGHT, EXTREME_RIGHT), **Language:** lines (only those with values), then a paragraph description, then a Top speakers: heading followed by up to 8 bullets — each formatted Name (entity_slug) — role (entity_slug omitted if not linked, role omitted if absent). When include_external_links=true and at least one platform resolved to a usable URL or identifier, an External links: line follows the speakers list with one bullet per platform, formatted Platform: <url> (or Platform: <identifier> when no URL is available — useful for handle-only platforms like X (Twitter): @hardfork). Platforms with neither a URL nor an identifier are skipped silently; if every platform for a podcast is skipped, the External links: header is omitted entirely. Sample (slug="all-in"): 
## Podcast matches (1)

### All-In with Chamath, Jason, Sacks & Friedberg

**Slug:** all-in
**Episodes:** 201
**Bias:** LEANS_RIGHT
**Language:** en
Industry veterans, degenerate gamblers & besties Chamath Palihapitiya, Jason Calacanis, David Sacks & David Friedberg cover all things economic, tech, political, social & poker.

Top speakers:
- Jason Calacanis (jason-calacanis) — HOST
- Chamath Palihapitiya (chamath-palihapitiya) — HOST
- David Friedberg (david-friedberg) — HOST
- David O. Sacks (david-o-sacks) — HOST
The string after **Slug:** is the podcast handle to feed back as podcast_slug to other tools. Each speaker bullet’s parenthesized (entity_slug) (when present) is the knowledge-graph handle for that person — feed it into podcasts/get_entity_mentions or podcasts/list_episodes to follow them across the catalog. Sample with external links (slug="hard-fork", include_external_links=true, abridged): 
## Podcast matches (1)

### Hard Fork

**Slug:** hard-fork
**Episodes:** 142
**Language:** en
…
External links:
- Apple Podcasts: https://podcasts.apple.com/hard-fork
- Spotify: https://open.spotify.com/show/hard-fork
- X (Twitter): @hardfork

​
Example

Agent calls: podcasts/resolve_podcast { "query": "all in" }
            → reads "Slug:" line → "all-in"

Agent calls: advertising/get_podcast_sponsors { "podcast_slug": "all-in" }
Pulling subscription URLs for a known podcast: 
Agent calls: podcasts/resolve_podcast {
  "slug": "hard-fork",
  "include_external_links": true
}
            → reads "External links:" bullets for each platform