HUhubspot
Basic

Query Posts

Changed on

Retrieve blog posts from the HubSpot CMS using various query parameters to filter and sort the results. This endpoint supports pagination and allows you to specify date ranges for creation and updates, as well as sorting options. It is useful for fetching a list of posts with specific criteria, such as posts created after a certain date or posts that have been archived.

get/cms/blogs/2026-09/posts/cursor/query

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/cms/blogs/2026-09/posts/cursor/query
  • Auth
    OAuth 2
    Authorization code: https://app.hubspot.com/oauth/authorize
    Token URL: https://api.hubapi.com/oauth/v1/token scopes: content

Query parameters

afterstring

The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results.

archivedboolean

Whether to return only results that have been archived.

createdAfterstring date-time

Filter posts created after the specified date-time.

createdAtstring date-time

Filter posts by their exact creation date. The format is date-time.

createdBeforestring date-time

Filter posts created before the specified date-time.

limitinteger

The maximum number of results to display per page.

propertystring

Specify properties to include in the response.

sortstring[]

Specify the sorting order of the results. Accepts an array of strings.

updatedAfterstring date-time

Filter posts updated after the specified date-time.

updatedAtstring date-time

Filter posts by their exact update date. The format is date-time.

updatedBeforestring date-time

Filter posts updated before the specified date-time.

Response

successful operation

CursorPagedResultBlogPostLong required

Changes