Queek docs
Storefront endpoint reference

Posts

GET
/store/posts

Published posts, paginated; filter by category or tag. Fetch one with posts/{slug}. Each post carries metafields: the store’s custom fields the merchant made visible, {} when none.

Authorization

clientKey
X-Client-Key<token>

The connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… private keys are for servers and native apps and need no Origin.

In: header

Query Parameters

tag?|

Only posts carrying this tag (exact match).

Lengthlength <= 100
category?|

Only posts filed under the blog category with this slug, as returned by GET /store/blog-categories.

Lengthlength <= 140
per_page?|

Posts per page, 1 to 50 (default 12). Alias of limit.

Range1 <= value <= 50
starting_after?string

Keyset cursor: pass the previous page next_cursor. Walk while has_more is true; a stale, tampered, cross-list or filter-changed cursor answers 422 validation_failed with the failure on starting_after. Never combine with page.

limit?integer

Items per read (alias of per_page, max 50). page mode caps at page 50 (a deeper page answers 422 validation_failed on page); walk the cursor past that.

page?integer

Page number, starting at 1 (default 1); anything else is read as 1. Page 50 is the deepest page served: walk further with starting_after. Never combine with starting_after.

locale?string

Render this read in a published store locale (see GET store/locales). Unknown or unpublished codes fall back to the primary locale; the answer carries the locale used in Content-Language.

Header Parameters

X-Client-Key*string

Your connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… private keys are for servers and native apps and need no Origin.

X-Request-Id?string

Your own correlation id (8–128 chars, ^[A-Za-z0-9_.:-]+$). Echoed back on the response and on every log line of the request; one is generated when you omit it.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/store/posts?tag=prints&category=style-notes&per_page=12&limit=15&page=1" \  -H "X-Client-Key: {{clientKey}}"
{  "status": "success",  "message": "Store posts retrieved",  "data": [    {      "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c73",      "type": "post",      "template": null,      "slug": "how-to-style-prints",      "title": "How to style prints without looking costumey",      "content": [        {          "type": "content",          "data": {            "markdown": "Rule one: one print at a time. Rule two: modern shoes. Rule three: confidence."          }        }      ],      "media_index": {},      "excerpt": "Three rules for modern prints.",      "cover_image_url": "https://media.usequeek.com/uploads/stores/2207/posts/prints-style.jpg",      "cover_image_variants": null,      "tags": [        "prints",        "style"      ],      "seo": {        "title": "How to style prints | Northwind Goods",        "description": "Three rules for modern prints."      },      "metafields": {},      "blog_categories": [        {          "name": "Style Notes",          "slug": "style-notes"        }      ],      "reading_time": 1,      "author": {        "name": "Northwind Goods",        "avatar_url": "https://media.usequeek.com/uploads/stores/2207/logo.png"      },      "is_home": false,      "chrome": "full",      "show_page_title": true,      "status": "published",      "position": 1,      "published_at": "2026-09-12T08:00:00+01:00",      "created_at": "2026-09-10T16:20:00+01:00",      "updated_at": "2026-09-12T08:00:00+01:00"    },    {      "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c74",      "type": "post",      "template": null,      "slug": "cotton-vs-linen",      "title": "Cotton vs linen: what we cut and why",      "content": [        {          "type": "content",          "data": {            "markdown": "Northwind Goods cuts every piece in our New York atelier."          }        }      ],      "media_index": {},      "excerpt": "Fabric notes from the atelier.",      "cover_image_url": "https://media.usequeek.com/uploads/stores/2207/posts/fabric.jpg",      "cover_image_variants": null,      "tags": [        "fabric"      ],      "seo": {        "title": "Cotton vs linen | Northwind Goods",        "description": "Fabric notes from the atelier."      },      "metafields": {},      "blog_categories": [        {          "name": "Fabric Guide",          "slug": "fabric-guide"        }      ],      "reading_time": 1,      "author": {        "name": "Northwind Goods",        "avatar_url": "https://media.usequeek.com/uploads/stores/2207/logo.png"      },      "is_home": false,      "chrome": "full",      "show_page_title": true,      "status": "published",      "position": 2,      "published_at": "2026-09-05T08:00:00+01:00",      "created_at": "2026-09-03T16:20:00+01:00",      "updated_at": "2026-09-05T08:00:00+01:00"    }  ],  "has_more": false,  "next_cursor": null}
GET
/store/posts/{slug}

