Skip to main content
GET
/
v1
/
podcasts
/
{id}
Get a podcast
curl --request GET \
  --url https://api.particle.pro/v1/podcasts/{id} \
  --header 'X-API-Key: <api-key>'
{
  "explicit": true,
  "id": "<string>",
  "title": "<string>",
  "bias": "<string>",
  "description": "<string>",
  "episode_count": 123,
  "image_url": "<string>",
  "language": "<string>",
  "political_context": "<string>",
  "slug": "<string>",
  "speakers": [
    {
      "name": "<string>",
      "company": {
        "id": "<string>",
        "domain": "<string>",
        "ticker": "<string>"
      },
      "entity_id": "<string>",
      "entity_slug": "<string>",
      "occurrences": 123,
      "person": {
        "id": "<string>",
        "company": "<string>",
        "image_url": "<string>",
        "title": "<string>"
      },
      "role": "<string>"
    }
  ],
  "topics": [
    {
      "id": "<string>",
      "name": "<string>",
      "slug": "<string>",
      "ancestry": "<string>",
      "ancestry_path": "<string>",
      "episode_count": 123
    }
  ],
  "url": "<string>"
}

Authorizations

X-API-Key
string
header
required

Pass your API key in the X-API-Key header (recommended).

Path Parameters

id
string
required

Podcast slug (e.g., 'all-in', 'lex-fridman-podcast') or ID

Query Parameters

topic_limit
integer<int64>
default:10

Maximum number of aggregated topics to return (0 for none, max 1000)

Required range: 0 <= x <= 1000

Response

OK

explicit
boolean
required

Whether the podcast contains explicit content

id
string
required

Unique identifier

title
string
required

Podcast title

bias
string

Political bias rating for the podcast: EXTREME_LEFT, LEANS_LEFT, LEFT, CENTER, RIGHT, LEANS_RIGHT, or EXTREME_RIGHT. Empty when the podcast is not substantively political or has not been evaluated yet. Fetch GET /v1/podcasts/{id}/bias for the full analysis including reasoning and evidence.

description
string

Podcast description

episode_count
integer<int64>

Total number of episodes

image_url
string

Cover image URL

language
string

ISO 639-1 language code

political_context
string

Political framework the bias rating is calibrated against: US, UK, EU, CANADA, AUSTRALIA, INDIA, OTHER. Omitted when the latest analysis returned NOT_POLITICAL or when no analysis has been run yet.

slug
string

URL-friendly identifier

speakers
object[] | null

Top recurring speakers

topics
object[] | null

Top topics discussed across episodes, ordered by frequency

url
string

RSS feed URL