OPopenstock
Products

Batch product search

Changed on

Find live listings for a product by name: current price, regular price, image and the store’s product page, for up to 10 queries per request. Each listing names its store; when the store is in the Checkmate network, merchant.id is the Checkmate merchant ID to pass to /v1/merchants/codes and activation_url is an attributed link that lands on the product page. Listings come from a product feed refreshed roughly daily (see updated_at); confirm the price at the store before promising it. Size and colour variants of one product at one store are collapsed to one listing, an in-stock one when there is one.

post/v1/products/search

Request

  • Base URL
    https://api.openstock.sh
  • URL
    https://api.openstock.sh/v1/products/search
  • Auth
    HTTP bearer

Request body

Example request

{
  "queries": [
    {
      "query_id": "hoka",
      "query": "Hoka Clifton 10",
      "store": "Hill House Home",
      "limit": 3,
      "currency": "USD"
    }
  ]
}

Response

Per-query results in request order. Each result has an items array of listings in the feed’s relevance order; empty when nothing matched.

Example response

{
  "results": [
    {
      "query_id": "hoka",
      "items": [
        {
          "id": "1414142329916416499",
          "name": "HOKA Clifton 10",
          "brand": "HOKA",
          "image_url": "https://cdn.shopify.com/s/files/1/0095/4420/4367/files/hoka_1162031CTNS_W042.jpg",
          "url": "https://www.dtlr.com/products/hoka-clifton-10-1162031-ctns-pink",
          "price": 59.98,
          "regular_price": 150,
          "currency": "USD",
          "on_sale": true,
          "discount_percent": 60,
          "availability": "in_stock",
          "merchant": {
            "id": "01h0example0dtlr0merchant0id",
            "name": "DTLR",
            "domain": "dtlr.com"
          },
          "activation_url": "https://api.openstock.sh/mr/01h0example0dtlr0merchant0id?ref=ck_partner_api&origin=open-stock&href=https%3A%2F%2Fwww.dtlr.com%2Fproducts%2Fhoka-clifton-10-1162031-ctns-pink",
          "updated_at": "2026-10-25T04:17:45Z"
        }
      ]
    }
  ]
}

Changes