For a given portal, return the list of blogs in JSON or AtomPub format.
For each blog, return key data, such as the blog GUID, human-friendly web viewing link, and RSS feed URL, if available.
| Required Parameters | How to use | Description |
|---|---|---|
| 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 |
|---|---|---|
| Offset | &offset=X - Used in the request URL | By default, this call will return a max of 10 blogs. You can use this "offset" parameter to get more posts. For instance, if you want to return blogs 11-20, you should pass an "offset=10" parameter to your call. |
Example URL requesting JSON: https://api.hubapi.com/blog/v1/list.json?access_token=demooooo-oooo-oooo-oooo-oooooooooooo
Example JSON output. It's displaying 2 blogs from the HubSpot demo portal:
[
{
"blogTitle": "Test Blog (content from customers.hubspot.com)",
"feedUrl": "demo.hubapi.com/CMS/UI/Modules/BizBlogger/rss.aspx?moduleId=584130&tabId=300291",
"guid": "0d61e4ca-e395-4c1c-8766-afaa48bf68db",
"jsonUrl": "https://api.hubapi.com/blog/v1/0d61e4ca-e395-4c1c-8766-afaa48bf68db.json",
"moderated": false,
"moderators": [],
"portalId": 62515,
"webUrl": "demo.hubapi.com/blog-for-testing"
},
{
"blogTitle": "Our Blog",
"feedUrl": "demo.hubapi.com/CMS/UI/Modules/BizBlogger/rss.aspx?moduleId=558743&tabId=167755",
"guid": "4f1c84dc-d303-4905-854c-6b923c0b55cd",
"jsonUrl": "https://api.hubapi.com/blog/v1/4f1c84dc-d303-4905-854c-6b923c0b55cd.json",
"moderated": false,
"moderators": [],
"portalId": 62515,
"webUrl": "demo.hubapi.com/"
}
]
Example URL requesting AtomPub: https://api.hubapi.com/blog/v1/list.atom?access_token=demooooo-oooo-oooo-oooo-oooooooooooo
Example AtomPub Output:
<?xml version="1.0" encoding="UTF-8"?>
<service xmlns="http://www.w3.org/2007/app" xmlns:atom="http://www.w3.org/2005/Atom">
<workspace>
<atom:title type="text">PortalId 62515 Blogs</atom:title>
<collection href="https://api.hubapi.com/blog/v1/0d61e4ca-e395-4c1c-8766-afaa48bf68db.atom">
<atom:title type="text">Test Blog (content from customers.hubspot.com)</atom:title>
</collection>
<collection href="https://api.hubapi.com/blog/v1/4f1c84dc-d303-4905-854c-6b923c0b55cd.atom">
<atom:title type="text">Our Blog</atom:title>
</collection>
<collection href="https://api.hubapi.com/blog/v1/98a74673-d4d6-4319-b741-dd071566c1e1.atom">
<atom:title type="text">Our Blog</atom:title>
</collection>
<collection href="https://api.hubapi.com/blog/v1/ddb865bf-a1a8-4528-b931-f8aa605db0c4.atom">
<atom:title type="text">test</atom:title>
</collection>
</workspace>
</service>
HTTP Methods:
GET
Response Format:
json, Atom
Requires Authentication?
Yes
Rate Limited?
Headers