{"uid":"cap_9XEH9dAnsPIdnLRA53Im5","slug":"402shelf-product-search-fce68e88","name":"402Shelf Product Search","description":"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.","url":"https://api.402shelf.com/products/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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","VND","VUV","WST","XAD","XAF","XAG","XAU","XBA","XBB","XBC","XBD","XCD","XCG","XDR","XOF","XPD","XPF","XPT","XSU","XUA","YER","ZAR","ZMW","ZWG"]},"priceFilter":{"anyOf":[{"type":"object","required":["value","applied_at"],"properties":{"value":{"type":"number","maximum":1000000000,"minimum":0},"applied_at":{"enum":["local","upstream_and_local"]}},"additionalProperties":false},{"type":"null"}]}},"$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["query","country"],"properties":{"sort":{"enum":["best_match","price_low_to_high","rating_high_to_low"],"type":"string","examples":["best_match"],"description":"best_match (default), price_low_to_high or rating_high_to_low; retrieved set only."},"query":{"type":"string","examples":["wireless headphones"],"maxLength":500,"minLength":1,"description":"Product search terms; required, 1-500 characters."},"country":{"$ref":"#/$defs/codes0","type":"string","examples":["US"],"description":"Required supported two-letter country code; selects Google Shopping location."},"currency":{"$ref":"#/$defs/codes1","type":"string","examples":["USD"],"description":"Optional ISO currency filter. No conversion; defaults to the country currency."},"condition":{"enum":["used"],"type":"string","examples":["used"],"description":"Only used is supported. Omit for any condition; stock remains unverified."},"max_price":{"type":"number","maximum":1000000000,"minimum":0,"examples":[100],"description":"Inclusive maximum comparable product price; must be at least min_price."},"min_price":{"type":"number","maximum":1000000000,"minimum":0,"examples":[25],"description":"Inclusive minimum comparable product price; excludes tax and shipping."},"result_limit":{"type":"integer","maximum":20,"minimum":1,"examples":[1],"description":"Maximum returned products, 1-20; default 10. Zero results is a payable success."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["query","country","currency","currency_source","applied_filters","sort","result_limit","results","result_count","retrieved_at","source","limitations"],"properties":{"sort":{"type":"object","required":["requested","applied_at","scope","upstream_order_valid"],"properties":{"scope":{"enum":["retrieved_results"]},"requested":{"enum":["best_match","price_low_to_high","rating_high_to_low"]},"applied_at":{"enum":["upstream","local","upstream_and_local"]},"upstream_order_valid":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":false},"query":{"type":"string","maxLength":500},"source":{"type":"object","required":["provider","engine","result_set","location_used"],"properties":{"engine":{"enum":["google_shopping"]},"provider":{"enum":["searchapi","fixture"]},"result_set":{"enum":["shopping_results"]},"location_used":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}]}},"description":"Search provider, engine, result set and location.","additionalProperties":false},"country":{"$ref":"#/$defs/codes0"},"results":{"type":"array","items":{"type":"object","required":["title","price","currency","currency_source","retailer","product_url","image_url","rating","review_count","condition","availability","source_position"],"properties":{"price":{"anyOf":[{"type":"number","maximum":1000000000000000,"minimum":0},{"type":"null"}],"description":"Numeric price, or null; may exclude tax/shipping."},"title":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}]},"rating":{"anyOf":[{"type":"number","maximum":5,"minimum":0},{"type":"null"}]},"currency":{"anyOf":[{"$ref":"#/$defs/codes1"},{"type":"null"}]},"retailer":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"description":"Reported retailer name, or null."},"condition":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"image_url":{"anyOf":[{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},{"type":"null"}]},"product_url":{"anyOf":[{"type":"string","format":"uri","pattern":"^https?://","maxLength":4096},{"type":"null"}],"description":"Actual source link; may be Google Shopping, not a retailer checkout URL."},"availability":{"type":"object","required":["status","source","text"],"properties":{"text":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"source":{"anyOf":[{"enum":["searchapi.google_shopping.shopping_results.availability","searchapi.google_shopping.shopping_results.in_stock"]},{"type":"null"}]},"status":{"enum":["in_stock","out_of_stock","preorder","unknown"]}},"description":"Unverified stock is unknown, with null source/text.","additionalProperties":false},"review_count":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":0},{"type":"null"}]},"currency_source":{"anyOf":[{"enum":["provider","price_text","country_context"]},{"type":"null"}]},"source_position":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":1},{"type":"null"}]}},"additionalProperties":false},"maxItems":20},"currency":{"$ref":"#/$defs/codes1"},"limitations":{"type":"array","items":{"type":"string","maxLength":500}},"result_count":{"type":"integer","maximum":20,"minimum":0},"result_limit":{"type":"integer","maximum":20,"minimum":1},"retrieved_at":{"type":"string","format":"date-time"},"applied_filters":{"type":"object","required":["country","currency","min_price","max_price","condition"],"properties":{"country":{"type":"object","required":["value","applied_at","location"],"properties":{"value":{"$ref":"#/$defs/codes0"},"location":{"type":"string","maxLength":300},"applied_at":{"enum":["upstream"]}},"additionalProperties":false},"currency":{"type":"object","required":["value","applied_at","excludes_unknown"],"properties":{"value":{"$ref":"#/$defs/codes1"},"applied_at":{"enum":["local","not_applied"]},"excludes_unknown":{"type":"boolean"}},"additionalProperties":false},"condition":{"anyOf":[{"type":"object","required":["value","applied_at"],"properties":{"value":{"enum":["used"]},"applied_at":{"enum":["upstream_and_local"]}},"additionalProperties":false},{"type":"null"}]},"max_price":{"$ref":"#/$defs/priceFilter"},"min_price":{"$ref":"#/$defs/priceFilter"}},"additionalProperties":false},"currency_source":{"enum":["request","country_default"]}},"additionalProperties":false}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.40","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":{"p10Cents":"0.1000","medianCents":"0.1000","p90Cents":"0.1000","minCents":"0.1000","maxCents":"0.1000","p95Cents":"0.1000","sampleCount":2,"varies":false,"failureChargeRate":null},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-ByKpxHrL62jTc01BfI-y","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search live products across online retailers by keyword and price range, returning product names, prices, retailers, and purchase links.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Gift shopping within a budget","prompt":"I need to buy a birthday gift — find me options for 'leather wallet' between $30 and $80 USD available in the US, and give me direct links to buy them."},{"title":"Finding cheapest laptop deals","prompt":"Search for 'gaming laptop' and filter results to anything priced under $1000 in USD for the US market — I want to see prices and retailer names."},{"title":"Sourcing products for a specific region","prompt":"Can you find 'yoga mat' products priced between $20 and $60 AUD available in Australia, and list the retailers and purchase links?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":5,"lastUsedAt":"2026-09-25T05:11:42.325Z","lastSuccessfullyRanAt":"2026-09-25T05:11:42.325Z","lastHealthCheckAt":"2026-10-02T00:56:09.416Z","isFirstParty":false,"canonicalSlug":"402shelf-product-search-fce68e88"}