PlutocracyMercury developer docs

Products by handle (comma-separated, at most 20); responds with Product[] (or one Product).

GET /search/product/handles/{handles}

Authentication

None.

Parameters

NameInTypeDescription
handles requiredpathstring
bypassTokenquerystring
currencyquerystring

Responses

200 OK application/json

Type: Product[] | Product

Example response (illustrative)
[
  {
    "handle": "linen-shirt",
    "id": 7712345678901,
    "title": "Linen shirt",
    "vendor": "Mercury Apparel",
    "type": "Shirts",
    "min_price": 89,
    "compare_at_min_price": 89,
    "on_sale": false,
    "total_stock": 12,
    "created_date": "2026-11-01T00:00:00.000Z",
    "tags": [
      "summer"
    ],
    "image": "https://cdn.shopify.com/s/files/1/0000/0001/files/linen-shirt.jpg",
    "images": [
      "https://cdn.shopify.com/s/files/1/0000/0001/files/linen-shirt.jpg"
    ],
    "variants": [
      {
        "id": 7712345678901,
        "title": "Linen shirt",
        "price": 89
      }
    ],
    "prices": {
      "AUD": {
        "price": 89
      }
    },
    "related": [
      {
        "handle": "linen-shirt"
      }
    ],
    "imploded": [
      {}
    ],
    "meta": {
      "key": null
    }
  }
]

Errors use the standard envelope; see errors and status codes.

Example request

curl "https://mercury.plutocracy.io/search/product/handles/linen-shirt"