beehiiv Developer Documentation

1 import requests 2 3 url = "https://api.beehiiv.com/v2/publications/pub_00000000-0000-0000-0000-000000000000/posts/post_00000000-0000-0000-0000-000000000000" 4 5 headers = {"Authorization": "Bearer <token>"} 6 7 response = requests.get(url, headers=headers) 8 9 print(response.json())

1 { 2 "data": { 3 "id": "post_00000000-0000-0000-0000-000000000000", 4 "subtitle": "New post subtitle", 5 "title": "New Post Title", 6 "authors": [ 7 "Clark Kent" 8 ], 9 "created": 1666800076, 10 "status": "draft", 11 "split_tested": true, 12 "subject_line": "Check this out", 13 "preview_text": "More news on the horizon", 14 "slug": "slug", 15 "thumbnail_url": "thumbnail_url", 16 "web_url": "web_url", 17 "audience": "free", 18 "platform": "web", 19 "content_tags": [ 20 "content_tags" 21 ], 22 "hidden_from_feed": true, 23 "publish_date": 1666800076, 24 "displayed_date": 1666800076, 25 "meta_default_description": "A post with great content", 26 "meta_default_title": "My great post", 27 "content": { 28 "free": { 29 "web": "<HTML><body><h1>New Post</h1></body></HTML>", 30 "email": "<HTML><body><h1>New Post</h1></body></HTML>", 31 "rss": "<HTML><body><h1>New Post</h1></body></HTML>" 32 }, 33 "premium": { 34 "web": "<HTML><body><h1>New Post</h1></body></HTML>", 35 "email": "<HTML><body><h1>New Post</h1></body></HTML>" 36 } 37 }, 38 "stats": { 39 "email": { 40 "recipients": 100, 41 "delivered": 100, 42 "opens": 50, 43 "unique_opens": 45, 44 "clicks": 10, 45 "unique_clicks": 8, 46 "unsubscribes": 1, 47 "spam_reports": 1 48 }, 49 "web": { 50 "views": 200, 51 "clicks": 40 52 }, 53 "clicks": [ 54 { 55 "total_clicks": 10, 56 "total_unique_clicks": 8, 57 "total_click_through_rate": 30 58 } 59 ] 60 } 61 } 62 }

Retreive a single Post belonging to a specific publication

Authentication

AuthorizationBearer

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

Path parameters

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

The prefixed ID of the post object

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

The prefixed ID of the publication object

Query parameters

expandlist of enumsOptional

Optionally expand the results by adding additional information.
stats - Adds statistics about the post(s).
free_web_content - Adds the web HTML rendered to a free reader.
free_email_content - Adds the email HTML rendered to a free reader.
free_rss_content - Adds the RSS feed HTML.
premium_web_content - Adds the web HTML rendered to a premium reader.
premium_email_content - Adds the email HTML rendered to a premium reader.

Optionally expand the results by adding additional information. <br>`stats` - Adds statistics about the post(s). <br>`free_web_content` - Adds the web HTML rendered to a free reader. <br>`free_email_content` - Adds the email HTML rendered to a free reader. <br>`free_rss_content` - Adds the RSS feed HTML. <br>`premium_web_content` - Adds the web HTML rendered to a premium reader. <br>`premium_email_content` - Adds the email HTML rendered to a premium reader.

premium_tierslist of stringsOptional

Scope any expanded content output to the specified premium tiers.
This takes in an array of Display Names of the premium tiers.
Note: This is case insensitive.

Response

dataobject

Get post

Authentication

Path parameters

Query parameters

Response

Errors