Get post

GET

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

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

Errors

GET

1 curl https://api.beehiiv.com/v2/publications/pub_00000000-0000-0000-0000-000000000000/posts/post_00000000-0000-0000-0000-000000000000 \
2      -H "Authorization: Bearer <token>"

200Retrieved

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 }

Built with

1	curl https://api.beehiiv.com/v2/publications/pub_00000000-0000-0000-0000-000000000000/posts/post_00000000-0000-0000-0000-000000000000 \
2	-H "Authorization: Bearer <token>"

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	}