# Podcasts API
> Search the Apple podcast directory, fetch podcast details (artwork, genre, feed, episode count) and full episode lists with audio URLs, durations and publish dates — by resolving each show's RSS feed. Great for podcast players, discovery and analytics.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/podcasts-api/..."
```

## Pricing
- **Free** (Free) — 1,500 calls/Mo, 2 req/s
- **Basic** ($12/Mo) — 40,000 calls/Mo, 8 req/s
- **Pro** ($55/Mo) — 220,000 calls/Mo, 25 req/s
- **Mega** ($129/Mo) — 750,000 calls/Mo, 60 req/s

## Endpoints

### Podcasts

#### `GET /v1/episodes` — Episode list

**Parameters:**
- `id` (query, required, string) — Numeric podcast id Example: `1200361736`
- `limit` (query, optional, string) — Max 1-100 Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/podcasts-api/v1/episodes?id=1200361736&limit=25"
```

**Response:**
```json
{
    "data": {
        "name": "The Daily",
        "count": 25,
        "episodes": [
            {
                "guid": "f032450b-2f81-4b6a-bd18-b6d8823073f5",
                "link": "https://www.nytimes.com/the-daily",
                "title": "Stranded in the Strait of Hormuz",
                "summary": "While the United States and Iran have each signaled that they may be making progress toward a peace deal, the Strait of Hormuz remains closed. Thousands of crew members have been stranded in the shipping channel since the war broke out three months ago. Two seafarers who got stuck in the strait explain what it is like to be trapped in a war zone, and what it would mean to get everyone out. Guest: Capt. Virendra Vishwakarma, who managed to leave the Strait of Hormuz, and Aung Thu Khant, a seafarer who is still stuck. Background reading: Read the latest updates on the war in Iran. Thousands of civilian sailors have been stranded in waters surrounded by a conflict zone because of the war. Photo: Reuters For more information on today’s episode, visit nytimes.com/thedaily. Transcripts of each episode will be made available by the next workday. Subscribe today at nytimes.com/podcasts or on Apple Podcasts and Spotify. You can also subscribe via your favorite podcast app here https://www.nytimes.com/activate-access/audio?source=podcatcher. For more podcasts and narrated articles, download The New York Times app at nytimes.com/app. Hosted by Simplecast, an AdsWizz company.
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/lookup` — Podcast details by id

**Parameters:**
- `id` (query, required, string) — Numeric podcast id Example: `1200361736`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/podcasts-api/v1/lookup?id=1200361736"
```

**Response:**
```json
{
    "data": {
        "id": 1200361736,
        "url": "https://podcasts.apple.com/us/podcast/the-daily/id1200361736?uo=4",
        "feed": "https://feeds.simplecast.com/Sl5CSM3S",
        "name": "The Daily",
        "genre": "Daily News",
        "artist": "The New York Times",
        "genres": [
            "Daily News",
            "Podcasts",
            "News"
        ],
        "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts221/v4/ab/64/66/ab6466a9-9a7d-e20e-7a3d-bc5be37d29ce/mza_15084852813176276273.jpg/600x600bb.jpg",
        "country": "USA",
        "released": "2026-05-28T09:49:00Z",
        "episode_count": 2615
    },
    "meta": {
        "timestamp": "2026-05-30T02:47:55.763Z",
        "request_id": "cde96426-08a9-4b54-b6ba-d150b36cbcb3"
    },
    "status": "ok",
    "message": "Podcast retrieved successfully",
    "success": true
}
```

#### `GET /v1/search` — Search podcasts

**Parameters:**
- `q` (query, required, string) — Search term Example: `technology`
- `limit` (query, optional, string) — Max 1-50 Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/podcasts-api/v1/search?q=technology&limit=20"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "query": "technology",
        "podcasts": [
            {
                "id": 470624027,
                "url": "https://podcasts.apple.com/us/podcast/ted-tech/id470624027?uo=4",
                "feed": "https://feeds.acast.com/public/shows/67585c62102e6d4448d44969",
                "name": "TED Tech",
                "genre": "Technology",
                "artist": "TED Tech",
                "genres": [
                    "Technology",
                    "Podcasts"
                ],
                "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts126/v4/d9/32/32/d932328a-a21d-999c-690c-f05d680778b2/mza_13752174967843677920.jpg/600x600bb.jpg",
                "country": "USA",
                "released": "2026-05-29T04:00:00Z",
                "episode_count": 268
            },
            {
                "id": 1235836821,
                "url": "https://podcasts.apple.com/us/podcast/the-future-of-everything/id1235836821?uo=4",
                "feed": "https://feeds.simplecast.com/Y8_HoeNW",
                "name": "The Future of Everything",
                "genre": "Science",
                "artist": "Stanford Engineering",
                "genres": [
                    "Science",
                    "Podcasts",
                    "Technology"
                ],
                "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts125/v4/ce/00/b9/ce00b95d-6a13-587f-417b-c750ec0a432c/mza_75246703286
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/podcasts-api
OpenAPI spec: https://www.oanor.com/api/podcasts-api/openapi.json