A published post by slug with its cover image, excerpt, content[] blocks and metafields (the custom fields the merchant made visible, {} when none), plus related[] posts in the same shape.

Authorization

clientKey
X-Client-Key<token>

The connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… private keys are for servers and native apps and need no Origin.

In: header

Path Parameters

slug*string

Slug of the post, as returned by GET /store/posts.

Query Parameters

locale?string

Render this read in a published store locale (see GET store/locales). Unknown or unpublished codes fall back to the primary locale; the answer carries the locale used in Content-Language.

Header Parameters

X-Client-Key*string

Your connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… private keys are for servers and native apps and need no Origin.

X-Request-Id?string

Your own correlation id (8–128 chars, ^[A-Za-z0-9_.:-]+$). Echoed back on the response and on every log line of the request; one is generated when you omit it.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/store/posts/how-to-style-prints" \  -H "X-Client-Key: {{clientKey}}"
{  "status": "success",  "message": "Store post retrieved",  "data": {    "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c73",    "type": "post",    "template": null,    "slug": "how-to-style-prints",    "title": "How to style prints without looking costumey",    "content": [      {        "type": "content",        "data": {          "markdown": "Rule one: one print at a time. Rule two: modern shoes. Rule three: confidence."        }      }    ],    "media_index": {},    "excerpt": "Three rules for modern prints.",    "cover_image_url": "https://media.usequeek.com/uploads/stores/2207/posts/prints-style.jpg",    "cover_image_variants": null,    "tags": [      "prints",      "style"    ],    "seo": {      "title": "How to style prints | Northwind Goods",      "description": "Three rules for modern prints."    },    "metafields": {},    "blog_categories": [      {        "name": "Style Notes",        "slug": "style-notes"      }    ],    "reading_time": 1,    "author": {      "name": "Northwind Goods",      "avatar_url": "https://media.usequeek.com/uploads/stores/2207/logo.png"    },    "is_home": false,    "chrome": "full",    "show_page_title": true,    "status": "published",    "position": 1,    "published_at": "2026-09-12T08:00:00+01:00",    "created_at": "2026-09-10T16:20:00+01:00",    "updated_at": "2026-09-12T08:00:00+01:00",    "related": [      {        "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c74",        "type": "post",        "template": null,        "slug": "cotton-vs-linen",        "title": "Cotton vs linen: what we cut and why",        "content": [          {            "type": "content",            "data": {              "markdown": "Northwind Goods cuts every piece in our New York atelier."            }          }        ],        "media_index": {},        "excerpt": "Fabric notes from the atelier.",        "cover_image_url": "https://media.usequeek.com/uploads/stores/2207/posts/fabric.jpg",        "cover_image_variants": null,        "tags": [          "fabric"        ],        "seo": {          "title": "Cotton vs linen | Northwind Goods",          "description": "Fabric notes from the atelier."        },        "metafields": {},        "blog_categories": [          {            "name": "Fabric Guide",            "slug": "fabric-guide"          }        ],        "reading_time": 1,        "author": {          "name": "Northwind Goods",          "avatar_url": "https://media.usequeek.com/uploads/stores/2207/logo.png"        },        "is_home": false,        "chrome": "full",        "show_page_title": true,        "status": "published",        "position": 2,        "published_at": "2026-09-05T08:00:00+01:00",        "created_at": "2026-09-03T16:20:00+01:00",        "updated_at": "2026-09-05T08:00:00+01:00"      }    ]  }}