GET
/
content
/
api
/
v2
/
blog-posts
List blog posts
curl --request GET \
  --url https://api.hubapi.com/content/api/v2/blog-posts
{
  "objects": [
    {
      "id": 123,
      "portal_id": 123,
      "name": "<string>",
      "html_title": "<string>",
      "slug": "<string>",
      "content_group_id": 123,
      "blog_author_id": 123,
      "post_body": "<string>",
      "post_summary": "<string>",
      "meta_description": "<string>",
      "featured_image": "<string>",
      "head_html": "<string>",
      "footer_html": "<string>",
      "campaign": "<string>",
      "campaign_name": "<string>",
      "state": "DRAFT",
      "publish_date": 123,
      "publish_immediately": true,
      "created": 123,
      "updated": 123,
      "archived_at": 123,
      "is_draft": true,
      "url": "<string>",
      "published_url": "<string>",
      "topic_ids": [
        123
      ],
      "keywords": [
        {}
      ],
      "use_featured_image": true,
      "widgets": {}
    }
  ],
  "total": 123,
  "limit": 123,
  "offset": 123
}

Authorizations

​
hapikey
string
query
required

Query Parameters

​
limit
integer
default:20

The number of items to return. Defaults to 20. Cannot exceed 300.

Required range: x <= 300
​
offset
integer
default:0

The offset set to start returning rows from. Defaults to 0.

​
archived_at
integer

Returns the posts that match a particular deleted time value. Supports exact, gt, gte, lt, lte lookups.

​
archivedInDashboard
boolean

Returns the posts that match the boolean lookup (e.g. archived=false returns all posts currently not archived).

​
blog_author_id
integer

Returns the posts that match a particular blog author ID value.

​
campaign
string

Returns the posts that match the campaign guid. The campaign guid can be found in the campaign dashboard URL.

​
content_group_id
integer

Returns the posts that match the blog guid. The blog guid can be found using the Blog API.

​
created
integer

Returns the posts that match a particular created time value. Supports exact, range, gt, gte, lt, lte lookups.

​
name
string

Returns the posts that match the name value. Supports exact, icontains, ne lookups.

​
slug
string

Returns the posts that match a particular slug value.

​
updated
integer

Returns the posts that match a particular updated time. Supports exact, range, gt, gte, lt, lte lookups.

​
state
enum<string>

Filter by post state.

Available options:
DRAFT,
PUBLISHED,
SCHEDULED
​
order_by
string

Return the posts ordered by a particular field value. Blog posts can currently only be sorted by publish_date. Use a negative value to sort in descending order (e.g. order_by=-publish_date).

Response

200 - application/json

A list of blog posts.

The response is of type object.