# 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`.

## 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

## 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`

## 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/<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