Blog API Methods

Get Information about a Specific Blog Post

GET  /blog/v1/posts/:post_guid.:ext

For a specific blog post, identified by its GUID, list information.

Required Parameters How to use Description
Post GUID Used in the request URL Unique identifier for a particular blog post you want to get information about.
HubSpot OAuth Access Token access_token=X - Used in the request URL The HubSpot API key for the portal that you're making the call for.
Optional Parameters How to use Description
None None No optional parameters for this method.

Example URL requesting JSON:  https://api.hubapi.com/blog/v1/posts/ae15391a-7bd9-454d-b51b-5c480a010497.json?access_token=demooooo-oooo-oooo-oooo-oooooooooooo

Example JSON output:

        [
            {
                "authorDisplayName": "testapi@hubspot.com",
                "authorEmail": "testapi@hubspot.com",
                "blogGuid": "0d61e4ca-e395-4c1c-8766-afaa48bf68db",
                "body": "updated content",
                "createTimestamp": 1322610342000,
                "draft": false,
                "guid": "ae15391a-7bd9-454d-b51b-5c480a010497",
                "jsonUrl": "https://api.hubapi.com/blog/v1/posts/ae15391a-7bd9-454d-b51b-5c480a010497.json",
                "lastUpdateTimestamp": 1322610342000,
                "metaDescription": "",
                "metaKeywords": "",
                "portalId": 62515,
                "postAnalytics": {
                    "comments": 1,
                    "inboundLinks": 0,
                    "views": 0
                },
                "publishTimestamp": 1322602086000,
                "sendNotifications": false,
                "summary": "updated summary",
                "tags": [
                    "hapihp updated tag 2",
                    "hapihp updated tag 1"
                ],
                "title": "new improves Updated title",
                "url": "http://demo.hubapi.com/blog-for-testing/bid/80149/"
            }
        ]
    

Example URL requesting AtomPub:  https://api.hubapi.com/blog/v1/posts/ae15391a-7bd9-454d-b51b-5c480a010497.atom?access_token=demooooo-oooo-oooo-oooo-oooooooooooo

Example AtomPub Output:

        <feed xmlns="http://www.w3.org/2005/Atom">
            <id>0d61e4ca-e395-4c1c-8766-afaa48bf68db</id>
            <title type="text">Test Blog (content from customers.hubspot.com)</title>
            <entry xmlns:hs="http://www.hubspot.com/">
                <id>ae15391a-7bd9-454d-b51b-5c480a010497</id>
                <title type="text">new improves Updated title</title>
                <summary type="text">updated summary</summary>
                <content type="html">updated content</content>
                <author>
                    <name>testapi@hubspot.com</name>
                    <email>testapi@hubspot.com</email>
                </author>
                <link href="http://demo.hubapi.com/blog-for-testing/bid/80149/"/>
                <updated>2011-11-29T23:45:42.000Z</updated>
                <published>2011-11-29T21:28:06.000Z</published>
                <hs:portalId>62515</hs:portalId>
                <hs:blogGuid>0d61e4ca-e395-4c1c-8766-afaa48bf68db</hs:blogGuid>
                <hs:metaDescription/>
                <hs:metaKeywords/>
                <hs:draft>false</hs:draft>
                <hs:sendNotifications>false</hs:sendNotifications>
                <category term="hapihp updated tag 2"/>
                <category term="hapihp updated tag 1"/>
                <hs:postAnalytics>
                    <hs:views>0</hs:views>
                    <hs:comments>1</hs:comments>
                    <hs:inboundLinks>0</hs:inboundLinks>
                </hs:postAnalytics>
            </entry>
        </feed>