Developers

The ShopQuery API gives developers access to the same live catalog that powers a merchant's channels.

Use it to build storefronts, product search, AI agents, internal tools, recommendation surfaces, or custom integrations that need product and collection data.

Every request is scoped to the merchant connected to the app token. That means a valid token only returns records for the merchant account that created it.

Base URL

https://api.shopquery.ai/v1

What you can read

The API currently covers:

• Products, including price, quantity, images, inventory details, and collections.
• Product search, for finding relevant products by natural search text.
• Collections, including the products grouped inside them.

Pagination

List endpoints return paginated responses.

{
    "meta": {
        "total": 42,
        "perPage": 100,
        "currentPage": 1,
        "lastPage": 1,
        "firstPage": 1,
        "firstPageUrl": "/?page=1",
        "lastPageUrl": "/?page=1",
        "nextPageUrl": null,
        "previousPageUrl": null
    },
    "data": []
}

Use page and perPage to move through larger result sets. If omitted, page defaults to 1 and perPage defaults to 100.

Errors

Most errors return JSON with a message field. Validation errors may include extra details.

{
    "message": "Unauthorized access"
}