List podcasts OAuth Scope: podcasts:read

GET

https://api.beehiiv.com/v2/publications/:publicationId/podcasts

GET

/v2/publications/:publicationId/podcasts

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

1 {
2   "data": [
3     {
4       "id": "pod_00000000-0000-0000-0000-000000000000",
5       "created": 1712534400,
6       "slug": "morning_brief",
7       "description": "Daily news for builders.",
8       "categories": [
9         "News"
10       ],
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": "live",
13       "language": "en",
14       "title": "Morning Brief",
15       "author": "Jane Doe",
16       "type": "episodic",
17       "imported": false,
18       "copyright": "Jane Doe",
19       "explicit": false,
20       "publishing_frequency": 7,
21       "website_url": "https://example.com",
22       "platform_links": {
23         "apple": "https://podcasts.apple.com/us/podcast/example-show/id1234567890",
24         "spotify": "https://open.spotify.com/show/1234567890abcdefghijklmn",
25         "youtube": null,
26         "pocket_casts": null,
27         "overcast": null,
28         "castro": null,
29         "iheart_radio": null,
30         "amazon_music": null,
31         "tunein": null
32       }
33     }
34   ],
35   "limit": 10,
36   "has_more": false,
37   "next_cursor": null
38 }

Retrieve all podcasts belonging to a specific publication.

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

Query parameters

limitintegerOptional

A limit on the number of objects to be returned. The limit can range between 1 and 100, and the default is 10.

cursorstringOptional

Cursor-based pagination (recommended): Use this opaque cursor token to fetch the next page of results. Obtain the value from next_cursor in a previous response.

pageintegerOptional

Offset-based pagination (deprecated): Page number for offset-based pagination. Please migrate to cursor-based pagination using the cursor parameter.

statusenumOptional

Optionally filter the results by the status of the podcast.
draft - No episodes have been published.
live - Published and active.
archived - The podcast is no longer active.

Allowed values:

Response

datalist of objects

A list of podcasts for this publication.

limitintegerOptional

The limit placed on the results. If no limit was specified in the request, this defaults to 10.

pageintegerOptional>=0Defaults to 1

Offset pagination only: The page number the results are from. Only present when using deprecated offset-based pagination.

total_pagesintegerOptional

Offset pagination only: The total number of pages. Only present when using deprecated offset-based pagination.

has_morebooleanOptional

Cursor pagination only: Indicates whether there are more results available after the current page. Only present when using cursor-based pagination.

next_cursorstringOptional

Cursor pagination only: The cursor token to use for fetching the next page of results. Null when has_more is false. Only present when using cursor-based pagination.

total_resultsintegerOptional

The total number of results from all pages.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error