Blog

List blog posts

Returns a paginated list of published blog posts, ordered by publish date (newest first).

GET /v1/blog/posts

Auth: Publishable or secret key

Query parameters

Parameter	Type	Default	Description
`page`	integer	1	Page number
`per_page`	integer	25	Items per page (max 100)

Response

{
  "data": [
    {
      "id": 15,
      "public_id": "01J7XYZ...",
      "title": "Summer Style Guide 2026",
      "handle": "summer-style-guide-2026",
      "excerpt": "Five looks to take you from beach to bar.",
      "author_name": "Sarah Chen",
      "author_avatar_url": "https://cdn.quantm7.com/store/team/sarah.webp",
      "featured_image_src": "https://cdn.quantm7.com/store/blog/summer-guide.webp",
      "featured_image_alt": "Summer style guide hero image",
      "is_featured": true,
      "reading_time_minutes": 5,
      "published_at": "2026-06-15T09:00:00.000Z",
      "created_at": "2026-06-10T14:30:00.000Z",
      "updated_at": "2026-06-15T09:00:00.000Z",
      "seo_title": "Summer Style Guide 2026 | My Store Blog",
      "seo_description": "Five versatile summer outfits for every occasion.",
      "category": {
        "id": 3,
        "name": "Style Guides",
        "handle": "style-guides"
      },
      "tags": [
        { "id": 8, "name": "Summer", "handle": "summer" },
        { "id": 12, "name": "Lookbook", "handle": "lookbook" }
      ]
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 25,
    "total": 23
  }
}

Post fields

Field	Type	Description
`id`	integer	Post ID
`public_id`	string	Public UUID
`title`	string	Post title
`handle`	string	URL-safe slug
`excerpt`	string or null	Short summary
`author_name`	string or null	Author display name
`author_avatar_url`	string or null	Author avatar image
`featured_image_src`	string or null	Hero image URL
`featured_image_alt`	string or null	Hero image alt text
`is_featured`	boolean	Whether the post is featured
`reading_time_minutes`	integer or null	Estimated reading time in minutes
`published_at`	string	Publish date (ISO 8601)
`created_at`	string	Creation date
`updated_at`	string	Last update date
`seo_title`	string or null	SEO page title
`seo_description`	string or null	SEO meta description
`category`	object or null	Single category (see below)
`tags`	array	List of tags

Category fields

Field	Type	Description
`id`	integer	Category ID
`name`	string	Category name
`handle`	string	URL-safe slug

Tag fields

Field	Type	Description
`id`	integer	Tag ID
`name`	string	Tag name
`handle`	string	URL-safe slug

Get a blog post

Returns a single blog post with its full content sections.

GET /v1/blog/posts/{handle}

Auth: Publishable or secret key

Path parameters

Parameter	Type	Description
`handle`	string	Blog post handle

Response

The response includes all the fields from the list endpoint, plus og_image and content:

{
  "data": {
    "title": "Summer Style Guide 2026",
    "handle": "summer-style-guide-2026",
    "og_image": "https://cdn.quantm7.com/store/blog/summer-guide-og.webp",
    "blocks": { "..." : "..." },
    "sections": [
      {
        "id": 1,
        "section_type": "rich_text",
        "data": { "body": "<p>Summer is here...</p>" },
        "position": 1
      },
      {
        "id": 2,
        "section_type": "image_text",
        "data": {
          "image_src": "https://cdn.quantm7.com/store/blog/outfit-1.webp",
          "body": "<p>Look one: casual linen.</p>"
        },
        "position": 2
      }
    ]
  }
}

Section fields

Field	Type	Description
`id`	integer	Section ID
`section_type`	string	Section type (e.g. `rich_text`, `image_text`, `gallery`, `faq`, `video`, `table`)
`data`	object	Section-specific content data
`position`	integer	Sort order

Blog posts use the same section system as pages. Each section type has its own data shape. See Pages for more on sections.

Errors

Status	Code	Description
404	`not_found`	No blog post with this handle exists

List blog categories

Returns all blog categories.

GET /v1/blog/categories

Auth: Publishable or secret key

Response

{
  "data": [
    {
      "id": 3,
      "name": "Style Guides",
      "handle": "style-guides",
      "description": "Outfit inspiration and seasonal lookbooks."
    }
  ]
}

Fields

Field	Type	Description
`id`	integer	Category ID
`name`	string	Category name
`handle`	string	URL-safe slug
`description`	string or null	Category description

Examples

List posts:

curl "https://api.quantm7.com/v1/blog/posts?per_page=10" \
  -H "Authorization: Bearer q7_pk_your_key"

Get a single post:

curl https://api.quantm7.com/v1/blog/posts/summer-style-guide-2026 \
  -H "Authorization: Bearer q7_pk_your_key"

List categories:

curl https://api.quantm7.com/v1/blog/categories \
  -H "Authorization: Bearer q7_pk_your_key"

On this page