API Documentation

Bazaar's GraphQL APIs allow you to build completely custom storefronts, mobile apps, and integrate with any third-party system.

Storefront API & Webhooks

Storefront API

Public, unauthenticated access to products, collections, and checkout for custom headless builds.

Webhooks

Subscribe to real-time events like order creation, inventory updates, and customer registrations.

Authentication

To authenticate with the Admin API, include your access token in the headers:

curl -X POST https://api.bazaar.test/graphql \
  -H "Content-Type: application/json" \
  -H "X-Bazaar-Access-Token: your_token" \
  -d '{ "query": "query { shop { name } }" }'

Admin API

The Admin API allows you to manage products, inventory, orders, and customers programmatically. You must authenticate all requests using your generated API Key.

Rate Limits

Bazaar's APIs are rate-limited using a leaky bucket algorithm. The maximum bucket size is 1000 points, and it restores at a rate of 50 points per second. Query complexity determines the point cost of each request.