{"uid":"cap_3wIVUfD9jt5uFTObYTkhG","slug":"zinc-cross-retailer-product-search-f7afe95d","name":"Zinc Cross-Retailer Product Search","description":"Zinc is infrastructure for developers to search products, place orders, and track shipments through one API. Automate your buying process. Start building now!","url":"https://api.zinc.com/agent/search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["q"],"properties":{"q":{"type":"string","description":"Search term"}}},"responseSchema":{"type":"object","title":"SearchResponse","required":["status","query"],"properties":{"query":{"type":"string","title":"Query"},"status":{"type":"string","title":"Status"},"results":{"type":"array","items":{"type":"object","title":"Sku","required":["url","retailer"],"properties":{"url":{"type":"string","title":"Url"},"brand":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand"},"image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image"},"price":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Price"},"stars":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Stars"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"retailer":{"type":"string","title":"Retailer"},"available":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Available"},"num_reviews":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Reviews"}},"description":"A cross-retailer buyable listing. Pass `url` to /orders to buy it."},"title":"Results","default":[]}},"description":"Response from the cross-retailer search endpoint."},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4V89CCKijAV3bmy_F8Yn3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches across multiple retailers to find buyable product listings with pricing, availability, ratings, and purchase URLs","exampleAgentPrompt":"Search Zinc for 'wireless noise-cancelling headphones' and show me the top results with prices, star ratings, and which retailer is selling them so I can decide which one to order.","exampleUseCases":[{"title":"Price comparison before automated purchase","prompt":"Search for 'Sony WH-1000XM5 headphones' across retailers and give me back the listings with their prices and availability so I can pick the best one to order."},{"title":"Gift sourcing for a specific product","prompt":"Can you search Zinc for 'LEGO Technic set' and find me available listings with prices and ratings? I want to buy one as a gift."},{"title":"Inventory scouting for resale automation","prompt":"Use Zinc to search for 'Apple AirPods Pro 2nd generation' and list all the available results with retailer names, prices, and URLs so my buying bot can evaluate them."}],"resultDescription":"Returns a status field, the echoed query string, and an array of product SKU objects — each containing the product title, retailer name, product URL (passable directly to /orders to purchase), brand, image URL, price in cents, star rating, number of reviews, and availability boolean. The results array defaults to empty if no matches are found.","failureModes":["Empty results array if no products match the search term","Missing or null price/brand/image fields for listings where retailer doesn't expose that data","Network timeout if retailer APIs are slow to respond","Payment failure (402) if USDC balance is insufficient for the $0.01 per-call fee","Invalid or malformed query string may return zero results"],"whenToPreferThis":"Choose this endpoint when you need to discover buyable product listings across multiple retailers in a single call, especially as the first step in an automated procurement workflow where the returned product URLs will be passed to an order placement endpoint. Prefer this over retailer-specific search APIs when you want cross-retailer coverage without managing multiple integrations. Ideal for agent workflows that combine search → select → buy in sequence.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T06:34:28.010Z","isFirstParty":false,"canonicalSlug":"zinc-cross-retailer-product-search-f7afe95d"}