llms.txt Content
# Rephonic API
> Comprehensive podcast data API with search, metadata, full transcripts, listener demographics, audience intelligence, and contact information for 4m+ podcasts.
Rephonic provides a REST API for accessing structured podcast data. The API is designed for integration with your apps and AI agents.
We also provide this as an MCP server at `https://mcp.rephonic.com`, and as an official Python SDK and `rephonic` CLI (`pip install rephonic`).
## Documentation
- [Complete API Reference (Markdown)](/llms-full.txt): Full endpoint documentation optimized for LLM consumption
- [Developer Portal](/developers): Human-readable API documentation with example responses
- [Python Client on GitHub](https://github.com/getrephonic/rephonic-python): Official Python SDK and `rephonic` CLI. Typed wrapper around every endpoint, sync and async. `pip install rephonic` (or `pipx install rephonic` for CLI-only use).
## Authentication
All endpoints require the `X-Rephonic-Api-Key` header containing your API key (found on your account page at rephonic.com/account).
You will need an Rephonic API subscription (see rephonic.com/developers).
Base URL: `https://api.rephonic.com`
## Finding a podcast's Rephonic ID
Rephonic has its own internal ID (a slug like `huberman-lab`) for every podcast. To get it, either:
- Search by topic/title/publisher via `GET /api/search/podcasts/`, or
- **Resolve directly from an external identifier** (Apple/iTunes ID, Spotify ID, YouTube channel ID, or RSS feed URL) via `GET /api/podcasts/lookup/`.
If you already have one of those external identifiers, use lookup — you do not need to search first.
## Available Endpoints
- `GET /api/search/podcasts/` - Search podcasts by topic, title, or publisher with advanced filters
- `GET /api/search/episodes/` - Search episodes across titles, show notes, and full transcripts
- `GET /api/search/autocomplete/` - Autocomplete suggestions for search
- `GET /api/podcasts/lookup/` - Resolve a podcast from an