Skip to content
cresvaDevelopers

List the catalogue

GET/api/storefront/{brandId}/products
No keyCallable anonymously. Rate limited by IP.10 requests a minute

Read only. There is no write path on this API and there is not going to be one: a protocol that let a caller edit a merchant's catalogue is one a merchant could not safely point an agent at.

Parameters

brandIdstring · pathrequiredThe storefront's brand id. There is no public endpoint that maps a domain to a brand id; ask the merchant for their storefront URL, the id is in it.
pageinteger, default 1 · query1 indexed.
limitinteger, default 20, max 50 · queryPage size. The server caps this at 50.

Request

bash
BRAND_ID=cmqmr1f6j0003la04nu93f4k4
curl "https://cresva.ai/api/storefront/$BRAND_ID/products"

Response

Captured from production on 2026-09-16: 200 in 186ms, X-OSP-Version: 2026-03-01. This is what the endpoint returned, not an example of what it might.

JSON
{
  "products": [
    {
      "id": "cmtpqwhit001ajv04e1vvv5j6",
      "title": "The Videographer Snowboard",
      "price": {
        "amount": 885.95,
        "currency": "USD",
        "formatted": "$885.95"
      },
      "availability": "in_stock",
      "rating": null,
      "summary": "",
      "attributes": {},
      "comparison_context": null,
      "purchase_url": "https://cresva-pilot-two.myshopify.com/products/the-videographer-snowboard",
      "images": [
        "https://cdn.shopify.com/s/files/1/0803/1135/3541/files/Main.jpg?v=1787511528"
      ]
    },
    {
      "id": "cmtpqwhih0018jv04l2zc1pi9",
      "title": "The Out of Stock Snowboard",
      "price": {
        "amount": 885.95,
        "currency": "USD",
        "formatted": "$885.95"
      },
      "availability": "in_stock",
      "rating": null,
      "summary": "",
      "attributes": {},
      "comparison_context": null,
      "purchase_url": "https://cresva-pilot-two.myshopify.com/products/the-out-of-stock-snowboard",
      "images": [
        "https://cdn.shopify.com/s/files/1/0803/1135/3541/files/Main_f44a9605-cd62-464d-b095-d45cdaa0d0d7.jpg?v=1787511528"
      ]
    },
    {
      "id": "cmtpqwhi60016jv043jqkg7sh",
      "title": "The Multi-managed Snowboard",
      "price": {
        "amount": 629.95,
        "currency": "USD",
        "formatted": "$629.95"
      },
      "availability": "in_stock",
      "rating": null,
      "summary": "",
      "attributes": {},
      "comparison_context": null,
      "purchase_url": "https://cresva-pilot-two.myshopify.com/products/the-multi-managed-snowboard",
      "images": [
        "https://cdn.shopify.com/s/files/1/0803/1135/3541/files/Main_9129b69a-0c7b-4f66-b6cf-c4222f18028a.jpg?v=1787511529"
      ]
    },
    {
      "id": "cmtpqwhhu0014jv04glsretdx",
      "title": "The Multi-location Snowboard",
      "price": {
        "amount": 729.95,
        "currency": "USD",
        "formatted": "$729.95"
      },
      "availability": "in_stock",
      "rating": null,
      "summary": "",
      "attributes": {},
      "comparison_context": null,
      "purchase_url": "https://cresva-pilot-two.myshopify.com/products/the-multi-location-snowboard",
      "images": [
        "https://cdn.shopify.com/s/files/1/0803/1135/3541/files/Main_0a4e9096-021a-4c1e-8750-24b233166a12.jpg?v=1787511529"
      ]
    },
    {
      "id": "cmtpqwhhj0012jv04hygqw582",
      "title": "The Minimal Snowboard",
      "price": {
        "amount": 885.95,
        "currency": "USD",
        "formatted": "$885.95"
      },
      "availability": "in_stock",
      "rating": null,
      "summary": "",
      "attributes": {},
      "comparison_context": null,
      "purchase_url": "https://cresva-pilot-two.myshopify.com/products/the-minimal-snowboard",
      "images": []
    },
    {
      "id": "cmtpqwhh80010jv04xhewszum",
      "title": "The Inventory Not Tracked Snowboard",
      "price": {
        "amount": 949.95,
        "currency": "USD",
        "formatted": "$949.95"
      },
      "availability": "in_stock",
      "rating": null,
      "summary": "",
      "attributes": {},
      "comparison_context": null,
      "purchase_url": "https://cresva-pilot-two.myshopify.com/products/the-inventory-not-tracked-snowboard",
      "images": [
        "https://cdn.shopify.com/s/files/1/0803/1135/3541/files/snowboard_purple_hydrogen.jpg?v=1787511528"
      ]
    },
    {
      "id": "cmtpqwhgw000yjv04ht6bstu3",
      "title": "The Hidden Snowboard",
      "price": {
        "amount": 749.95,
        "currency": "USD",
        "formatted": "$749.95"
      },
      "availability": "in_stock",
      "rating": null,
      "summary": "",
      "attributes": {},
      "comparison_context": null,
      "purchase_url": "https://cresva-pilot-two.myshopify.com/products/the-hidden-snowboard",
      "images": [
        "https://cdn.shopify.com/s/files/1/0803/1135/3541/files/Main_c8ff0b5d-c712-429a-be00-b29bd55cbc9d.jpg?v=1787511528"
      ]
    },
    {

… truncated at 4000 characters

Response codes

200Product cards.
productsarray of object
└ idstringrequired
└ titlestringrequired
└ summarystring
└ priceobjectrequired
└ availabilitystring, one of in_stock, low_stock, out_of_stock, preorderrequired
└ ratingobject or nullNull when the product has no ratings. Never 0.
└ attributesobject
└ purchase_urlstring or null, uri
└ imagesarray of string
metaobject
└ totalinteger
└ pageinteger
└ authority_scorenumber or null
└ response_time_msinteger
└ data_freshnessstring, date-time
401The key does not match any active key.
erroranyTwo shapes exist across this API and that is deliberate rather than untidy. Each route kept the error shape it already used, so an existing client's error handling keeps working. See x-cresva-error-shapes.
403The key is valid but belongs to a different brand than the one in the path. Keys are scoped to one brand and do not travel.
erroranyTwo shapes exist across this API and that is deliberate rather than untidy. Each route kept the error shape it already used, so an existing client's error handling keeps working. See x-cresva-error-shapes.
404No such brand.
erroranyTwo shapes exist across this API and that is deliberate rather than untidy. Each route kept the error shape it already used, so an existing client's error handling keeps working. See x-cresva-error-shapes.
429Over the rate limit.
erroranyTwo shapes exist across this API and that is deliberate rather than untidy. Each route kept the error shape it already used, so an existing client's error handling keeps working. See x-cresva-error-shapes.
503The rate limiter could not be reached, so the request was refused rather than served unmetered. Deliberately not a 429: the caller has done nothing wrong and the fault is ours.
erroranyTwo shapes exist across this API and that is deliberate rather than untidy. Each route kept the error shape it already used, so an existing client's error handling keeps working. See x-cresva-error-shapes.

Generated from the storefront OpenAPI document at growthagents 269d7898b, sha256 047fe4d301258100. Nothing on this page was typed by hand.