Products by handle (comma-separated, at most 20); responds with Product[] (or one Product).
GET /search/product/handles/{handles}
Authentication
None.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
handles required | path | string | |
bypassToken | query | string | |
currency | query | string |
Responses
200 OK application/json
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"