curl https://api.zinc.com/search?q=cast+iron+skillet \
-H "Authorization: Bearer <your_api_key>"
import requests
res = requests.get(
"https://api.zinc.com/search",
params={"q": "cast iron skillet"},
headers={"Authorization": "Bearer <your_api_key>"},
)
res.raise_for_status()
results = res.json()["results"]
const res = await fetch(
"https://api.zinc.com/search?q=" + encodeURIComponent("cast iron skillet"),
{ headers: { Authorization: "Bearer <your_api_key>" } }
);
const { results } = await res.json();
{
"status": "completed",
"query": "cast iron skillet",
"results": [
{
"url": "https://www.wayfair.com/cookware/pdp/lodge-cast-iron-skillet-6-5-...",
"retailer": "wayfair",
"title": "Lodge Cast Iron Skillet 6.5\" Black/Gray, Pre-Seasoned",
"image": "https://thf.bing.com/th?id=OPHS.DO%2fNmrRBpgF0sA474C474&w=220&h=220",
"brand": null,
"price": 1890,
"stars": 4.7,
"num_reviews": 1000,
"available": null
},
{
"url": "https://www.homedepot.com/p/10-5-in-Cast-Iron-Skillet-In-Black/...",
"retailer": "homedepot",
"title": "10.5 in. Cast Iron Skillet In Black",
"image": "https://thf.bing.com/th/id/OPHS.Jv2SxDM0Y6PO8g474C474?w=220&h=220",
"brand": null,
"price": 2490,
"stars": 4.7,
"num_reviews": 1000,
"available": null
},
{
"url": "https://www.target.com/p/lodge-12-cast-iron-skillet/-/A-...",
"retailer": "target",
"title": "Lodge 12\" Cast Iron Skillet: Preseasoned, Non-Stick, Scratch-Resistant",
"image": "https://thf.bing.com/th/id/OPHS.W0Kf0gUKdW1yoA474C474?w=220&h=220",
"brand": null,
"price": 2999,
"stars": 4.7,
"num_reviews": 1000,
"available": null
},
{
"url": "https://www.amazon.com/dp/B00006JSUC",
"retailer": "amazon",
"title": "Lodge L8SK3 10.25-inch Pre-Seasoned Cast Iron Skillet",
"image": "https://m.media-amazon.com/images/I/81ysMDr2VgL._AC_UL320_.jpg",
"brand": "Lodge",
"price": 2497,
"stars": 4.8,
"num_reviews": 132840,
"available": true
}
]
}
{
"error": {
"code": "unauthorized",
"message": "Missing or invalid API key",
"details": null
}
}
{
"detail": "Insufficient wallet balance for data API call"
}
Search (Beta)
Cross-Retailer Search
Search every retailer Zinc supports in a single API call to compare products and prices (beta).
GET
/
search
curl https://api.zinc.com/search?q=cast+iron+skillet \
-H "Authorization: Bearer <your_api_key>"
import requests
res = requests.get(
"https://api.zinc.com/search",
params={"q": "cast iron skillet"},
headers={"Authorization": "Bearer <your_api_key>"},
)
res.raise_for_status()
results = res.json()["results"]
const res = await fetch(
"https://api.zinc.com/search?q=" + encodeURIComponent("cast iron skillet"),
{ headers: { Authorization: "Bearer <your_api_key>" } }
);
const { results } = await res.json();
{
"status": "completed",
"query": "cast iron skillet",
"results": [
{
"url": "https://www.wayfair.com/cookware/pdp/lodge-cast-iron-skillet-6-5-...",
"retailer": "wayfair",
"title": "Lodge Cast Iron Skillet 6.5\" Black/Gray, Pre-Seasoned",
"image": "https://thf.bing.com/th?id=OPHS.DO%2fNmrRBpgF0sA474C474&w=220&h=220",
"brand": null,
"price": 1890,
"stars": 4.7,
"num_reviews": 1000,
"available": null
},
{
"url": "https://www.homedepot.com/p/10-5-in-Cast-Iron-Skillet-In-Black/...",
"retailer": "homedepot",
"title": "10.5 in. Cast Iron Skillet In Black",
"image": "https://thf.bing.com/th/id/OPHS.Jv2SxDM0Y6PO8g474C474?w=220&h=220",
"brand": null,
"price": 2490,
"stars": 4.7,
"num_reviews": 1000,
"available": null
},
{
"url": "https://www.target.com/p/lodge-12-cast-iron-skillet/-/A-...",
"retailer": "target",
"title": "Lodge 12\" Cast Iron Skillet: Preseasoned, Non-Stick, Scratch-Resistant",
"image": "https://thf.bing.com/th/id/OPHS.W0Kf0gUKdW1yoA474C474?w=220&h=220",
"brand": null,
"price": 2999,
"stars": 4.7,
"num_reviews": 1000,
"available": null
},
{
"url": "https://www.amazon.com/dp/B00006JSUC",
"retailer": "amazon",
"title": "Lodge L8SK3 10.25-inch Pre-Seasoned Cast Iron Skillet",
"image": "https://m.media-amazon.com/images/I/81ysMDr2VgL._AC_UL320_.jpg",
"brand": "Lodge",
"price": 2497,
"stars": 4.8,
"num_reviews": 132840,
"available": true
}
]
}
{
"error": {
"code": "unauthorized",
"message": "Missing or invalid API key",
"details": null
}
}
{
"detail": "Insufficient wallet balance for data API call"
}
Beta — this endpoint is in active development and may change without notice. Field names, ranking, and coverage are still evolving. We’d love your feedback: book a 30-minute customer interview and help shape the v1 — we’ll send you a $50 Amazon gift card as a thank-you.
GET /search returns a single ranked list of buyable products across every supported retailer — Amazon, Walmart, Target, Best Buy, Home Depot, Lowe’s, Costco, eBay, Wayfair, Macy’s, and more — in one call.
Each result’s url is the orderable retailer URL: pass it directly to Create order. There is no opaque sku id and no separate ASIN / item-id field — the URL is the contract.
This is distinct from the per-retailer /products/search, which searches one retailer at a time. Use /search when you want breadth.
Ranking
Results are ranked by a quality signal that combines rating and review volume, with price as a tiebreaker for unrated items. The list is then woven across retailers so a single retailer doesn’t dominate the top — typically you’ll see two or three different retailers in the first few results.Beta limits
These will change before v1:
- No condition filter — used / marketplace listings may appear when the source doesn’t expose condition.
- Coverage varies by query; some long-tail and DTC retailers may not appear.
- No
limit,sort, orfilterparameters yet. - Response shape may add fields (e.g. condition, shipping ETA). Existing fields won’t be removed without notice.
Help shape the beta
Customer interview — 30 minutes · $50 Amazon gift card
We’re actively iterating on
/search. Tell us what queries you’re running, what coverage you need, and what’s missing. As a thank-you we’ll send you a $50 Amazon gift card.curl https://api.zinc.com/search?q=cast+iron+skillet \
-H "Authorization: Bearer <your_api_key>"
import requests
res = requests.get(
"https://api.zinc.com/search",
params={"q": "cast iron skillet"},
headers={"Authorization": "Bearer <your_api_key>"},
)
res.raise_for_status()
results = res.json()["results"]
const res = await fetch(
"https://api.zinc.com/search?q=" + encodeURIComponent("cast iron skillet"),
{ headers: { Authorization: "Bearer <your_api_key>" } }
);
const { results } = await res.json();
{
"status": "completed",
"query": "cast iron skillet",
"results": [
{
"url": "https://www.wayfair.com/cookware/pdp/lodge-cast-iron-skillet-6-5-...",
"retailer": "wayfair",
"title": "Lodge Cast Iron Skillet 6.5\" Black/Gray, Pre-Seasoned",
"image": "https://thf.bing.com/th?id=OPHS.DO%2fNmrRBpgF0sA474C474&w=220&h=220",
"brand": null,
"price": 1890,
"stars": 4.7,
"num_reviews": 1000,
"available": null
},
{
"url": "https://www.homedepot.com/p/10-5-in-Cast-Iron-Skillet-In-Black/...",
"retailer": "homedepot",
"title": "10.5 in. Cast Iron Skillet In Black",
"image": "https://thf.bing.com/th/id/OPHS.Jv2SxDM0Y6PO8g474C474?w=220&h=220",
"brand": null,
"price": 2490,
"stars": 4.7,
"num_reviews": 1000,
"available": null
},
{
"url": "https://www.target.com/p/lodge-12-cast-iron-skillet/-/A-...",
"retailer": "target",
"title": "Lodge 12\" Cast Iron Skillet: Preseasoned, Non-Stick, Scratch-Resistant",
"image": "https://thf.bing.com/th/id/OPHS.W0Kf0gUKdW1yoA474C474?w=220&h=220",
"brand": null,
"price": 2999,
"stars": 4.7,
"num_reviews": 1000,
"available": null
},
{
"url": "https://www.amazon.com/dp/B00006JSUC",
"retailer": "amazon",
"title": "Lodge L8SK3 10.25-inch Pre-Seasoned Cast Iron Skillet",
"image": "https://m.media-amazon.com/images/I/81ysMDr2VgL._AC_UL320_.jpg",
"brand": "Lodge",
"price": 2497,
"stars": 4.8,
"num_reviews": 132840,
"available": true
}
]
}
{
"error": {
"code": "unauthorized",
"message": "Missing or invalid API key",
"details": null
}
}
{
"detail": "Insufficient wallet balance for data API call"
}
Authorizations
Zinc API key (Bearer zn_...)
Headers
Query Parameters
Search term
Minimum string length:
1