HubSpot · JSON Structure
Hubspot Blog Posts Blog Post Collection Structure

Paginated collection of blog posts
Type: object Properties: 3 Required: 2
AnalyticsCommerceContentCRMCustomer ServiceEmail MarketingMarketingMarketing AutomationOperationsSales
BlogPostCollection is a JSON Structure definition published by HubSpot, describing 3 properties, of which 2 are required. It conforms to the https://json-structure.org/draft/2020-12/schema meta-schema.
Properties

total results paging
Meta-schema: https://json-structure.org/draft/2020-12/schema
JSON Structure

{
  "type": "object",
  "description": "Paginated collection of blog posts",
  "name": "BlogPostCollection",
  "properties": {
    "total": {
      "type": "integer",
      "description": "Total number of posts matching the query"
    },
    "results": {
      "type": "array",
      "description": "Array of blog posts",
      "items": {
        "type": "object",
        "description": "Represents a blog post with all content and metadata",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier for the blog post"
          },
          "name": {
            "type": "string",
            "description": "Internal name of the blog post"
          },
          "slug": {
            "type": "string",
            "description": "URL slug for the blog post"
          },
          "htmlTitle": {
            "type": "string",
            "description": "HTML title tag content"
          },
          "postBody": {
            "type": "string",
            "description": "HTML content of the blog post body"
          },
          "postSummary": {
            "type": "string",
            "description": "Summary or excerpt of the blog post"
          },
          "blogAuthorId": {
            "type": "string",
            "description": "ID of the associated blog author"
          },
          "authorName": {
            "type": "string",
            "description": "Display name of the author"
          },
          "contentGroupId": {
            "type": "string",
            "description": "ID of the blog this post belongs to"
          },
          "campaign": {
            "type": "string",
            "description": "Campaign GUID associated with the post"
          },
          "categoryId": {
            "type": "integer",
            "description": "Category ID for the post"
          },
          "state": {
            "type": "string",
            "description": "Current state of the blog post",
            "enum": [
              "DRAFT",
              "DRAFT_AB",
              "AUTOMATED",
              "PUBLISHED",
              "SCHEDULED",
              "AUTOMATED_DRAFT"
            ]
          },
          "currentState": {
            "type": "string",
            "description": "Current state description"
          },
          "publishDate": {
            "type": "datetime",
            "description": "ISO 8601 timestamp when the post was/will be published"
          },
          "created": {
            "type": "datetime",
            "description": "ISO 8601 timestamp when the post was created"
          },
          "updated": {
            "type": "datetime",
            "description": "ISO 8601 timestamp when the post was last updated"
          },
          "archivedAt": {
            "type": "datetime",
            "description": "ISO 8601 timestamp when the post was archived"
          },
          "currentlyPublished": {
            "type": "boolean",
            "description": "Whether the post is currently published"
          },
          "domain": {
            "type": "string",
            "description": "Domain where the post is published"
          },
          "featuredImage": {
            "type": "string",
            "description": "URL of the featured image"
          },
          "featuredImageAltText": {
            "type": "string",
            "description": "Alt text for the featured image"
          },
          "metaDescription": {
            "type": "string",
            "description": "Meta description for SEO"
          },
          "headHtml": {
            "type": "string",
            "description": "Custom HTML for the head section"
          },
          "footerHtml": {
            "type": "string",
            "description": "Custom HTML for the footer section"
          },
          "language": {
            "type": "string",
            "description": "Language code of the blog post"
          },
          "translatedFromId": {
            "type": "string",
            "description": "ID of the original post this was translated from"
          },
          "tagIds": {
            "type": "array",
            "description": "Array of tag IDs associated with the post",
            "items": {
              "type": "integer"
            }
          },
          "useFeaturedImage": {
            "type": "boolean",
            "description": "Whether to display the featured image"
          },
          "url": {
            "type": "uri",
            "description": "Full URL of the published post"
          },
          "abStatus": {
            "type": "string",
            "description": "A/B test status",
            "enum": [
              "master",
              "variant"
            ]
          },
          "abTestId": {
            "type": "string",
            "description": "A/B test ID if part of a test"
          },
          "folderId": {
            "type": "string",
            "description": "ID of the folder containing the post"
          }
        },
        "required": [
          "id",
          "name",
          "created",
          "updated"
        ]
      }
    },
    "paging": {
      "type": "object",
      "description": "Pagination information",
      "properties": {
        "next": {
          "type": "object",
          "description": "Pagination cursor for next page",
          "properties": {
            "after": {
              "type": "string",
              "description": "Cursor token for the next page"
            },
            "link": {
              "type": "string",
              "description": "API link to the next page"
            }
          }
        },
        "prev": {
          "type": "object",
          "description": "Pagination cursor for previous page",
          "properties": {
            "before": {
              "type": "string",
              "description": "Cursor token for the previous page"
            },
            "link": {
              "type": "string",
              "description": "API link to the previous page"
            }
          }
        }
      }
    }
  },
  "required": [
    "total",
    "results"
  ],
  "$schema": "https://json-structure.org/draft/2020-12/schema"
}