{"slug":"api-402shelf-com-products-search-f1e2e7","title":"Search live products across online retailers by keyword and price range","host":"api.402shelf.com","method":"GET","resource":"https://api.402shelf.com/products/search","category":"commerce","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.","price_listed":0.01,"price_asked":null,"state":"effects","state_label":"Not tested: has real-world effects","checks_7d":0,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":7,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"country":"US","currency":"USD","max_price":100,"query":"wireless headphones","result_limit":1,"sort":"best_match"},"type":"http"},"output_schema":{"$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":[{"additionalProperties":false,"properties":{"applied_at":{"enum":["local","upstream_and_local"]},"value":{"maximum":1000000000,"minimum":0,"type":"number"}},"required":["value","applied_at"],"type":"object"},{"type":"null"}]}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"method":{"enum":["GET"],"type":"string"},"queryParams":{"additionalProperties":false,"properties":{"condition":{"description":"Only used is supported. Omit for any condition; stock remains unverified.","enum":["used"],"examples":["used"],"type":"string"},"country":{"$ref":"#/$defs/codes0","description":"Required supported two-letter country code; selects Google Shopping location.","examples":["US"],"type":"string"},"currency":{"$ref":"#/$defs/codes1","description":"Optional ISO currency filter. No conversion; defaults to the country currency.","examples":["USD"],"type":"string"},"max_price":{"description":"Inclusive maximum comparable product price; must be at least min_price.","examples":[100],"maximum":1000000000,"minimum":0,"type":"number"},"min_price":{"description":"Inclusive minimum comparable product price; excludes tax and shipping.","examples":[25],"maximum":1000000000,"minimum":0,"type":"number"},"query":{"description":"Product search terms; required, 1-500 characters.","examples":["wireless headphones"],"maxLength":500,"minLength":1,"type":"string"},"result_limit":{"description":"Maximum returned products, 1-20; default 10. Zero results is a payable success.","examples":[1],"maximum":20,"minimum":1,"type":"integer"},"sort":{"description":"best_match (default), price_low_to_high or rating_high_to_low; retrieved set only.","enum":["best_match","price_low_to_high","rating_high_to_low"],"examples":["best_match"],"type":"string"}},"required":["query","country"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"additionalProperties":false,"properties":{"applied_filters":{"additionalProperties":false,"properties":{"condition":{"anyOf":[{"additionalProperties":false,"properties":{"applied_at":{"enum":["upstream_and_local"]},"value":{"enum":["used"]}},"required":["value","applied_at"],"type":"object"},{"type":"null"}]},"country":{"additionalProperties":false,"properties":{"applied_at":{"enum":["upstream"]},"location":{"maxLength":300,"type":"string"},"value":{"$ref":"#/$defs/codes0"}},"required":["value","applied_at","location"],"type":"object"},"currency":{"additionalProperties":false,"properties":{"applied_at":{"enum":["local","not_applied"]},"excludes_unknown":{"type":"boolean"},"value":{"$ref":"#/$defs/codes1"}},"required":["value","applied_at","excludes_unknown"],"type":"object"},"max_price":{"$ref":"#/$defs/priceFilter"},"min_price":{"$ref":"#/$defs/priceFilter"}},"required":["country","currency","min_price","max_price","condition"],"type":"object"},"country":{"$ref":"#/$defs/codes0"},"currency":{"$ref":"#/$defs/codes1"},"currency_source":{"enum":["request","country_default"]},"limitations":{"items":{"maxLength":500,"type":"string"},"type":"array"},"query":{"maxLength":500,"type":"string"},"result_count":{"maximum":20,"minimum":0,"type":"integer"},"result_limit":{"maximum":20,"minimum":1,"type":"integer"},"results":{"items":{"additionalProperties":false,"properties":{"availability":{"additionalProperties":false,"description":"Unverified stock is unknown, with null source/text.","properties":{"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"]},"text":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}]}},"required":["status","source","text"],"type":"object"},"condition":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}]},"currency":{"anyOf":[{"$ref":"#/$defs/codes1"},{"type":"null"}]},"currency_source":{"anyOf":[{"enum":["provider","price_text","country_context"]},{"type":"null"}]},"image_url":{"anyOf":[{"format":"uri","maxLength":4096,"pattern":"^https?://","type":"string"},{"type":"null"}]},"price":{"anyOf":[{"maximum":1000000000000000,"minimum":0,"type":"number"},{"type":"null"}],"description":"Numeric price, or null; may exclude tax/shipping."},"product_url":{"anyOf":[{"format":"uri","maxLength":4096,"pattern":"^https?://","type":"string"},{"type":"null"}],"description":"Actual source link; may be Google Shopping, not a retailer checkout URL."},"rating":{"anyOf":[{"maximum":5,"minimum":0,"type":"number"},{"type":"null"}]},"retailer":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"description":"Reported retailer name, or null."},"review_count":{"anyOf":[{"maximum":9007199254740991,"minimum":0,"type":"integer"},{"type":"null"}]},"source_position":{"anyOf":[{"maximum":9007199254740991,"minimum":1,"type":"integer"},{"type":"null"}]},"title":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}]}},"required":["title","price","currency","currency_source","retailer","product_url","image_url","rating","review_count","condition","availability","source_position"],"type":"object"},"maxItems":20,"type":"array"},"retrieved_at":{"format":"date-time","type":"string"},"sort":{"additionalProperties":false,"properties":{"applied_at":{"enum":["upstream","local","upstream_and_local"]},"requested":{"enum":["best_match","price_low_to_high","rating_high_to_low"]},"scope":{"enum":["retrieved_results"]},"upstream_order_valid":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"required":["requested","applied_at","scope","upstream_order_valid"],"type":"object"},"source":{"additionalProperties":false,"description":"Search provider, engine, result set and location.","properties":{"engine":{"enum":["google_shopping"]},"location_used":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}]},"provider":{"enum":["searchapi","fixture"]},"result_set":{"enum":["shopping_results"]}},"required":["provider","engine","result_set","location_used"],"type":"object"}},"required":["query","country","currency","currency_source","applied_filters","sort","result_limit","results","result_count","retrieved_at","source","limitations"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[],"description_full":"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.","last_updated":"2026-09-20T17:20:56.092Z","schemes":["exact"]}