# Rephonic API

> Comprehensive podcast data API with search, metadata, full transcripts, listener demographics, audience intelligence, and contact information for 3m+ 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 Apple/iTunes ID, Spotify ID, YouTube channel ID, or RSS feed URL
- `GET /api/podcasts/<id>/` - Get podcast metadata, rankings, and latest episodes
- `GET /api/podcasts/<id>/people/` - Get hosts and guests with contact information
- `GET /api/podcasts/<id>/demographics/` - Get listener demographics (age, income, location, interests)
- `GET /api/podcasts/<id>/promotions/` - Get sponsors and cross-promotions with full ad reads
- `GET /api/episodes/` - List all episodes for a podcast
- `GET /api/episodes/<id>/` - Get episode metadata including topics, guests, memorable moments
- `GET /api/episodes/<id>/transcript/` - Get full episode transcript with speaker identification
- `GET /api/contacts/` - Get podcast contact information (emails, social accounts)
- `GET /api/social/accounts/` - Get social media accounts and metrics
- `GET /api/feedback/` - Get ratings and review summaries
- `GET /api/reviews/` - Get individual listener reviews
- `GET /api/trends/` - Get historical metrics trends
- `GET /api/similar/graph/` - Get shared audience graph data
- `GET /api/charts/<platform>/` - List chart categories and countries (Apple, Spotify, YouTube)
- `GET /api/charts/<platform>/<country>/<category>/` - Get chart rankings
- `GET /api/common/categories/` - List podcast categories (for search filters)
- `GET /api/common/countries/` - List countries (for search filters)
- `GET /api/common/languages/` - List languages (for search filters)
- `GET /api/common/sponsors/?query=abc` - Search commonly seen sponsors
- `GET /api/common/professions/?query=abc` - Search listener professions
- `GET /api/common/interests/?query=abc` - Search listener interests
- `GET /api/accounts/quota/` - Check API quota usage