Skip to content
STOQDevelopers
Open STOQ

Build on STOQ

APIs, SDK, storefront JavaScript and MCP for building on STOQ preorders and back in stock alerts.

Get startedAPI v2SDKFrontendMCPChangelogHelp center

Latest change · 2026-10-13Back-in-stock product search covers the Shopify catalog

Get startedAPI keys, rate limits, and what changed recently.
API v2 BetaGuides and the full reference for the action-based API: offers, variants, orders, signups, reports.
SDK BetaJavaScript SDK and React hooks for headless and Hydrogen storefronts, with live examples.
FrontendOn-page JavaScript API, custom events and theme metafields for stores on the STOQ app.
MCP BetaConnect Claude, ChatGPT and other agents to every API v2 action.
ChangelogDated changes to the API and MCP server that can affect your integration.

Quickstart (API v2, beta)

Section titled “Quickstart (API v2, beta)”

  1. Get an API key

    In the STOQ app, go to Back in stock alerts > Integrations and copy the key from the API Key section. Send it on every request in the X-Auth-Token header.

  2. Make your first request

    Terminal window
    curl https://app.stoqapp.com/api/v2/external/account/help_docs \
      -H "X-Auth-Token: $STOQ_API_KEY"

  3. Handle errors and limits

    Failed requests return { "errors": [...] } with a 4xx status. Each store gets 360 points per 60 seconds (a read costs 1, a write 2); on a 429, wait for Retry-After. See Errors and Rate limits.

For AI agents and tools: the OpenAPI specs are at /openapi/api-v2.json and /openapi/api-v1.json, and the MCP server reaches every API v2 action.