# 402Shelf Product Search > 402Shelf Product Search is a paid API for AI agents from api.402shelf.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-02, last successful call 2026-09-25). Search live products across online retailers by keyword and price range, returning product names, prices, retailers, and purchase links. ## Facts - Endpoint: GET https://api.402shelf.com/products/search?utm_source=zero.xyz - Price: $0.001/call - Payment: x402 - Status: unknown - Last checked: 2026-10-02 - Last successful call: 2026-09-25 - Success rate: 40% of calls made through Zero - Activations on Zero: 5 - Tags: x402 - Canonical page: https://www.zero.xyz/c/402shelf-product-search-fce68e88 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9XEH9dAnsPIdnLRA53Im5 Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability 402shelf-product-search-fce68e88 ``` Example prompt: Search 402Shelf for wireless noise-cancelling headphones priced between $50 and $150 USD in the US and show me the top results with direct purchase links. ## When to prefer this Choose this endpoint when an agent needs real-time, live product listings from multiple online retailers with price filtering — especially when the user wants current prices and direct purchase links rather than historical or cached data. Prefer over general web search when structured product data (price, retailer, buy link) is specifically needed. ## Known failure modes - No products found for the given keyword or price range — returns empty result set - Invalid country code or currency code — returns validation error - Price range minimum exceeds maximum — returns parameter error - Keyword too vague or too specific — may return zero or irrelevant results - Service unavailable or payment (x402) not accepted — returns HTTP 402 or 5xx error ## How this service works Search live products across online retailers by keyword and price range. Returns product names, prices, retailers, and direct purchase links. Use when an agent needs current shopping options or price-filtered product recommendations. ## Output A list of live product listings matching the keyword and price filter, each including the product name, current price (with currency), retailer name, and a direct purchase URL. ## Request schema (JSON Schema) ```json { "type": "object", "$defs": { "codes0": { "enum": [ "AE", "AI", "AR", "AT", "AU", "AW", "BE", "BM", "BR", "CA", "CC", "CH", "CL", "CO", "CX", "CZ", "DE", "DK", "ES", "FI", "FK", "FR", "GB", "GF", "GP", "GR", "GS", "HK", "HM", "HU", "ID", "IE", "IL", "IN", "IO", "IT", "JP", "KR", "KY", "MQ", "MS", "MX", "MY", "NC", "NF", "NL", "NO", "NZ", "PF", "PH", "PL", "PM", "PT", "RE", "RO", "RU", "SA", "SE", "SG", "SK", "TC", "TF", "TH", "TK", "TR", "TW", "UA", "US", "VG", "VN", "WF", "YT", "ZA" ] }, "codes1": { "enum": [ "AED", "AFN", "ALL", "AMD", "AOA", "ARS", "AUD", "AWG", "AZN", "BAM", "BBD", "BDT", "BHD", "BIF", "BMD", "BND", "BOB", "BOV", "BRL", "BSD", "BTN", "BWP", "BYN", "BZD", "CAD", "CDF", "CHE", "CHF", "CHW", "CLF", "CLP", "CNY", "COP", "COU", "CRC", "CUP", "CVE", "CZK", "DJF", "DKK", "DOP", "DZD", "EGP", "ERN", "ETB", "EUR", "FJD", "FKP", "GBP", "GEL", "GHS", "GIP", "GMD", "GNF", "GTQ", "GYD", "HKD", "HNL", "HTG", "HUF", "IDR", "ILS", "INR", "IQD", "IRR", "ISK", "JMD", "JOD", "JPY", "KES", "KGS", "KHR", "KMF", "KPW", "KRW", "KWD", "KYD", "KZT", "LAK", "LBP", "LKR", "LRD", "LSL", "LYD", "MAD", "MDL", "MGA", "MKD", "MMK", "MNT", "MOP", "MRU", "MUR", "MVR", "MWK", "MXN", "MXV", "MYR", "MZN", "NAD", "NGN", "NIO", "NOK", "NPR", "NZD", "OMR", "PAB", "PEN", "PGK", "PHP", "PKR", "PLN", "PYG", "QAR", "RON", "RSD", "RUB", "RWF", "SAR", "SBD", "SCR", "SDG", "SEK", "SGD", "SHP", "SLE", "SOS", "SRD", "SSP", "STN", "SVC", "SYP", "SZL", "THB", "TJS", "TMT", "TND", "TOP", "TRY", "TTD", "TWD", "TZS", "UAH", "UGX", "USD", "USN", "UYI", "UYU", "UYW", "UZS", "VED", "VES", … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "sort": { "scope": "retrieved_results", "requested": "best_match", "applied_at": "upstream", "upstream_order_valid": null }, "query": "wireless headphones", "source": { "engine": "google_shopping", "provider": "searchapi", "result_set": "shopping_results", "location_used": "United States" }, "country": "US", "results": [ { "price": 99.99, "title": "Soundcore by Anker Space One Wireless Adaptive Noise Cancelling Over-the-Ear Headphones", "rating": 4.4, "currency": "USD", "retailer": "Best Buy", "condition": null, "image_url": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcTk5WIRStHqQMqSTyxqxEB8gt1Nq7gaZ-5nhRLrKpCm8q1pZjEY1C3OtYJQ0cffpD_pJuA57rUPvUs7UQ9z8-wRw7uYOPtNMgcyRGCKvMKj8vzug-naMylfeg", "product_url": "https://www.google.com/search?ibp=oshop&q=wireless+headphones&prds=catalogid:7204254901795972443,gpcid:15067150910709890119,headlineOfferDocid:5243702224454842866,imageDocid:15025541689179028030,pvo:25,pvt:hg&gl=us&hl=en&udm=28", "availability": { "text": null, "source": null, "status": "unknown" }, "review_count": 633, "currency_source": "country_context", "source_position": 1 } ], "currency": "USD", "limitations": [ "Only organic products from one Google Shopping response are included.", "Availability is unverified; search inclusion does not establish stock.", "Prices may exclude shipping and taxes; installment and ambiguous prices are not compared.", "USD was inferred from dollar price symbols and explicit US localization; product currency_source identifies these values.", "Local filters excluded products with incompatible, unknown, or out-of-range values." ], "result_count": 1, "result_limit": 1, "retrieved_at": "2026-09-20T16:10:15.648486+00:00", "applied_filters": { "country": { "value": "US", "location": "United States", "applied_at": "upstream" }, "currency": { "value": "USD", "applied_at": "local", "excludes_unknown": true }, "condition": null, "max_price": { "value": 100, "applied_at": "upstream_and_local" }, "min_price": null }, "currency_source": "request" } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/402shelf-product-search-fce68e88/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from api.402shelf.com](https://www.zero.xyz/host/api.402shelf.com/llms.txt)