Get private feed by email OAuth Scope: podcasts:read

GET

https://api.beehiiv.com/v2/publications/:publicationId/podcasts/:podcastShowId/private_feeds/by_email/:email

GET

/v2/publications/:publicationId/podcasts/:podcastShowId/private_feeds/by_email/:email

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

1 {
2   "data": {
3     "id": "pod_feed_00000000-0000-0000-0000-000000000000",
4     "url": "https://rss.beehiiv.com/podcasts/00000000-0000-0000-0000-000000000000/private/token.xml",
5     "protocol_links": {
6       "apple": "podcast://rss.beehiiv.com/podcasts/00000000-0000-0000-0000-000000000000/private/token.xml",
7       "castro": "castro://subscribe/https%3A%2F%2Frss.beehiiv.com%2Fpodcasts%2F00000000-0000-0000-0000-000000000000%2Fprivate%2Ftoken.xml",
8       "overcast": "overcast://x-callback-url/add?url=https%3A%2F%2Frss.beehiiv.com%2Fpodcasts%2F00000000-0000-0000-0000-000000000000%2Fprivate%2Ftoken.xml",
9       "pocket_casts": "pktc://subscribe/rss.beehiiv.com/podcasts/00000000-0000-0000-0000-000000000000/private/token.xml"
10     },
11     "created": 1666800076,
12     "subscription": {
13       "id": "sub_00000000-0000-0000-0000-000000000000",
14       "email": "[email protected]",
15       "status": "active",
16       "created": 1666800076,
17       "subscription_tier": "premium",
18       "subscription_premium_tier_names": [
19         "Premium"
20       ],
21       "utm_source": "Twitter",
22       "utm_medium": "organic",
23       "utm_channel": "website",
24       "utm_campaign": "utm_campaign",
25       "utm_term": "",
26       "utm_content": "",
27       "referring_site": "https://www.blog.com",
28       "referral_code": "referral_code",
29       "custom_fields": [
30         {
31           "name": "First Name",
32           "kind": "string",
33           "value": "Bruce"
34         }
35       ],
36       "tags": [
37         "VIP"
38       ],
39       "newsletter_list_ids": [
40         "nl_list_00000000-0000-0000-0000-000000000000"
41       ]
42     },
43     "show": {
44       "id": "pod_00000000-0000-0000-0000-000000000000",
45       "created": 1712534400,
46       "slug": "morning_brief",
47       "description": "Daily news for builders.",
48       "categories": [
49         "News"
50       ],
51       "artwork_url": "https://media.beehiiv.com/cdn-cgi/image/fit=scale-down,format=auto,onerror=redirect,quality=80/uploads/asset/file/artwork.png",
52       "status": "live",
53       "language": "en",
54       "title": "Morning Brief",
55       "author": "Jane Doe",
56       "type": "episodic",
57       "imported": false,
58       "copyright": "Jane Doe",
59       "explicit": false,
60       "publishing_frequency": 7,
61       "website_url": "https://example.com"
62     },
63     "activated": 1666800076,
64     "revoked": null,
65     "expires": null
66   }
67 }

Retrieve a subscription’s private RSS feed for a podcast by email address. The email path parameter must be URL-encoded. The payload matches the data property of podcasts.private_feed webhooks. Returns 422 when the podcast is fully public. Spotify Open Access links are not included.

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

emailstringRequired

The URL-encoded email address of the subscription

Response

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error