Bazaar Marketplace API

A public, read-only JSON API for marketplace listings and categories — build integrations, sync a catalogue, or power your own storefront. Version 1.0.

No auth requiredEvery endpoint is public and CORS-enabled.

120 req / min / IPResponses cache for 60s; JSON envelopes are stable.

Base URLhttps://bazaar.selfcoding.dev

Endpoints

GET/api/public/v1/listings

Search & list marketplace listings. Same ranking as on-site search, paginated.

q: Full-text query.
category: Category slug (see /categories).
min, max: Price range in £.
sort: relevance · newest · price-asc · price-desc · popular.
limit, offset: Paging (default 24, max 100).

{
  "object": "list",
  "total": 10,
  "limit": 24,
  "offset": 0,
  "has_more": false,
  "data": [
    {
      "object": "listing",
      "id": "lst_iphone",
      "title": "Refurbished iPhone 13 — 128GB, unlocked",
      "slug": "refurbished-iphone-13-128gb",
      "category": "electronics",
      "price": { "amount": 32900, "currency": "GBP", "formatted": "£329.00" },
      "image": "https://images.unsplash.com/...",
      "sold": 92,
      "url": "/store/circuitcove",
      "vendor": { "id": "vnd_circuitcove", "name": "Circuit Cove",
                  "handle": "circuitcove", "url": "/store/circuitcove" }
    }
  ]
}

Try it live →

GET/api/public/v1/listings/lst_iphone

Fetch a single listing by id. Returns 404 when it does not exist.

{
  "object": "listing",
  "id": "lst_iphone",
  "title": "Refurbished iPhone 13 — 128GB, unlocked",
  "category": "electronics",
  "price": { "amount": 32900, "currency": "GBP", "formatted": "£329.00" },
  "sold": 92,
  "vendor": { "id": "vnd_circuitcove", "name": "Circuit Cove", "handle": "circuitcove" }
}

Try it live →

GET/api/public/v1/categories

The full marketplace category taxonomy with subcategories.

{
  "object": "list",
  "total": 6,
  "data": [
    {
      "object": "category",
      "slug": "electronics",
      "name": "Electronics",
      "description": "Phones, laptops, audio and everything that plugs in…",
      "subcategories": [{ "slug": "phones", "name": "Phones & tablets" }]
    }
  ]
}

Try it live →

More is coming as the marketplace grows — vendor directory, reviews and stock. Start with the API index.