{"uid":"cap_O6kLr4EYI31bIqXm3fERr","slug":"zinc-product-search-api-e8575f93","name":"Zinc Product Search API","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/products/search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["query","retailer"],"properties":{"page":{"type":"string","description":"Page number for pagination"},"query":{"type":"string","description":"Search term"},"retailer":{"enum":["amazon","walmart"],"type":"string","description":"Retailer: amazon or walmart"},"free_shipping":{"type":"boolean","description":"Only return items that ship for free (Walmart: ship price of 0). Currently a no-op for Amazon: the upstream search data under-reports Prime, so Amazon results are returned unfiltered. Applied per-page after pagination; use `next_page` in the response to keep paging — an empty page with a non-null `next_page` is not the end of results."}}},"responseSchema":{"type":"object","title":"ProductSearchResponse","required":["status"],"properties":{"status":{"type":"string","title":"Status"},"results":{"type":"array","items":{"type":"object","title":"ProductSearchResult","required":["product_id","title"],"properties":{"mpn":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mpn"},"upc":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Upc"},"addon":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Addon"},"brand":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand"},"fresh":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Fresh"},"image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image"},"price":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Price"},"prime":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Prime"},"stars":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Stars"},"title":{"type":"string","title":"Title"},"pantry":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Pantry"},"preorder":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Preorder"},"available":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Available"},"num_sales":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Sales"},"product_id":{"type":"string","title":"Product Id"},"ship_price":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ship Price"},"buyapi_hint":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Buyapi Hint"},"num_reviews":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Reviews"},"product_details":{"anyOf":[{"type":"array","items":{}},{"type":"null"}],"title":"Product Details"},"available_online":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Available Online"},"freight_shipping":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Freight Shipping"},"available_instore":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Available Instore"},"first_party_seller":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"First Party Seller"},"num_offers_estimate":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Offers Estimate"}},"description":"Normalized product search result across retailers.\n\nCommon fields are required or have defaults; retailer-specific fields are optional."},"title":"Results","default":[]},"next_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Next Page","description":"Only set on free_shipping searches: the page to request to keep paging. An empty `results` with a non-null next_page is NOT the end of results — request next_page to continue. None means results are exhausted (or the search was unfiltered)."}},"description":"Response from the product 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_00jvChEAPRjWS7tIp55Hj","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":"Search for products by keyword on Amazon or Walmart and return listings with price, availability, ratings, and shipping details","exampleAgentPrompt":"Search Amazon for 'wireless noise-cancelling headphones' and show me the top results with prices, star ratings, and whether they have Prime shipping.","exampleUseCases":[{"title":"Price comparison before automated purchase","prompt":"Search Walmart for 'Tide Pods laundry detergent' and return the top results with prices and free shipping options so I can pick the best one to order automatically."},{"title":"Product ID lookup for order automation","prompt":"Search Amazon for 'Instant Pot Duo 6 quart' and give me the product IDs and current prices so I can feed them into my ordering pipeline."},{"title":"Gift idea discovery with ratings filter","prompt":"Search Amazon for 'LEGO Star Wars sets' and show me what's available with their prices, review counts, and star ratings — I want to find well-reviewed options to buy as gifts."}],"resultDescription":"Returns a status field and an array of product results, each containing product_id, title, price (in cents), star rating, number of reviews, availability flags (available, available_online, available_instore), shipping price, Prime eligibility, brand, image URL, UPC, MPN, first-party seller flag, and pagination info (next_page) for fetching additional result pages.","failureModes":["Invalid retailer value (only 'amazon' or 'walmart' accepted) returns an error status","Empty query string may return no results or an error","Pagination with an invalid page token may return empty results","Free shipping filter is a no-op on Amazon — Amazon results are always returned unfiltered","An empty page with a non-null next_page does not indicate end of results — agent must continue paginating","Rate limiting or API key errors if payment/auth is not properly configured"],"whenToPreferThis":"Choose this endpoint when you need to programmatically search Amazon or Walmart product catalogs to retrieve structured product data (IDs, prices, ratings, availability) as part of an automated buying or price-monitoring workflow. It is particularly useful as the discovery step before placing automated orders via the Zinc ordering API. Prefer it over scraping or retail APIs when you need a unified interface for both Amazon and Walmart with downstream purchasing capability.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T00:40:31.071Z","isFirstParty":false,"canonicalSlug":"zinc-product-search-api-e8575f93"}