{"openapi":"3.1.0","info":{"title":"Agent Shopping API","description":"\nAI-native product intelligence API for search, filtering, ranking, and enrichment.\n\n## Typical Workflow\n\n`search → filter → rank → product-details`\n\nOr use the one-shot endpoint:\n\n`best`\n\n### 1. Search\nFind products using natural language queries.\n\n### 2. Filter\nApply constraints like price, rating, sponsorship, review count, and delivery speed.\n\n### 3. Rank\nOptimize results using modes like `best_value`, `lowest_price`, `best_reviews`, `fastest_shipping`, or `relevance`.\n\n### 4. Product Details\nExtract full structured product page intelligence from a product URL, including:\n- pricing and discount signals\n- seller and fulfillment metadata\n- stock availability\n- warranty and return policy\n- detailed specifications and feature sections\n- review analytics including rating histograms\n\n### 5. Best\nRun the full workflow in one call using a query plus ranking priorities.\nReturns the top 3 products with:\n- explanation of why they ranked highest\n- structured product data\n- ranking metadata\n\n## Pricing\n\n- `/search` → `$0.003`\n- `/filter` → `$0.003`\n- `/rank` → `$0.003`\n- `/product-details` → `$0.010`\n- `/best` → `$0.020`\n\n## Payment Model\n\n- No API key required\n- Pay per request via x402\n- Designed for AI agents and automation workflows\n","version":"0.1.0","x-logo":{"url":"https://api.hashcats.io/logo.png"}},"paths":{"/search":{"post":{"tags":["shopping"],"summary":"Search products","description":"Search Amazon products using natural language queries. Returns structured product data including price, ratings, reviews, delivery estimates, sponsored vs organic, and product URLs.","operationId":"search_route_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"},"example":{"query":"noise cancelling headphones under 200","limit":5}}},"required":true},"responses":{"200":{"description":"Structured search results","content":{"application/json":{"schema":{},"example":[{"source":"Amazon","title":"Hybrid Active Noise Cancelling Bluetooth Headphones,Bluetooth 6.0 Over Ear Wireless Headphones with 60H Playtime, Hi-Res Audio, Deep Bass, Memory Foam Ear Cups for Home Office Travel Black","description":"Hybrid Active Noise Cancelling Bluetooth Headphones,Bluetooth 6.0 Over Ear Wireless Headphones with 60H Playtime, Hi-Res Audio, Deep Bass, Memory Foam Ear Cups for Home Office Travel Black","product_url":"https://www.amazon.com/dp/B0GLNV4LJ9","is_sponsored":false,"reviews":{"rating_text":"4.8 out of 5 stars","rating_value":4.8,"review_count":520},"price":{"current_price_text":"$29.99","current_price_value":29.99,"list_price_text":"$299.99","list_price_value":299.99},"delivery":{"raw":"FREE delivery Sat, Apr 11 on $35 of items shipped by Amazon Or fastest delivery Wed, Apr 8","free":{"text":"Sat, Apr 11","date":"2026-04-11","min_order_for_free_shipping":35.0},"fastest":{"text":"Wed, Apr 8","date":"2026-04-08"},"other":[]},"image_url":"https://m.media-amazon.com/images/I/61HmhAnkfoL._AC_UY218_.jpg"}]}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/filter":{"post":{"tags":["shopping"],"summary":"Filter products","description":"Filter product lists based on criteria such as price range, rating, review count, sponsorship status, and delivery speed.","operationId":"filter_route_filter_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilterRequest"},"example":{"products":[{"source":"Amazon","title":"Hybrid Active Noise Cancelling Bluetooth Headphones,Bluetooth 6.0 Over Ear Wireless Headphones with 60H Playtime, Hi-Res Audio, Deep Bass, Memory Foam Ear Cups for Home Office Travel Black","description":"Hybrid Active Noise Cancelling Bluetooth Headphones,Bluetooth 6.0 Over Ear Wireless Headphones with 60H Playtime, Hi-Res Audio, Deep Bass, Memory Foam Ear Cups for Home Office Travel Black","product_url":"https://www.amazon.com/dp/B0GLNV4LJ9","is_sponsored":false,"reviews":{"rating_text":"4.8 out of 5 stars","rating_value":4.8,"review_count":520},"price":{"current_price_text":"$29.99","current_price_value":29.99,"list_price_text":"$299.99","list_price_value":299.99},"delivery":{"raw":"FREE delivery Sat, Apr 11 on $35 of items shipped by Amazon Or fastest delivery Wed, Apr 8","free":{"text":"Sat, Apr 11","date":"2026-04-11","min_order_for_free_shipping":35.0},"fastest":{"text":"Wed, Apr 8","date":"2026-04-08"},"other":[]},"image_url":"https://m.media-amazon.com/images/I/61HmhAnkfoL._AC_UY218_.jpg"}],"exclude_sponsored":true,"max_price":200,"min_rating":4.0}}},"required":true},"responses":{"200":{"description":"Filtered product results","content":{"application/json":{"schema":{},"example":{"count_in":5,"count_out":5,"count_excluded":0,"results":[{"source":"Amazon","title":"Hybrid Active Noise Cancelling Bluetooth Headphones,Bluetooth 6.0 Over Ear Wireless Headphones with 60H Playtime, Hi-Res Audio, Deep Bass, Memory Foam Ear Cups for Home Office Travel Black","description":"Hybrid Active Noise Cancelling Bluetooth Headphones,Bluetooth 6.0 Over Ear Wireless Headphones with 60H Playtime, Hi-Res Audio, Deep Bass, Memory Foam Ear Cups for Home Office Travel Black","product_url":"https://www.amazon.com/dp/B0GLNV4LJ9","is_sponsored":false,"reviews":{"rating_text":"4.8 out of 5 stars","rating_value":4.8,"review_count":520},"price":{"current_price_text":"$29.99","current_price_value":29.99,"list_price_text":"$299.99","list_price_value":299.99},"delivery":{"raw":"FREE delivery Sat, Apr 11 on $35 of items shipped by Amazon Or fastest delivery Wed, Apr 8","free":{"text":"Sat, Apr 11","date":"2026-04-11","min_order_for_free_shipping":35.0},"fastest":{"text":"Wed, Apr 8","date":"2026-04-08"},"other":[]},"image_url":"https://m.media-amazon.com/images/I/61HmhAnkfoL._AC_UY218_.jpg"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/rank":{"post":{"tags":["shopping"],"summary":"Rank products","description":"Rank products using optimization modes like best_value, lowest_price, best_reviews, fastest_shipping, or relevance.","operationId":"rank_route_rank_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RankRequest"},"example":{"products":[{"source":"Amazon","title":"Hybrid Active Noise Cancelling Bluetooth Headphones,Bluetooth 6.0 Over Ear Wireless Headphones with 60H Playtime, Hi-Res Audio, Deep Bass, Memory Foam Ear Cups for Home Office Travel Black","description":"Hybrid Active Noise Cancelling Bluetooth Headphones,Bluetooth 6.0 Over Ear Wireless Headphones with 60H Playtime, Hi-Res Audio, Deep Bass, Memory Foam Ear Cups for Home Office Travel Black","product_url":"https://www.amazon.com/dp/B0GLNV4LJ9","is_sponsored":false,"reviews":{"rating_text":"4.8 out of 5 stars","rating_value":4.8,"review_count":520},"price":{"current_price_text":"$29.99","current_price_value":29.99,"list_price_text":"$299.99","list_price_value":299.99},"delivery":{"raw":"FREE delivery Sat, Apr 11 on $35 of items shipped by Amazon Or fastest delivery Wed, Apr 8","free":{"text":"Sat, Apr 11","date":"2026-04-11","min_order_for_free_shipping":35.0},"fastest":{"text":"Wed, Apr 8","date":"2026-04-08"},"other":[]},"image_url":"https://m.media-amazon.com/images/I/61HmhAnkfoL._AC_UY218_.jpg"}],"rank_by":"best_value"}}},"required":true},"responses":{"200":{"description":"Ranked product results","content":{"application/json":{"schema":{},"example":{"rank_by":"best_value","count_in":3,"count_out":3,"results":[{"rank":1,"product_id":"https://www.amazon.com/dp/B0CFGVDDH6","title":"KVIDIO Active Noise Cancelling Headphones, 70 Hours Playtime Bluetooth Headphones Wireless with Microphone, Transparency Mode, Deep Bass and Hi-Fi Stereo Sound Over Ear for Travel Office","score":0.6175,"score_breakdown":{"relevance_score":0.0,"price_score":0.94,"shipping_score":1.0,"review_score":0.93,"in_stock_bonus":0.0,"sponsored_penalty":0.0},"reasons":["Strong reviews: 4.5/5 from 14000 reviews","Organic listing"],"product":{"source":"Amazon","title":"KVIDIO Active Noise Cancelling Headphones, 70 Hours Playtime Bluetooth Headphones Wireless with Microphone, Transparency Mode, Deep Bass and Hi-Fi Stereo Sound Over Ear for Travel Office","description":"KVIDIO Active Noise Cancelling Headphones, 70 Hours Playtime Bluetooth Headphones Wireless with Microphone, Transparency Mode, Deep Bass and Hi-Fi Stereo Sound Over Ear for Travel Office","product_url":"https://www.amazon.com/dp/B0CFGVDDH6","is_sponsored":false,"reviews":{"rating_text":"4.5 out of 5 stars","rating_value":4.5,"review_count":14000},"price":{"current_price_text":"$22.99","current_price_value":22.99,"list_price_text":"$29.99","list_price_value":29.99},"delivery":{"raw":"FREE delivery Sat, Apr 11 on $35 of items shipped by Amazon Or fastest delivery Tomorrow, Apr 7","free":{"text":"Sat, Apr 11","date":"2026-04-11","min_order_for_free_shipping":35.0},"fastest":{"text":"Tomorrow, Apr 7","date":"2026-04-07"},"other":[]},"image_url":"https://m.media-amazon.com/images/I/61BcRmV5jdL._AC_UY218_.jpg"}}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/product-details":{"post":{"tags":["shopping"],"summary":"Extract product details","description":"Extract full product page intelligence from product URLs. Returns deeply structured data including specifications, feature sections, pricing and discount signals, seller and fulfillment metadata, stock availability, warranty and return policies, and advanced review analytics such as rating distributions and histograms.","operationId":"product_details_route_product_details_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDetailsRequest"},"example":{"url":"https://www.amazon.com/dp/B0GLNV4LJ9"}}},"required":true},"responses":{"200":{"description":"Structured product page intelligence","content":{"application/json":{"schema":{},"example":{"source":"Amazon","title":"Hybrid Active Noise Cancelling Bluetooth Headphones,Bluetooth 6.0 Over Ear Wireless Headphones with 60H Playtime, Hi-Res Audio, Deep Bass, Memory Foam Ear Cups for Home Office Travel Black","product_url":"https://www.amazon.com/dp/B0GLNV4LJ9","description":"All-Day Comfort & Premium Design: Crafted with high-quality materials, these over-ear wireless headphones combine luxury with long-wearing comfort. The adjustable headband ensures a secure fit for all head sizes, while ultra-soft memory foam ear cups minimize pressure. Lightweight and ergonomic, they’re ideal for work, travel, or leisure—keeping you comfortable even during extended use. Unbeatable 60-Hour Battery Life: Enjoy up to 60 hours of playtime in standard mode at moderate volume. A quick 5-minute charge provides 4 extra hours—perfect for emergencies. Whether binge-watching, commuting, or working, these headphones/earbuds deliver uninterrupted performance without frequent recharging. Bluetooth 6.0 & Seamless Connectivity: Advanced Bluetooth 6.0 ensures stable, high-speed pairing with smartphones, tablets, or laptops. Experience crisp audio streaming, low latency, and reliable connectivity for calls, music, or movies. The auto-connect feature allows hassle-free use anytime, anywhere. Advanced Active Noise Cancellation: Immerse yourself in pure sound with next-generation ANC, eliminating up to 95% of ambient noise. Dual-microphone hybrid ANC detects and neutralizes external sounds across a wide frequency range 20Hz-20kHz, creating a distraction-free environment whether you're traveling or working. Powerful Bass & Crystal-Clear Calls: Precision-tuned drivers deliver deep, punchy bass for an immersive listening experience. The built-in high-sensitivity microphone, enhanced by wind resistance and AI clarity, ensures professional-grade call quality—perfect for music lovers and busy professionals alike. › See more product details","reviews":{"rating_text":"4.8 out of 5","rating_value":4.8,"review_count":520,"histogram":{"5_star":{"value":90,"text":"90%"},"4_star":{"value":4,"text":"4%"},"3_star":{"value":3,"text":"3%"},"2_star":{"value":1,"text":"1%"},"1_star":{"value":2,"text":"2%"}}},"price":{"current_text":"$299.99","current_value":299.99,"discount_text":"-90%","discount_percent":-90},"is_in_stock":{"text":"In Stock","in_stock":true},"offer_display":{"ships_from":{"text":"Amazon"},"sold_by":{"text":"MMWOWARTS-US-LDJY","link":"https://www.amazon.com/gp/help/seller/at-a-glance.html/ref=dp_merchant_link?ie=UTF8&seller=A3JYEOGJRLCH54&asin=B0GLNV4LJ9&ref_=dp_merchant_link&isAmazonFulfilled=1"},"returns":{"text":"FREE 30-day refund/replacement"}},"brand":{"name":"Brand: MMWOWARTS","link":"https://www.amazon.com/s/ref=bl_dp_s_web_0?ie=UTF8&search-alias=aps&field-keywords=MMWOWARTS"},"general_product_details":{"Brand":"MMWOWARTS","Color":"Black","Ear Placement":"On Ear","Form Factor":"Over Ear","Noise Control":"Active Noise Cancellation"},"detail_sections":{"Item details":{"Brand Name":"MMWOWARTS","Model Number":"B0GLNV4LJ9","Model Name":"B0GLNV4LJ9","Built-In Media":"Hybrid Active Noise Cancelling Headphones, Owner's Manual, Type-C Cable","Age Range Description":"Adult,Teen, Kid","Customer Package Type":"Standard Packaging","Manufacturer":"MMWOWARTS","Warranty Description":"90 Day Manufacturer","Best Sellers Rank":"#725 in Electronics ( See Top 100 in Electronics ) #38 in Over-Ear Headphones","ASIN":"B0GLNV4LJ9","Customer Reviews":"4.8 4.8 out of 5 stars (520) 4.8 out of 5 stars"},"Design":{"Headphones Ear Placement":"On Ear","Headphone Folding Features":"Over Ear","Earpiece Shape":"over-ear"},"Style":{"Color":"Black","Style Name":"Classic"},"Measurements":{"Unit Count":"1.0 Count"},"Audio":{"Noise Control":"Active Noise Cancellation","Frequency Range":"20Hz-20kHz","Audio Driver Type":"Dynamic Driver"},"Additional details":{"Additional Features":"Noise Cancellation, Portable","Enclosure Material":"Plastic,Memory Foam","Specific Uses For Product":"Sports, Workouts, Running, Fitness, Travel, Cycling, Gym, Outdoor, Music, Entertainment, TV Series, Gaming, Office Meetings, Professional, School","Antenna Location":"Sports, Workouts, Running, Fitness, Travel, Cycling, Gym, Outdoor, Music, Entertainment, TV Series, Gaming, Office Meetings, Professional, School","Compatible Devices":"Smartphones, Tablets, Laptops, Telephones","Water Resistance Level":"Waterproof"},"Connectivity":{"Headphone Jack":"No Jack","Connectivity Technology":"Hybrid","Wireless Technology":"Bluetooth","Bluetooth Range":"10 Meters","Bluetooth Version":"6.0"},"Controls":{"Control Type":"Button Control","Control Method":"Push Button","Controller Type":"Button"},"Battery":{"Battery Charge Time":"5 minutes","Battery Average Life":"60 Hours"}},"warranty":{"raw_text":"Warranty & Support Amazon.com Return Policy : Amazon.com Voluntary 30-Day Return Guarantee: You can return many items you have purchased within 30 days following delivery of the item to you. Our Voluntary 30-Day Return Guarantee does not affect your legal right of withdrawal in any way. You can find out more about the exceptions and conditions here . Product Warranty: For warranty information about this product, please click here","return_policy":"Amazon.com Return Policy : Amazon.com Voluntary 30-Day Return Guarantee: You can return many items you have purchased within 30 days following delivery of the item to you. Our Voluntary 30-Day Return Guarantee does not affect your legal right of withdrawal in any way. You can find out more about the exceptions and conditions here .","product_warranty":"Warranty & Support Amazon.com Return Policy : Amazon.com Voluntary 30-Day Return Guarantee: You can return many items you have purchased within 30 days following delivery of the item to you. Our Voluntary 30-Day Return Guarantee does not affect your legal right of withdrawal in any way. You can find out more about the exceptions and conditions here . Product Warranty: For warranty information about this product, please click here","links":[{"text":"here","href":"https://www.amazon.com/gp/help/customer/display.html/ref=orc_hp_s_retpol?ie=UTF8&nodeId=201819200"},{"text":"click here","href":"https://www.amazon.com/gp/feature.html/ref=dp_warranty_request_3P?docId=1002406021"}]}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/best":{"post":{"tags":["shopping"],"summary":"Get the best 3 products","description":"Searches products, applies your priorities as constraints, ranks the remaining matches, and returns the best results with explanations and structured product data.","operationId":"best_route_best_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BestRequest"},"example":{"query":"noise cancelling headphones","priorities":{"max_price":200,"min_review_count":100,"min_rating":4.0,"ship_within_days":5}}}},"required":true},"responses":{"200":{"description":"Top 3 products","content":{"application/json":{"schema":{},"example":{"query":"noise cancelling headphones under 200","priorities":{"max_price":200.0,"min_review_count":100,"min_rating":4.0,"ship_within_days":5},"rank_by":"best_value","count_in":10,"count_considered":7,"top_3":[{"rank":1,"product_id":"https://www.amazon.com/dp/B0BKPRTRXK","title":"RUNOLIM Hybrid Active Noise Cancelling Headphones, Wireless Over Ear Bluetooth Headphones with Microphone, 70H Playtime, Foldable Headphone with HiFi Audio, Deep Bass for Home Travel Office","score":0.9354,"score_breakdown":{"relevance_score":1.0,"price_score":0.8364,"shipping_score":1.0,"review_score":0.9053,"in_stock_bonus":0.0,"sponsored_penalty":0.0},"reasons":["Strong match for 'noise cancelling headphones under 200' across product fields","Strong reviews: 4.4/5 from 7200 reviews","Organic listing"],"product":{"source":"Amazon","title":"RUNOLIM Hybrid Active Noise Cancelling Headphones, Wireless Over Ear Bluetooth Headphones with Microphone, 70H Playtime, Foldable Headphone with HiFi Audio, Deep Bass for Home Travel Office","description":"RUNOLIM Hybrid Active Noise Cancelling Headphones, Wireless Over Ear Bluetooth Headphones with Microphone, 70H Playtime, Foldable Headphone with HiFi Audio, Deep Bass for Home Travel Office","product_url":"https://www.amazon.com/dp/B0BKPRTRXK","is_sponsored":false,"reviews":{"rating_text":"4.4 out of 5 stars","rating_value":4.4,"review_count":7200},"price":{"current_price_text":"$21.58","current_price_value":21.58,"list_price_text":"$29.99","list_price_value":29.99},"delivery":{"raw":"FREE delivery Thu, Apr 23 on $35 of items shipped by Amazon Or fastest delivery Tomorrow, Apr 19","free":{"text":"Thu, Apr 23","date":"2026-04-23","min_order_for_free_shipping":35.0},"fastest":{"text":"Tomorrow, Apr 19","date":"2026-04-19"},"other":[]},"image_url":"https://m.media-amazon.com/images/I/6162JJuKpbL._AC_UY218_.jpg"}},{"rank":2,"product_id":"https://www.amazon.com/dp/B0F28LGLNS","title":"Active Noise Cancelling Headphones, Upgraded Wireless Bluetooth Headphones Over Ear with ENC Mic, HiFi Stereo Deep Bass, Noise Canceling Headphones Lightweight, BT 5.4, for Travel/Office/Home, Black","score":0.9321,"score_breakdown":{"relevance_score":1.0,"price_score":0.9096,"shipping_score":1.0,"review_score":0.819,"in_stock_bonus":0.0,"sponsored_penalty":0.0},"reasons":["Strong match for 'noise cancelling headphones under 200' across product fields","Strong reviews: 4.3/5 from 781 reviews","Organic listing"],"product":{"source":"Amazon","title":"Active Noise Cancelling Headphones, Upgraded Wireless Bluetooth Headphones Over Ear with ENC Mic, HiFi Stereo Deep Bass, Noise Canceling Headphones Lightweight, BT 5.4, for Travel/Office/Home, Black","description":"Active Noise Cancelling Headphones, Upgraded Wireless Bluetooth Headphones Over Ear with ENC Mic, HiFi Stereo Deep Bass, Noise Canceling Headphones Lightweight, BT 5.4, for Travel/Office/Home, Black","product_url":"https://www.amazon.com/dp/B0F28LGLNS","is_sponsored":false,"reviews":{"rating_text":"4.3 out of 5 stars","rating_value":4.3,"review_count":781},"price":{"current_price_text":"$19.97","current_price_value":19.97,"list_price_text":"$23.99","list_price_value":23.99},"delivery":{"raw":"FREE delivery Thu, Apr 23 on $35 of items shipped by Amazon Or fastest delivery Tomorrow, Apr 19","free":{"text":"Thu, Apr 23","date":"2026-04-23","min_order_for_free_shipping":35.0},"fastest":{"text":"Tomorrow, Apr 19","date":"2026-04-19"},"other":[]},"image_url":"https://m.media-amazon.com/images/I/71YM2N5whtL._AC_UY218_.jpg"}},{"rank":3,"product_id":"https://www.amazon.com/dp/B0FWJY183S","title":"Upgraded Pro‑level Hybrid Active Noise Cancelling Headphones, HD Sound & Big Bass, 2X Softer Comfort, Long ANC Playtime, Wireless Over-Ear Bluetooth Headphones Perfect for Home Office|Travel|Pair","score":0.8617,"score_breakdown":{"relevance_score":1.0,"price_score":0.6365,"shipping_score":1.0,"review_score":0.8103,"in_stock_bonus":0.0,"sponsored_penalty":0.0},"reasons":["Strong match for 'noise cancelling headphones under 200' across product fields","Strong reviews: 4.6/5 from 164 reviews","Organic listing"],"product":{"source":"Amazon","title":"Upgraded Pro‑level Hybrid Active Noise Cancelling Headphones, HD Sound & Big Bass, 2X Softer Comfort, Long ANC Playtime, Wireless Over-Ear Bluetooth Headphones Perfect for Home Office|Travel|Pair","description":"Upgraded Pro‑level Hybrid Active Noise Cancelling Headphones, HD Sound & Big Bass, 2X Softer Comfort, Long ANC Playtime, Wireless Over-Ear Bluetooth Headphones Perfect for Home Office|Travel|Pair","product_url":"https://www.amazon.com/dp/B0FWJY183S","is_sponsored":false,"reviews":{"rating_text":"4.6 out of 5 stars","rating_value":4.6,"review_count":164},"price":{"current_price_text":"$25.98","current_price_value":25.98,"list_price_text":"$29.99","list_price_value":29.99},"delivery":{"raw":"FREE delivery Thu, Apr 23 on $35 of items shipped by Amazon Or fastest delivery Tomorrow, Apr 19","free":{"text":"Thu, Apr 23","date":"2026-04-23","min_order_for_free_shipping":35.0},"fastest":{"text":"Tomorrow, Apr 19","date":"2026-04-19"},"other":[]},"image_url":"https://m.media-amazon.com/images/I/71ZAuqZTFTL._AC_UY218_.jpg"}}],"explanation":{"summary":"Selected the top products for 'noise cancelling headphones under 200' by applying these priorities: max_price=200.0, min_review_count=100, min_rating=4.0, ship_within_days=5.","ranking_logic":"Used best_value after filtering by the requested priorities.","notes":["Products were filtered first, then ranked.","Only the top results are returned."]}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/health":{"get":{"tags":["system"],"summary":"Healthcheck","operationId":"healthcheck_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/":{"get":{"tags":["system"],"summary":"Root","operationId":"root__get","responses":{"200":{"description":"API metadata and endpoint overview","content":{"application/json":{"schema":{},"example":{"name":"Agent Shopping API","version":"0.1.0","description":"Composable product intelligence API for AI agents.","base_url":"https://api.hashcats.io","capabilities":["search_products","filter_products","rank_products","extract_product_details","best_products"],"workflow":["search","filter","rank","product-details"],"endpoints":{"/search":{"method":"POST","input":{"query":"string","limit":"integer"},"output":"list[product]","price":0.003},"/filter":{"method":"POST","input":{"products":"list[product]","max_price":"float","min_rating":"float","exclude_sponsored":"bool"},"output":"filtered list[product]","price":0.003},"/rank":{"method":"POST","input":{"products":"list[product]","rank_by":"string"},"output":"ranked list[product]","price":0.003},"/product-details":{"method":"POST","input":{"url":"string"},"output":"structured product intelligence","price":0.01},"/best":{"method":"POST","input":{"query":"string","priorities":{"max_price":"float | None","min_review_count":"int | None","min_rating":"float | None","ship_within_days":"int | None"}},"output":"top 3 products with explanation and structured product data","price":0.02}},"pricing_model":{"type":"x402","currency":"USD","per_request":true},"authentication":{"type":"x402","api_key_required":false},"docs_url":"https://api.hashcats.io/docs","openapi_url":"https://api.hashcats.io/openapi.json","example_flow":{"step_1":{"endpoint":"/search"},"step_2":{"endpoint":"/filter"},"step_3":{"endpoint":"/rank"},"step_4":{"endpoint":"/product-details"}},"shortcut_endpoints":{"/best":{"description":"Runs search, filter, and rank internally, then returns the top 3 products with explanation and structured data."}}}}}}}}}},"components":{"schemas":{"BestPriorities":{"properties":{"max_price":{"anyOf":[{"type":"number","maximum":100000.0,"minimum":0.0},{"type":"null"}],"title":"Max Price"},"min_review_count":{"anyOf":[{"type":"integer","maximum":1000000.0,"minimum":0.0},{"type":"null"}],"title":"Min Review Count"},"min_rating":{"anyOf":[{"type":"number","maximum":5.0,"minimum":0.0},{"type":"null"}],"title":"Min Rating"},"ship_within_days":{"anyOf":[{"type":"integer","maximum":30.0,"minimum":0.0},{"type":"null"}],"title":"Ship Within Days"}},"type":"object","title":"BestPriorities"},"BestRequest":{"properties":{"query":{"type":"string","maxLength":200,"minLength":1,"title":"Query"},"priorities":{"$ref":"#/components/schemas/BestPriorities"}},"type":"object","required":["query","priorities"],"title":"BestRequest","example":{"priorities":{"max_price":200,"min_rating":4.0,"min_review_count":100,"ship_within_days":5},"query":"noise cancelling headphones"}},"FilterRequest":{"properties":{"products":{"items":{"additionalProperties":true,"type":"object"},"type":"array","maxItems":100,"minItems":1,"title":"Products"},"in_stock":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"In Stock"},"is_sponsored":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Sponsored"},"min_price":{"anyOf":[{"type":"number","maximum":100000.0,"minimum":0.0},{"type":"null"}],"title":"Min Price"},"max_price":{"anyOf":[{"type":"number","maximum":100000.0,"minimum":0.0},{"type":"null"}],"title":"Max Price"},"min_rating":{"anyOf":[{"type":"number","maximum":5.0,"minimum":0.0},{"type":"null"}],"title":"Min Rating"},"min_review_count":{"anyOf":[{"type":"integer","maximum":1000000.0,"minimum":0.0},{"type":"null"}],"title":"Min Review Count"},"ship_within_days":{"anyOf":[{"type":"integer","maximum":30.0,"minimum":0.0},{"type":"null"}],"title":"Ship Within Days"},"related_to":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Related To"},"min_relevance_score":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Min Relevance Score"}},"type":"object","required":["products"],"title":"FilterRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ProductDetailsRequest":{"properties":{"url":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Url"},"urls":{"anyOf":[{"items":{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},"type":"array","maxItems":10},{"type":"null"}],"title":"Urls"},"include_errors":{"type":"boolean","title":"Include Errors","default":false}},"type":"object","title":"ProductDetailsRequest"},"RankRequest":{"properties":{"products":{"items":{"additionalProperties":true,"type":"object"},"type":"array","maxItems":100,"minItems":1,"title":"Products"},"rank_by":{"type":"string","enum":["relevance","lowest_price","fastest_shipping","best_reviews","best_value"],"title":"Rank By"},"related_to":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Related To"},"limit":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":1.0},{"type":"null"}],"title":"Limit"}},"type":"object","required":["products","rank_by"],"title":"RankRequest"},"SearchRequest":{"properties":{"query":{"type":"string","maxLength":200,"minLength":1,"title":"Query"},"limit":{"type":"integer","maximum":25.0,"minimum":1.0,"title":"Limit","default":10}},"type":"object","required":["query"],"title":"SearchRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}