Method Details
HTTP Methods:
GET
Response Format:
json
Requires Authentication?
Yes
Rate Limited?
Headers
Products:
Marketing
Get a specific blog post by ID
There's a new version of the HubSpot API
As of November 30, 2022, HubSpot API Keys are being deprecated and are no longer supported. Continued use of HubSpot API Keys is a security risk to your account and data. Your API Keys could be deactivated at any time after Nov. 30th, and we recommend that you migrate to Private Apps as soon as possible so you do not lose business-critical functionality.
HTTP Methods:
GET
Response Format:
json
Requires Authentication?
Yes
Rate Limited?
Headers
Products:
Marketing
Get a specific blog post by ID
Required Parameters | How to use | Description |
---|---|---|
OAuth Access Token or API Key | Authorization: Bearer {token} header or hapikey={key} query parameter. |
Used to authenticate the request. Please see this page for more details about authentication. |
blog_post_id | Used in the request URL | Unique identifier for a particular blog |
Hit this URL with a HTTP method of GET https://api.hubapi.com/content/api/v2/blog-posts/5574003719?hapikey=demo
Parameter name | Type | Description |
---|---|---|
archived_at | long | When the post was deleted, in milliseconds since the epoch. Zero if the blog post was never deleted. Use a DELETE request to delete the post, do not set this directly. |
archivedInDashboard | bool | If True, the post will not show up in your dashboard, although the post will still be live |
blog_author_id | long | The integer id of the blog author, look up via the blog authors end point /content/api/v2/blog-authors |
campaign | string | The guid of the marketing campaign this post is associated with |
campaign_name | string | The name of the marketing campaign this post is associated with |
content_group_id | long | The id of the blog that this post belongs to. Get the id by looking at the blog API endpoint /content/api/v2/blogs |
created | long | When the post was first created, in milliseconds since the epoch |
footer_html | string | Custom HTML for embed codes, javascript that should be placed before the </body> tag of the page |
head_html | string | Custom HTML for embed codes, javascript, etc. that goes in the <head> tag of the page |
is_draft | string | True if the post is still a draft, invisible to the public. Gets changed when the /publish-action API endpoint is called |
keywords | list | A JSON list of keywords and their GUIDs. This list contains key value pairs of "keyword" and "keyword_guid". For example:
|
meta_description | string | A description that goes in <meta> tag on the page |
name | string | The internal name of the blog post |
post_body | string | The HTML of the main post body |
post_summary | string | The summary of the blog post that will appear on the main listing page |
publish_date | long | The date the blog post is to be published at in milliseconds since the unix epoch. |
publish_immediately | string | Set this to true if you want to be published immediately when the schedule publish endpoint is called, and to ignore the publish_date setting |
slug | string | The path of the URL on which the post will live. Changing this will change the URL. |
topic_ids | list | A json list of topic ids from the topics API ( /content/api/v2/topics ) |
updated | long | When the post was last updated, in milliseconds since the epoch |
url | string | The full URL with domain and scheme to the blog post. Will return a 404 if the post is not yet published. |
widgets | string | A data structure containing the data for all the modules for this post. This will only be populated if the blog template has editable widgets defined. |
2-nd line
", "rss_summary": " ", "blog_publish_to_social_media_task": "DONE", "blog_post_schedule_task_uid": null }, "meta_description": "seo optimization", "name": "Test Blog", "page_redirected": false, "page_title": "Test Blog", "parent_blog": { "absolute_url": "http://demo-hubapi.hs-sites.com/tb-es", "allow_comments": true, "amp_body_color": "#404040", "amp_body_font": "'Helvetica Neue', Helvetica, Arial, sans-serif", "amp_body_font_size": "18", "amp_custom_css": "", "amp_header_background_color": "#ffffff", "amp_header_color": "#1e1e1e", "amp_header_font": "'Helvetica Neue', Helvetica, Arial, sans-serif", "amp_header_font_size": "36", "amp_link_color": "#416bb3", "amp_logo_alt": "", "amp_logo_height": 0, "amp_logo_src": "", "amp_logo_width": 0, "analytics_page_id": 6513512292, "attached_stylesheets": [], "captcha_after_days": 7, "captcha_always": false, "category_id": 3, "close_comments_older": 0, "comment_date_format": "medium", "comment_form_guid": "d106e4ff-1bfa-4cee-bd7e-df2c3e64ae98", "comment_max_thread_depth": 1, "comment_moderation": false, "comment_notification_emails": [], "comment_should_create_contact": false, "comment_verification_text": "", "cos_object_type": "BLOG", "created": 1542117464711, "created_date_time": 1542117464711, "daily_notification_email_id": "6513456345", "default_group_style_id": "", "default_notification_from_name": "", "default_notification_reply_to": "", "deleted_at": 0, "description": "", "domain": "", "domain_when_published": "demo-hubapi.hs-sites.com", "email_api_subscription_id": 5479310, "enable_google_amp_output": true, "enable_social_auto_publishing": false, "html_footer": "", "html_footer_is_shared": true, "html_head": "", "html_head_is_shared": true, "html_keywords": [], "html_title": "", "id": 6513512292, "instant_notification_email_id": "6513512376", "item_layout_id": 6208194615, "item_template_is_shared": true, "item_template_path": "generated_layouts/6208194615.html", "label": "Blog - ES", "listing_layout_id": 6208194615, "listing_template_path": "generated_layouts/6208194615.html", "live_domain": "demo-hubapi.hs-sites.com", "month_filter_format": "MMMM yyyy", "monthly_notification_email_id": "6513512410", "name": "Blog - ES", "portal_id": 62515, "post_html_footer": "", "post_html_head": "", "posts_per_listing_page": 10, "posts_per_rss_feed": 10, "public_access_rules": [], "public_access_rules_enabled": false, "public_title": "Blog - ES", "publish_date_format": "medium", "resolved_domain": "demo-hubapi.hs-sites.com", "root_url": "http://demo-hubapi.hs-sites.com/tb-es", "show_social_link_facebook": true, "show_social_link_google_plus": true, "show_social_link_linkedin": true, "show_social_link_twitter": true, "show_summary_in_emails": true, "show_summary_in_listing": true, "show_summary_in_rss": true, "slug": "tb-es", "social_account_twitter": "", "subscription_contacts_property": "blog_blog_es_6513512292_subscription", "subscription_form_guid": "ef80b56c-739f-4c3e-b008-e71f587cd5b6", "subscription_lists_by_type": { "daily": 483082, "instant": 483081, "monthly": 483084, "weekly": 483083 }, "updated": 1545412176504, "updated_date_time": 1545412176504, "url_base": "demo-hubapi.hs-sites.com/tb-es", "url_segments": { "all": "all", "archive": "archive", "author": "author", "page": "page", "tag": "tag" }, "use_featured_image_in_summary": true, "uses_default_template": false }, "past_mab_experiment_ids": [], "personas": [], "placement_guids": [], "portal_id": 62515, "post_body": "", "post_body_rss": "", "post_email_content": "", "post_list_summary_featured_image": "https://cdn2.hubspot.net/hubfs/62515/piglet.jpg", "post_rss_content": "", "post_template": "generated_layouts/6208194615.html", "preview_key": "ENbQvoGy", "processing_status": "PUBLISHED", "public_access_rules": [], "public_access_rules_enabled": false, "publish_date": 1545651277000, "publish_date_local_time": 1545651277000, "publish_date_localized": { "date": 1545651277000, "format": "medium" }, "publish_immediately": true, "published_at": 1550838546935, "published_by_email": "testapi@hubspot.com", "published_by_id": 215482, "published_by_name": "Puika Ti", "published_url": "http://demo-hubapi.hs-sites.com/tb-es/test-blog", "resolved_domain": "demo-hubapi.hs-sites.com", "rss_body": "", "rss_summary_featured_image": "https://cdn2.hubspot.net/hubfs/62515/piglet.jpg", "slug": "tb-es/test-blog", "state": "PUBLISHED", "subcategory": "normal_blog_post", "synced_with_blog_root": true, "tag_ids": [], "tag_list": [], "tag_names": [], "team_perms": [], "template_path": "", "template_path_for_render": "generated_layouts/6208194615.html", "title": "Test Blog", "topic_ids": [], "topic_list": [], "topic_names": [], "topics": [], "translated_content": {}, "tweet_immediately": false, "unpublished_at": 0, "updated": 1550838546938, "updated_by_id": 215482, "upsize_featured_image": false, "url": "http://demo-hubapi.hs-sites.com/tb-es/test-blog", "use_featured_image": true, "user_perms": [], "widget_containers": {}, "widgetcontainers": {}, "widgets": { "module_154220444615754": { "body": { "html": "
The headline and subheader tells us what you're offering, and the form header closes the deal. Over here you can explain why your offer is so great it's worth filling out a form for.
Remember: