Get podcast episode OAuth Scope: podcasts:read

GET

https://api.beehiiv.com/v2/publications/:publicationId/podcasts/:podcastShowId/episodes/:podcastEpisodeId

GET

/v2/publications/:publicationId/podcasts/:podcastShowId/episodes/:podcastEpisodeId

$ curl https://api.beehiiv.com/v2/publications/pub_00000000-0000-0000-0000-000000000000/podcasts/pod_00000000-0000-0000-0000-000000000000/episodes/pod_ep_00000000-0000-0000-0000-000000000000 \
>      -H "Authorization: Bearer <token>"

1 {
2   "data": {
3     "id": "pod_ep_00000000-0000-0000-0000-000000000000",
4     "created": 1712534400,
5     "updated": 1712620800,
6     "title": "Opening Bell",
7     "slug": "opening_bell",
8     "displayed_date": 1712620800,
9     "description": "Markets open with a look at overnight moves.",
10     "show_notes": "<p>Markets open with a look at overnight moves.</p>",
11     "artwork_url": "https://media.beehiiv.com/cdn-cgi/image/fit=scale-down,format=auto,onerror=redirect,quality=80/uploads/asset/file/artwork.png",
12     "status": "published",
13     "show": {
14       "id": "pod_00000000-0000-0000-0000-000000000000",
15       "created": 1712534400,
16       "slug": "morning_brief",
17       "description": "Daily news for builders.",
18       "categories": [
19         "News"
20       ],
21       "artwork_url": "https://media.beehiiv.com/cdn-cgi/image/fit=scale-down,format=auto,onerror=redirect,quality=80/uploads/asset/file/artwork.png",
22       "status": "live",
23       "language": "en",
24       "title": "Morning Brief",
25       "author": "Jane Doe",
26       "type": "episodic",
27       "imported": false,
28       "copyright": "Jane Doe",
29       "explicit": false,
30       "publishing_frequency": 7,
31       "website_url": "https://example.com",
32       "platform_links": {
33         "apple": "https://podcasts.apple.com/us/podcast/example-show/id1234567890",
34         "spotify": "https://open.spotify.com/show/1234567890abcdefghijklmn",
35         "youtube": null,
36         "pocket_casts": null,
37         "overcast": null,
38         "castro": null,
39         "iheart_radio": null,
40         "amazon_music": null,
41         "tunein": null
42       }
43     },
44     "publish_date": 1712620800,
45     "duration": 1800,
46     "season_number": 1,
47     "episode_number": 12,
48     "audio_url": "https://podcasts.beehiiv.com/audio/example.mp3",
49     "transcript_url": "https://rss.beehiiv.com/podcasts/transcriptions/00000000-0000-0000-0000-000000000000.vtt"
50   }
51 }

Retrieve a single episode belonging to a specific podcast.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

publicationIdstringRequiredformat: "^(pub_[0-9a-fA-F\-]+)$"

The prefixed ID of the publication object

podcastShowIdstringRequiredformat: "^(pod_[0-9a-fA-F\-]+)$"

The prefixed ID of the podcast

podcastEpisodeIdstringRequiredformat: "^(pod_ep_[0-9a-fA-F\-]+)$"

The prefixed ID of the episode

Response

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error