Saltar al contenido principal
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
}

Documentation Index

Fetch the complete documentation index at: https://developers.hubspot.es/docs/llms.txt

Use this file to discover all available pages before exploring further.

Parámetros de consulta

limit
integer
predeterminado:20

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

Rango requerido: x <= 300
offset
integer
predeterminado:0

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

archived_at
integer<int64>

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<int64>

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<int64>

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

created
integer<int64>

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<int64>

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

state
enum<string>

Filter by post state.

Opciones disponibles:
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).

Respuesta

200 - application/json

A list of blog posts.

objects
object[]
total
integer
limit
integer
offset
integer
Last modified on April 13, 2026