{"openapi":"3.1.0","info":{"title":"StableNinja","description":"x402 access to selected OpenWebNinja APIs not already covered by existing Stables.","version":"0.1.0","x-guidance":"# StableNinja API\n\nStableNinja wraps selected OpenWebNinja data APIs with x402 pay-per-request access. Callers do not need an OpenWebNinja or RapidAPI account.\n\nBase URL: https://stableninja.dev\n\nAll data endpoints cost $0.01 per successful call via x402 on Base.\n\n## Use StableNinja For\n\n- Waze live traffic alerts, jams, venues, and place autocomplete.\n- Google Play Store app search, details, reviews, categories, and charts.\n- Yelp business search, details, and reviews.\n- Walmart product search/details/reviews and Wayfair product search/details.\n- Amazon product search/details/reviews/offers, best sellers, and deals.\n\n## Use Other Stables Instead\n\n- Product recommendations, Wirecutter picks, or Channel3 catalog data: use StableProducts.\n- Jobs: use StableJobs.\n- Zillow/Redfin/general real estate: use StableEstate.\n- Glassdoor or Trustpilot summaries: use existing employer/review endpoints.\n- Video search: use existing video search or extraction endpoints.\n\n## Waze Happy Path\n\n1. Use GET /api/waze/autocomplete with q and coordinates to resolve a place-like query.\n2. Use GET /api/waze/alerts-and-jams with bottom_left and top_right, or center and radius, to inspect live incidents in an area.\n3. Use GET /api/waze/venues with bottom_left and top_right to list Waze venues in a map area.\n\nCoordinate pairs are strings formatted as \"latitude,longitude\".\n\n## Play Store Happy Path\n\n1. Use GET /api/play-store-apps/search with q to find Android apps.\n2. Use app_id from search results with GET /api/play-store-apps/app-details.\n3. Use GET /api/play-store-apps/app-reviews for reviews; pass cursor for pagination.\n4. Use chart endpoints such as /api/play-store-apps/top-free-apps or /api/play-store-apps/top-grossing-games for ranked lists.\n\n## Yelp Happy Path\n\n1. Use GET /api/yelp/business-search with query and location.\n2. Use business_id from search results with GET /api/yelp/business-details.\n3. Use GET /api/yelp/business-reviews for paginated reviews.\n\n## Walmart Happy Path\n\n1. Use GET /api/walmart/search with query, or /api/walmart/products-by-category with category_id.\n2. Use product_id from results with /api/walmart/product-details.\n3. Use /api/walmart/product-offers for seller offers and /api/walmart/product-reviews for reviews.\n\n## Wayfair Happy Path\n\n1. Use GET /api/wayfair/search with query, category_id, or manufacturer_id.\n2. Use sku from results with /api/wayfair/product-details.\n\n## Amazon Happy Path\n\n1. Use GET /api/amazon/search with query and optional country/page to find products.\n2. Use asin from search results with GET /api/amazon/product-details for current price, availability, media, variants, and product facts.\n3. Use GET /api/amazon/product-reviews for customer reviews; pass page, sort_by, star_rating, or verified_purchases_only when needed.\n4. Use GET /api/amazon/product-offers for seller offers and buying options.\n5. Use GET /api/amazon/best-sellers with category for ranked products, or GET /api/amazon/todays-deals for current deals.\n","guidance":"# StableNinja API\n\nStableNinja wraps selected OpenWebNinja data APIs with x402 pay-per-request access. Callers do not need an OpenWebNinja or RapidAPI account.\n\nBase URL: https://stableninja.dev\n\nAll data endpoints cost $0.01 per successful call via x402 on Base.\n\n## Use StableNinja For\n\n- Waze live traffic alerts, jams, venues, and place autocomplete.\n- Google Play Store app search, details, reviews, categories, and charts.\n- Yelp business search, details, and reviews.\n- Walmart product search/details/reviews and Wayfair product search/details.\n- Amazon product search/details/reviews/offers, best sellers, and deals.\n\n## Use Other Stables Instead\n\n- Product recommendations, Wirecutter picks, or Channel3 catalog data: use StableProducts.\n- Jobs: use StableJobs.\n- Zillow/Redfin/general real estate: use StableEstate.\n- Glassdoor or Trustpilot summaries: use existing employer/review endpoints.\n- Video search: use existing video search or extraction endpoints.\n\n## Waze Happy Path\n\n1. Use GET /api/waze/autocomplete with q and coordinates to resolve a place-like query.\n2. Use GET /api/waze/alerts-and-jams with bottom_left and top_right, or center and radius, to inspect live incidents in an area.\n3. Use GET /api/waze/venues with bottom_left and top_right to list Waze venues in a map area.\n\nCoordinate pairs are strings formatted as \"latitude,longitude\".\n\n## Play Store Happy Path\n\n1. Use GET /api/play-store-apps/search with q to find Android apps.\n2. Use app_id from search results with GET /api/play-store-apps/app-details.\n3. Use GET /api/play-store-apps/app-reviews for reviews; pass cursor for pagination.\n4. Use chart endpoints such as /api/play-store-apps/top-free-apps or /api/play-store-apps/top-grossing-games for ranked lists.\n\n## Yelp Happy Path\n\n1. Use GET /api/yelp/business-search with query and location.\n2. Use business_id from search results with GET /api/yelp/business-details.\n3. Use GET /api/yelp/business-reviews for paginated reviews.\n\n## Walmart Happy Path\n\n1. Use GET /api/walmart/search with query, or /api/walmart/products-by-category with category_id.\n2. Use product_id from results with /api/walmart/product-details.\n3. Use /api/walmart/product-offers for seller offers and /api/walmart/product-reviews for reviews.\n\n## Wayfair Happy Path\n\n1. Use GET /api/wayfair/search with query, category_id, or manufacturer_id.\n2. Use sku from results with /api/wayfair/product-details.\n\n## Amazon Happy Path\n\n1. Use GET /api/amazon/search with query and optional country/page to find products.\n2. Use asin from search results with GET /api/amazon/product-details for current price, availability, media, variants, and product facts.\n3. Use GET /api/amazon/product-reviews for customer reviews; pass page, sort_by, star_rating, or verified_purchases_only when needed.\n4. Use GET /api/amazon/product-offers for seller offers and buying options.\n5. Use GET /api/amazon/best-sellers with category for ranked products, or GET /api/amazon/todays-deals for current deals.\n","contact":{"name":"Merit Systems","url":"http://localhost:3027"}},"servers":[{"url":"http://localhost:3027"}],"tags":[{"name":"Amazon"},{"name":"Play Store Apps"},{"name":"Walmart"},{"name":"Wayfair"},{"name":"Waze"},{"name":"Yelp"}],"paths":{"/api/play-store-apps/top-paid-apps":{"get":{"operationId":"play-store-apps_top-paid-apps","summary":"Fetch Google Play Store top paid apps.","tags":["Play Store Apps"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"category","schema":{"type":"string","minLength":1}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100}},{"in":"query","name":"region","schema":{"type":"string","minLength":2,"maxLength":8}},{"in":"query","name":"language","schema":{"type":"string","minLength":2,"maxLength":16}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/play-store-apps/top-free-games":{"get":{"operationId":"play-store-apps_top-free-games","summary":"Fetch Google Play Store top free games.","tags":["Play Store Apps"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"category","schema":{"type":"string","minLength":1}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100}},{"in":"query","name":"region","schema":{"type":"string","minLength":2,"maxLength":8}},{"in":"query","name":"language","schema":{"type":"string","minLength":2,"maxLength":16}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/waze/venues":{"get":{"operationId":"waze_venues","summary":"Get Waze venues in a geographic bounding box.","tags":["Waze"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"bottom_left","schema":{"type":"string","minLength":3,"pattern":"^-?\\d+(\\.\\d+)?,-?\\d+(\\.\\d+)?$"},"required":true},{"in":"query","name":"top_right","schema":{"type":"string","minLength":3,"pattern":"^-?\\d+(\\.\\d+)?,-?\\d+(\\.\\d+)?$"},"required":true},{"in":"query","name":"categories","schema":{"type":"string","minLength":1}},{"in":"query","name":"zoom_level","schema":{"type":"string","enum":["1","2","3","4"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/play-store-apps/app-reviews":{"get":{"operationId":"play-store-apps_app-reviews","summary":"Fetch Google Play Store reviews for an Android app.","tags":["Play Store Apps"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"app_id","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100}},{"in":"query","name":"cursor","schema":{"type":"string","minLength":1}},{"in":"query","name":"sort_by","schema":{"type":"string","enum":["MOST_RELEVANT","NEWEST","RATING"]}},{"in":"query","name":"device","schema":{"type":"string","enum":["PHONE","TABLET","CHROMEBOOK"]}},{"in":"query","name":"rating","schema":{"type":"string","enum":["ANY","ONE_STAR","TWO_STARS","THREE_STARS","FOUR_STARS","FIVE_STARS"]}},{"in":"query","name":"region","schema":{"type":"string","minLength":2,"maxLength":8}},{"in":"query","name":"language","schema":{"type":"string","minLength":2,"maxLength":16}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/waze/alerts-and-jams":{"get":{"operationId":"waze_alerts-and-jams","summary":"Get Waze alerts and traffic jams in a bounding box or radius.","tags":["Waze"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"bottom_left","schema":{"type":"string","minLength":3,"pattern":"^-?\\d+(\\.\\d+)?,-?\\d+(\\.\\d+)?$"}},{"in":"query","name":"top_right","schema":{"type":"string","minLength":3,"pattern":"^-?\\d+(\\.\\d+)?,-?\\d+(\\.\\d+)?$"}},{"in":"query","name":"center","schema":{"type":"string","minLength":3,"pattern":"^-?\\d+(\\.\\d+)?,-?\\d+(\\.\\d+)?$"}},{"in":"query","name":"radius","schema":{"type":"string","minLength":1}},{"in":"query","name":"radius_units","schema":{"type":"string","enum":["KM","MI"]}},{"in":"query","name":"max_alerts","schema":{"type":"integer","minimum":0,"maximum":100}},{"in":"query","name":"max_jams","schema":{"type":"integer","minimum":0,"maximum":100}},{"in":"query","name":"alert_types","schema":{"type":"string","minLength":1}},{"in":"query","name":"alert_subtypes","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/waze/autocomplete":{"get":{"operationId":"waze_autocomplete","summary":"Autocomplete geographic queries with a Waze coordinate bias.","tags":["Waze"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"q","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"language","schema":{"type":"string","minLength":1}},{"in":"query","name":"coordinates","schema":{"type":"string","minLength":3,"pattern":"^-?\\d+(\\.\\d+)?,-?\\d+(\\.\\d+)?$"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/play-store-apps/search":{"get":{"operationId":"play-store-apps_search","summary":"Search Google Play Store apps by keyword.","tags":["Play Store Apps"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"q","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"cursor","schema":{"type":"string","minLength":1}},{"in":"query","name":"region","schema":{"type":"string","minLength":2,"maxLength":8}},{"in":"query","name":"language","schema":{"type":"string","minLength":2,"maxLength":16}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/play-store-apps/app-details":{"get":{"operationId":"play-store-apps_app-details","summary":"Fetch Google Play Store details for an Android app.","tags":["Play Store Apps"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"app_id","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"region","schema":{"type":"string","minLength":2,"maxLength":8}},{"in":"query","name":"language","schema":{"type":"string","minLength":2,"maxLength":16}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/play-store-apps/categories":{"get":{"operationId":"play-store-apps_categories","summary":"List Google Play Store app categories.","tags":["Play Store Apps"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/play-store-apps/top-grossing-apps":{"get":{"operationId":"play-store-apps_top-grossing-apps","summary":"Fetch Google Play Store top grossing apps.","tags":["Play Store Apps"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"category","schema":{"type":"string","minLength":1}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100}},{"in":"query","name":"region","schema":{"type":"string","minLength":2,"maxLength":8}},{"in":"query","name":"language","schema":{"type":"string","minLength":2,"maxLength":16}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/play-store-apps/top-free-apps":{"get":{"operationId":"play-store-apps_top-free-apps","summary":"Fetch Google Play Store top free apps.","tags":["Play Store Apps"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"category","schema":{"type":"string","minLength":1}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100}},{"in":"query","name":"region","schema":{"type":"string","minLength":2,"maxLength":8}},{"in":"query","name":"language","schema":{"type":"string","minLength":2,"maxLength":16}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/play-store-apps/top-grossing-games":{"get":{"operationId":"play-store-apps_top-grossing-games","summary":"Fetch Google Play Store top grossing games.","tags":["Play Store Apps"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"category","schema":{"type":"string","minLength":1}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100}},{"in":"query","name":"region","schema":{"type":"string","minLength":2,"maxLength":8}},{"in":"query","name":"language","schema":{"type":"string","minLength":2,"maxLength":16}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/play-store-apps/top-paid-games":{"get":{"operationId":"play-store-apps_top-paid-games","summary":"Fetch Google Play Store top paid games.","tags":["Play Store Apps"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"category","schema":{"type":"string","minLength":1}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100}},{"in":"query","name":"region","schema":{"type":"string","minLength":2,"maxLength":8}},{"in":"query","name":"language","schema":{"type":"string","minLength":2,"maxLength":16}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/yelp/business-search":{"get":{"operationId":"yelp_business-search","summary":"Search Yelp businesses by query and location.","tags":["Yelp"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"query","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"location","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"sort_by","schema":{"type":"string","enum":["RECOMMENDED","HIGHEST_RATED","REVIEW_COUNT"]}},{"in":"query","name":"start","schema":{"type":"integer","minimum":0,"maximum":9007199254740991}},{"in":"query","name":"price_range","schema":{"type":"string","minLength":1}},{"in":"query","name":"yelp_domain","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/yelp/business-details":{"get":{"operationId":"yelp_business-details","summary":"Fetch Yelp business profile details by business ID.","tags":["Yelp"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"business_id","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"yelp_domain","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/yelp/business-reviews":{"get":{"operationId":"yelp_business-reviews","summary":"Fetch Yelp reviews for a business ID.","tags":["Yelp"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"business_id","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"page","schema":{"type":"integer","minimum":1,"maximum":9007199254740991}},{"in":"query","name":"page_size","schema":{"type":"integer","minimum":1,"maximum":50}},{"in":"query","name":"num_pages","schema":{"type":"integer","minimum":1,"maximum":10}},{"in":"query","name":"sort","schema":{"type":"string","enum":["BEST_MATCH","NEWEST","OLDEST","HIGHEST_RATED","LOWEST_RATED","ELITES"]}},{"in":"query","name":"query","schema":{"type":"string","minLength":1}},{"in":"query","name":"language","schema":{"type":"string","minLength":2,"maxLength":16}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/walmart/search":{"get":{"operationId":"walmart_search","summary":"Search Walmart products by keyword.","tags":["Walmart"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"query","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"page","schema":{"type":"number","minimum":1}},{"in":"query","name":"sort_by","schema":{"type":"string","enum":["best_match","price_low","price_high","best_seller","top_rated"]}},{"in":"query","name":"min_price","schema":{"type":"number","minimum":0}},{"in":"query","name":"max_price","schema":{"type":"number","minimum":0}},{"in":"query","name":"store_id","schema":{"type":"string","minLength":1}},{"in":"query","name":"facet","schema":{"type":"string","minLength":1}},{"in":"query","name":"domain","schema":{"type":"string","enum":["us","ca"]}},{"in":"query","name":"state","schema":{"type":"string","minLength":2,"maxLength":8}},{"in":"query","name":"zip","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/walmart/products-by-category":{"get":{"operationId":"walmart_products-by-category","summary":"Browse Walmart products by category ID.","tags":["Walmart"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"category_id","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"page","schema":{"type":"number","minimum":1}},{"in":"query","name":"sort_by","schema":{"type":"string","enum":["best_match","price_low","price_high","best_seller","top_rated"]}},{"in":"query","name":"min_price","schema":{"type":"number","minimum":0}},{"in":"query","name":"max_price","schema":{"type":"number","minimum":0}},{"in":"query","name":"store_id","schema":{"type":"string","minLength":1}},{"in":"query","name":"facet","schema":{"type":"string","minLength":1}},{"in":"query","name":"domain","schema":{"type":"string","enum":["us","ca"]}},{"in":"query","name":"state","schema":{"type":"string","minLength":2,"maxLength":8}},{"in":"query","name":"zip","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/walmart/product-details":{"get":{"operationId":"walmart_product-details","summary":"Fetch Walmart product details by product ID.","tags":["Walmart"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"product_id","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"domain","schema":{"type":"string","enum":["us","ca"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/walmart/product-offers":{"get":{"operationId":"walmart_product-offers","summary":"Fetch Walmart product seller offers by product ID.","tags":["Walmart"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"product_id","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"domain","schema":{"type":"string","enum":["us","ca"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/walmart/product-reviews":{"get":{"operationId":"walmart_product-reviews","summary":"Fetch Walmart product reviews by product ID.","tags":["Walmart"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"product_id","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"page","schema":{"type":"number","minimum":1}},{"in":"query","name":"domain","schema":{"type":"string","enum":["us","ca"]}},{"in":"query","name":"rating","schema":{"type":"integer","minimum":1,"maximum":5}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":50}},{"in":"query","name":"sort","schema":{"type":"string","enum":["relevancy","recent","rating_high_low","rating_low_high"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/wayfair/search":{"get":{"operationId":"wayfair_search","summary":"Search Wayfair products.","tags":["Wayfair"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"query","schema":{"type":"string","minLength":1}},{"in":"query","name":"manufacturer_id","schema":{"type":"string","minLength":1}},{"in":"query","name":"page","schema":{"type":"integer","minimum":1,"maximum":9007199254740991}},{"in":"query","name":"items_per_page","schema":{"type":"string","enum":["24","48","96"]}},{"in":"query","name":"sort_by","schema":{"type":"string","enum":["recommended","customer_rating","price_low_to_high","price_high_to_low"]}},{"in":"query","name":"category_id","schema":{"type":"string","minLength":1}},{"in":"query","name":"min_price","schema":{"type":"number","minimum":0}},{"in":"query","name":"max_price","schema":{"type":"number","minimum":0}},{"in":"query","name":"color","schema":{"type":"string","minLength":1}},{"in":"query","name":"in_stock","schema":{"type":"boolean"}},{"in":"query","name":"domain","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/wayfair/product-details":{"get":{"operationId":"wayfair_product-details","summary":"Fetch Wayfair product details by SKU.","tags":["Wayfair"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"sku","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"domain","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/amazon/search":{"get":{"operationId":"amazon_search","summary":"Search Amazon products by keyword.","tags":["Amazon"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"query","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"country","schema":{"type":"string","enum":["US","AU","BR","CA","CN","FR","DE","IN","IT","MX","NL","SG","ES","TR","AE","GB","JP","SA","PL","SE","BE","EG","ZA","IE"]}},{"in":"query","name":"page","schema":{"type":"integer","minimum":1,"maximum":9007199254740991}},{"in":"query","name":"sort_by","schema":{"type":"string","enum":["RELEVANCE","LOWEST_PRICE","HIGHEST_PRICE","HIGHEST_RATING","NEWEST_ARRIVALS","BEST_SELLERS","MORE_BUYING_CHOICES"]}},{"in":"query","name":"product_condition","schema":{"type":"string","enum":["ALL","NEW","USED","RENEWED","COLLECTIBLE"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/amazon/product-details":{"get":{"operationId":"amazon_product-details","summary":"Fetch Amazon product details by ASIN.","tags":["Amazon"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"asin","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"country","schema":{"type":"string","enum":["US","AU","BR","CA","CN","FR","DE","IN","IT","MX","NL","SG","ES","TR","AE","GB","JP","SA","PL","SE","BE","EG","ZA","IE"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/amazon/product-reviews":{"get":{"operationId":"amazon_product-reviews","summary":"Fetch Amazon product reviews by ASIN.","tags":["Amazon"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"asin","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"country","schema":{"type":"string","enum":["US","AU","BR","CA","CN","FR","DE","IN","IT","MX","NL","SG","ES","TR","AE","GB","JP","SA","PL","SE","BE","EG","ZA","IE"]}},{"in":"query","name":"page","schema":{"type":"integer","minimum":1,"maximum":9007199254740991}},{"in":"query","name":"sort_by","schema":{"type":"string","enum":["TOP_REVIEWS","MOST_RECENT"]}},{"in":"query","name":"star_rating","schema":{"type":"string","enum":["ALL","5_STARS","4_STARS","3_STARS","2_STARS","1_STAR"]}},{"in":"query","name":"verified_purchases_only","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/amazon/product-offers":{"get":{"operationId":"amazon_product-offers","summary":"Fetch Amazon product seller offers by ASIN.","tags":["Amazon"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"asin","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"country","schema":{"type":"string","enum":["US","AU","BR","CA","CN","FR","DE","IN","IT","MX","NL","SG","ES","TR","AE","GB","JP","SA","PL","SE","BE","EG","ZA","IE"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/amazon/best-sellers":{"get":{"operationId":"amazon_best-sellers","summary":"Fetch Amazon best sellers by category.","tags":["Amazon"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"category","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"country","schema":{"type":"string","enum":["US","AU","BR","CA","CN","FR","DE","IN","IT","MX","NL","SG","ES","TR","AE","GB","JP","SA","PL","SE","BE","EG","ZA","IE"]}},{"in":"query","name":"page","schema":{"type":"integer","minimum":1,"maximum":9007199254740991}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}},"/api/amazon/todays-deals":{"get":{"operationId":"amazon_todays-deals","summary":"Fetch current Amazon deals.","tags":["Amazon"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"country","schema":{"type":"string","enum":["US","AU","BR","CA","CN","FR","DE","IN","IT","MX","NL","SG","ES","TR","AE","GB","JP","SA","PL","SE","BE","EG","ZA","IE"]}},{"in":"query","name":"page","schema":{"type":"integer","minimum":1,"maximum":9007199254740991}},{"in":"query","name":"category","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required"}}}}}}