# Podchaser REST API

> The world’s largest podcast database, available through a single API. Millions of podcasts and hundreds of millions of episodes — search them, enrich your data with them, monitor them at scale, and surface the audience and creator signals that power smarter decisions across media monitoring, competitive intelligence, and podcast analytics.

- Version: 1.0.0
- Base URL: https://developers.podchaser.com
- Authentication: send your Podchaser API key in the `x-api-key` request header on every call. Get a key at https://www.podchaser.com/profile/settings/api/api-settings

This file follows the llmstxt.org convention so AI assistants and RAG pipelines can discover the canonical machine-readable documentation.

## Specification

- [OpenAPI 3 (JSON)](https://developers.podchaser.com/api/rest/v1/openapi.json): canonical machine-readable spec.
- [OpenAPI 3 (YAML)](https://developers.podchaser.com/api/rest/v1/openapi.yaml): same document, YAML serialisation.

## Full reference

- [Complete API reference (Markdown)](https://developers.podchaser.com/llms-full.txt): full endpoint documentation optimized for LLM consumption.

## Interactive docs

- [Scalar API Reference](https://developers.podchaser.com/api/rest/v1/docs): browser-rendered reference UI.

## AI tools (MCP)

- [MCP server](https://developers.podchaser.com/mcp): connect Podchaser data directly to AI assistants via the Model Context Protocol.
- [Setup guide](https://support.podchaser.com/en/articles/15901951-podchaser-mcp-server-for-rest-api): how to connect the MCP server.

## Endpoints

### Search

- `GET /api/rest/v1/search/podcasts` — Search podcasts
- `GET /api/rest/v1/search/episodes` — Search episodes
- `GET /api/rest/v1/search/transcripts` — Search transcripts
- `GET /api/rest/v1/search/networks` — Search networks
- `GET /api/rest/v1/search/creators` — Search creators
- `GET /api/rest/v1/search/sponsors` — Search sponsors

### Podcasts

- `GET /api/rest/v1/podcasts/{id}` — Get a podcast by ID
- `GET /api/rest/v1/podcasts/{id}/reach` — Get podcast reach data
- `GET /api/rest/v1/podcasts/{id}/episodes` — List episodes for a podcast
- `GET /api/rest/v1/podcasts/{id}/charts` — Get podcast chart positions
- `GET /api/rest/v1/podcasts/{id}/credits` — Get podcast credits
- `GET /api/rest/v1/podcasts/{id}/demographics` — Get podcast demographics
- `GET /api/rest/v1/podcasts/{id}/brandsafety` — Get podcast brand safety
- `GET /api/rest/v1/podcasts/{id}/network` — Get podcast network(s)
- `GET /api/rest/v1/podcasts/{id}/similar` — Get similar podcasts
- `GET /api/rest/v1/podcasts/{id}/contacts` — Get podcast contacts
- `GET /api/rest/v1/podcasts/{id}/socials` — Get podcast socials
- `GET /api/rest/v1/podcasts/{id}/sponsors/{brand_id}/episodes` — Get episodes sponsored by a specific brand on this podcast
- `GET /api/rest/v1/podcasts/{id}/sponsors` — Get podcast sponsors

### Episodes

- `GET /api/rest/v1/episodes/{id}` — Get an episode by ID
- `GET /api/rest/v1/episodes/{id}/reach` — Get episode reach data
- `GET /api/rest/v1/episodes/{id}/credits` — Get episode credits
- `GET /api/rest/v1/episodes/{id}/brandsafety` — Get episode brand safety
- `GET /api/rest/v1/episodes/{id}/transcript` — Get episode transcript

### Creators

- `GET /api/rest/v1/creators/{pcid}` — Get a creator by Podchaser ID
- `GET /api/rest/v1/creators/{pcid}/podcasts` — Get podcasts a creator is credited on
- `GET /api/rest/v1/creators/{pcid}/episodes` — Get episode credits for a creator

### Networks

- `GET /api/rest/v1/networks/{id}` — Get a network by ID
- `GET /api/rest/v1/networks/{id}/insights` — Get aggregate insights for a network
- `GET /api/rest/v1/networks/{id}/podcasts` — Get podcasts in a network

### Sponsors

- `GET /api/rest/v1/sponsors/{id}` — Get sponsor metadata
- `GET /api/rest/v1/sponsors/{id}/podcasts` — Get podcasts sponsored by a brand
- `GET /api/rest/v1/sponsors/{id}/episodes` — Get episodes sponsored by a brand

### Charts

- `GET /api/rest/v1/charts` — Get global podcast charts

### Reference

- `GET /api/rest/v1/reference` — Get Podchaser reference data by resource
- `GET /api/rest/v1/reference/categories` — Get the list of podcast categories
- `GET /api/rest/v1/reference/languages` — Get the list of languages
- `GET /api/rest/v1/reference/demographics` — Get the valid demographic filter values
- `GET /api/rest/v1/reference/charts` — Get chart platforms and category slugs
- `GET /api/rest/v1/reference/brandsafety` — Get brand safety risk codes

### Usage

- `GET /api/rest/v1/usage` — Get current request usage

### System

- `GET /health/live` — Liveness probe
- `GET /health/ready` — Readiness probe
- `GET /health` — Health (backwards-compatible alias)