Get post | beehiiv | Developer Documentation

1 import { BeehiivClient } from "beehiiv"; 2 3 const client = new BeehiivClient({ token: "YOUR_TOKEN" }); 4 await client.posts.get("post_00000000-0000-0000-0000-000000000000", "pub_00000000-0000-0000-0000-000000000000");

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

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

Headers

AuthorizationstringRequired

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

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.

Response

dataobject

Path parameters

Headers

Query parameters

Response

Errors