HubSpot · JSON Structure
Blog Posts Api 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/meta/core/v0/# meta-schema.
Properties
total
results
paging
Meta-schema: https://json-structure.org/meta/core/v0/#
JSON Structure
{
"$schema": "https://json-structure.org/meta/core/v0/#",
"$id": "https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/blog-posts-api-blog-post-collection-structure.json",
"name": "BlogPostCollection",
"description": "Paginated collection of blog posts",
"type": "object",
"properties": {
"total": {
"type": "int32",
"description": "Total number of posts matching the query",
"example": 10
},
"results": {
"type": "array",
"items": {
"type": "object",
"description": "Represents a blog post with all content and metadata",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the blog post",
"example": "500123"
},
"name": {
"type": "string",
"description": "Internal name of the blog post",
"example": "Example Record"
},
"slug": {
"type": "string",
"description": "URL slug for the blog post",
"example": "example-value"
},
"htmlTitle": {
"type": "string",
"description": "HTML title tag content",
"example": "Example Record"
},
"postBody": {
"type": "string",
"description": "HTML content of the blog post body",
"example": "This is an example description."
},
"postSummary": {
"type": "string",
"description": "Summary or excerpt of the blog post",
"example": "example-value"
},
"blogAuthorId": {
"type": "string",
"description": "ID of the associated blog author",
"example": "500123"
},
"authorName": {
"type": "string",
"description": "Display name of the author",
"example": "Example Record"
},
"contentGroupId": {
"type": "string",
"description": "ID of the blog this post belongs to",
"example": "500123"
},
"campaign": {
"type": "string",
"description": "Campaign GUID associated with the post",
"example": "example-value"
},
"categoryId": {
"type": "int32",
"description": "Category ID for the post",
"example": 500123
},
"state": {
"type": "string",
"enum": [
"DRAFT",
"DRAFT_AB",
"AUTOMATED",
"PUBLISHED",
"SCHEDULED",
"AUTOMATED_DRAFT"
],
"description": "Current state of the blog post",
"example": "DRAFT"
},
"currentState": {
"type": "string",
"description": "Current state description",
"example": "active"
},
"publishDate": {
"type": "datetime",
"description": "ISO 8601 timestamp when the post was/will be published",
"example": "2025-03-15T14:30:00Z"
},
"created": {
"type": "datetime",
"description": "ISO 8601 timestamp when the post was created",
"example": "2025-03-15T14:30:00Z"
},
"updated": {
"type": "datetime",
"description": "ISO 8601 timestamp when the post was last updated",
"example": "2025-03-15T14:30:00Z"
},
"archivedAt": {
"type": "datetime",
"description": "ISO 8601 timestamp when the post was archived",
"example": "2025-03-15T14:30:00Z"
},
"currentlyPublished": {
"type": "boolean",
"description": "Whether the post is currently published",
"example": true
},
"domain": {
"type": "string",
"description": "Domain where the post is published",
"example": "example.hubspot.com"
},
"featuredImage": {
"type": "string",
"description": "URL of the featured image",
"example": "example-value"
},
"featuredImageAltText": {
"type": "string",
"description": "Alt text for the featured image",
"example": "example-value"
},
"metaDescription": {
"type": "string",
"description": "Meta description for SEO",
"example": "This is an example description."
},
"headHtml": {
"type": "string",
"description": "Custom HTML for the head section",
"example": "example-value"
},
"footerHtml": {
"type": "string",
"description": "Custom HTML for the footer section",
"example": "example-value"
},
"language": {
"type": "string",
"description": "Language code of the blog post",
"example": "en"
},
"translatedFromId": {
"type": "string",
"description": "ID of the original post this was translated from",
"example": "500123"
},
"tagIds": {
"type": "array",
"items": {
"type": "int32"
},
"description": "Array of tag IDs associated with the post",
"example": [
500123
]
},
"useFeaturedImage": {
"type": "boolean",
"description": "Whether to display the featured image",
"example": true
},
"url": {
"type": "uri",
"description": "Full URL of the published post",
"example": "https://app.hubspot.com/contacts/12345"
},
"abStatus": {
"type": "string",
"enum": [
"master",
"variant"
],
"description": "A/B test status",
"example": "master"
},
"abTestId": {
"type": "string",
"description": "A/B test ID if part of a test",
"example": "500123"
},
"folderId": {
"type": "string",
"description": "ID of the folder containing the post",
"example": "500123"
}
},
"required": [
"id",
"name",
"created",
"updated"
]
},
"description": "Array of blog posts",
"example": [
{
"id": "500123",
"name": "Example Record",
"slug": "example-value",
"htmlTitle": "Example Record",
"postBody": "This is an example description.",
"postSummary": "example-value",
"blogAuthorId": "500123",
"authorName": "Example Record",
"contentGroupId": "500123",
"campaign": "example-value",
"categoryId": 500123,
"state": "DRAFT",
"currentState": "active",
"publishDate": "2025-03-15T14:30:00Z",
"created": "2025-03-15T14:30:00Z",
"updated": "2025-03-15T14:30:00Z",
"archivedAt": "2025-03-15T14:30:00Z",
"currentlyPublished": true,
"domain": "example.hubspot.com",
"featuredImage": "example-value",
"featuredImageAltText": "example-value",
"metaDescription": "This is an example description.",
"headHtml": "example-value",
"footerHtml": "example-value",
"language": "en",
"translatedFromId": "500123",
"tagIds": [
500123
],
"useFeaturedImage": true,
"url": "https://app.hubspot.com/contacts/12345",
"abStatus": "master",
"abTestId": "500123",
"folderId": "500123"
}
]
},
"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",
"example": "example-value"
},
"link": {
"type": "string",
"description": "API link to the next page",
"example": "https://app.hubspot.com/contacts/12345"
}
}
},
"prev": {
"type": "object",
"description": "Pagination cursor for previous page",
"properties": {
"before": {
"type": "string",
"description": "Cursor token for the previous page",
"example": "example-value"
},
"link": {
"type": "string",
"description": "API link to the previous page",
"example": "https://app.hubspot.com/contacts/12345"
}
}
}
}
}
},
"required": [
"total",
"results"
]
}