{"openapi":"3.1.0","info":{"title":"Product Search & Data (Amazon + Google Shopping)","version":"0.1.0","description":"Live retail product data for shopping agents — Amazon keyword search, ASIN detail and multi-seller offers, plus Google Shopping product search across sellers, with prices, ratings, reviews and availability.","x-guidance":"Live retail product data for shopping agents — Amazon keyword search, ASIN detail and multi-seller offers, plus Google Shopping product search across sellers, with prices, ratings, reviews and availability. Each operation is an HTTP POST to its /v1/<operation> path with a JSON request body (see each operation's requestBody schema) and returns a JSON response. Endpoints are paid per successful call via x402 or MPP (USDC on Base); an unpaid request returns 402 with payment metadata in the WWW-Authenticate header.","contact":{"email":"hello@openverbs.com"}},"x-discovery":{"ownershipProofs":["0xb1401a71756f51464a9962db12f1eb3e9522490cd20010b06d00cf7b7770acfd5f79721f9dfdf2643f8cecd29af3bde9ec133941a386042b32d9886053a70de61b","0xc1c1f11793e18a00fcb7072421f26e89fb75b6aa517fa84370564991f4b10efa024f6f57e4e67eefd20cf46cc01fc5a62d793fa8fbcda04f26c946a3433d73f91b","0x676b474af0ef9ed4809b5d12d2e789b36e52d56215b21f601d71f76620e36ec630347116a7b2b349a3c3681e5db0fbfa76c4169a676b6d6f27864d0e5017284a1c","0xc2ab96522515ed9e9bc4f1a241b774bd48df42e951ddbf7f6aa8fc76f5a96a20421703e1ec402ce7eb1e4eabea3b6e4e4129cf39d56ea91cf4fcf38561fc94fc1c"]},"servers":[{"url":"https://products.openverbs.com"}],"paths":{"/health":{"get":{"summary":"Health check","security":[],"responses":{"200":{"description":"Healthy","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"service":{"type":"string"},"version":{"type":"string"}}}}}}}}},"/v1/amazon-search":{"post":{"summary":"Amazon Product Search API","description":"Amazon product search API - search Amazon products / find products on Amazon by keyword (US). Live Amazon product data: ranked listings with ASIN, title, product URL, image, price range, currency, star rating, review count and Amazon's Choice / Best Seller flags. No matches returns empty results. Paid endpoint (x402 + MPP). Price: $0.006000 USDC per successful payment.","tags":["amazon product search","search amazon products","find products on amazon","amazon product data","amazon prices","amazon","products","product search","shopping","ecommerce","amazon products","price comparison","retail","asin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":300,"description":"Product search keyword."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Result depth. Defaults to 20."}},"required":["q"],"additionalProperties":false}}}},"responses":{"200":{"description":"The `total` and ranked `results`, each with `rank`, `asin`, `title`, `url` and (where present) `image`, `priceFrom`, `priceTo`, `currency`, `rating`, `reviews`, `isAmazonChoice`, `isBestSeller`, `boughtPastMonth`.","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"results":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"asin":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"image":{"type":"string"},"priceFrom":{"type":"number"},"priceTo":{"type":"number"},"currency":{"type":"string"},"rating":{"type":"number"},"reviews":{"type":"integer"},"isAmazonChoice":{"type":"boolean"},"isBestSeller":{"type":"boolean"},"boughtPastMonth":{"type":"integer"}}}}},"description":"The `total` and ranked `results`, each with `rank`, `asin`, `title`, `url` and (where present) `image`, `priceFrom`, `priceTo`, `currency`, `rating`, `reviews`, `isAmazonChoice`, `isBestSeller`, `boughtPastMonth`."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"6000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Amazon product search API - search Amazon products / find products on Amazon by keyword (US). Live Amazon product data: ranked listings with ASIN, title, product URL, image, price range, currency, star rating, review count and Amazon's Choice / Best Seller flags. No matches returns empty results.","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.006000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"6000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Amazon product search API - search Amazon products / find products on Amazon by keyword (US). Live Amazon product data: ranked listings with ASIN, title, product URL, image, price range, currency, star rating, review count and Amazon's Choice / Best Seller flags. No matches returns empty results.","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"6000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Amazon product search API - search Amazon products / find products on Amazon by keyword (US). Live Amazon product data: ranked listings with ASIN, title, product URL, image, price range, currency, star rating, review count and Amazon's Choice / Best Seller flags. No matches returns empty results.","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}},"/v1/amazon-product":{"post":{"summary":"Amazon Product Detail API (ASIN lookup)","description":"Amazon product detail API (US) by ASIN - Amazon product data for one ASIN: title, product URL, image, price range, discount, currency, star rating, review count, category path, availability and description. Amazon prices and product-detail lookup. Unknown ASIN returns found=false. Paid endpoint (x402 + MPP). Price: $0.006000 USDC per successful payment.","tags":["amazon product detail","amazon product data","amazon prices","amazon product","product detail","asin","asin lookup","amazon","products","product info","ecommerce","price"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asin":{"type":"string","pattern":"^[A-Z0-9]{10}$","description":"10-character Amazon ASIN, e.g. B0HCXW6CDR."}},"required":["asin"],"additionalProperties":false},"example":{"asin":"B0CX23V2ZK"}}}},"responses":{"200":{"description":"`found`, `asin`, `title` and (where present) `url`, `image`, `parentAsin`, `priceFrom`, `priceTo`, `discountPercent`, `currency`, `rating`, `reviews`, `isAmazonChoice`, `isAvailable`, `categories`, `description`, `details`.","content":{"application/json":{"schema":{"type":"object","properties":{"found":{"type":"boolean"},"asin":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"image":{"type":"string"},"parentAsin":{"type":"string"},"priceFrom":{"type":"number"},"priceTo":{"type":"number"},"discountPercent":{"type":"integer"},"currency":{"type":"string"},"rating":{"type":"number"},"reviews":{"type":"integer"},"isAmazonChoice":{"type":"boolean"},"isAvailable":{"type":"boolean"},"categories":{"type":"array","items":{"type":"string"}},"description":{"type":"string"},"details":{"type":"string"}},"description":"`found`, `asin`, `title` and (where present) `url`, `image`, `parentAsin`, `priceFrom`, `priceTo`, `discountPercent`, `currency`, `rating`, `reviews`, `isAmazonChoice`, `isAvailable`, `categories`, `description`, `details`."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"6000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Amazon product detail API (US) by ASIN - Amazon product data for one ASIN: title, product URL, image, price range, discount, currency, star rating, review count, category path, availability and description. Amazon prices and product-detail lookup. Unknown ASIN returns found=false.","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.006000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"6000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Amazon product detail API (US) by ASIN - Amazon product data for one ASIN: title, product URL, image, price range, discount, currency, star rating, review count, category path, availability and description. Amazon prices and product-detail lookup. Unknown ASIN returns found=false.","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"6000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Amazon product detail API (US) by ASIN - Amazon product data for one ASIN: title, product URL, image, price range, discount, currency, star rating, review count, category path, availability and description. Amazon prices and product-detail lookup. Unknown ASIN returns found=false.","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}},"/v1/amazon-sellers":{"post":{"summary":"Amazon Offers & Sellers API","description":"Amazon offers & sellers API (US) by ASIN: the buy-box winner plus third-party sellers, each with seller name, price, regular price, discount, condition (new/used), ships-from and seller rating. Amazon offers and sellers for buy-box tracking and price comparison. No offers returns empty results. Paid endpoint (x402 + MPP). Price: $0.006000 USDC per successful payment.","tags":["amazon offers and sellers","amazon offers","amazon sellers","buy box","price comparison","third-party sellers","asin","amazon","products","ecommerce","seller prices"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asin":{"type":"string","pattern":"^[A-Z0-9]{10}$","description":"10-character Amazon ASIN, e.g. B0HCXW6CDR."}},"required":["asin"],"additionalProperties":false},"example":{"asin":"B0CX23V2ZK"}}}},"responses":{"200":{"description":"`asin`, `total` and `offers`, each with `rank`, `seller`, `isBuyBox` and (where present) `sellerUrl`, `shipsFrom`, `condition`, `conditionNote`, `price`, `regularPrice`, `discountPercent`, `currency`, `displayedPrice`, `rating`, `reviews`.","content":{"application/json":{"schema":{"type":"object","properties":{"asin":{"type":"string"},"total":{"type":"integer"},"offers":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"seller":{"type":"string"},"isBuyBox":{"type":"boolean"},"sellerUrl":{"type":"string"},"shipsFrom":{"type":"string"},"condition":{"type":"string"},"conditionNote":{"type":"string"},"price":{"type":"number"},"regularPrice":{"type":"number"},"discountPercent":{"type":"integer"},"currency":{"type":"string"},"displayedPrice":{"type":"string"},"rating":{"type":"number"},"reviews":{"type":"integer"}}}}},"description":"`asin`, `total` and `offers`, each with `rank`, `seller`, `isBuyBox` and (where present) `sellerUrl`, `shipsFrom`, `condition`, `conditionNote`, `price`, `regularPrice`, `discountPercent`, `currency`, `displayedPrice`, `rating`, `reviews`."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"6000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Amazon offers & sellers API (US) by ASIN: the buy-box winner plus third-party sellers, each with seller name, price, regular price, discount, condition (new/used), ships-from and seller rating. Amazon offers and sellers for buy-box tracking and price comparison. No offers returns empty results.","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.006000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"6000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Amazon offers & sellers API (US) by ASIN: the buy-box winner plus third-party sellers, each with seller name, price, regular price, discount, condition (new/used), ships-from and seller rating. Amazon offers and sellers for buy-box tracking and price comparison. No offers returns empty results.","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"6000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Amazon offers & sellers API (US) by ASIN: the buy-box winner plus third-party sellers, each with seller name, price, regular price, discount, condition (new/used), ships-from and seller rating. Amazon offers and sellers for buy-box tracking and price comparison. No offers returns empty results.","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}},"/v1/google-shopping":{"post":{"summary":"Google Shopping Product Search API","description":"Google Shopping product search API - search Google Shopping by keyword (US) and get ranked product offers across sellers. Live Google Shopping data: title, product URL, image, seller, price, currency, star rating, review count, Google product id and delivery info. Compare product prices across merchants. No matches returns empty results. Paid endpoint (x402 + MPP). Price: $0.006000 USDC per successful payment.","tags":["google shopping","google shopping search","shopping search","compare product prices","product search","shopping","google shopping api","products","ecommerce","price comparison","retail","product prices"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":300,"description":"Product search keyword."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Result depth. Defaults to 20."}},"required":["q"],"additionalProperties":false}}}},"responses":{"200":{"description":"The `total` and ranked `results`, each with `rank`, `title` and (where present) `productId`, `url`, `image`, `seller`, `price`, `currency`, `rating`, `reviews`, `delivery`.","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"results":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"title":{"type":"string"},"productId":{"type":"string"},"url":{"type":"string"},"image":{"type":"string"},"seller":{"type":"string"},"price":{"type":"number"},"currency":{"type":"string"},"rating":{"type":"number"},"reviews":{"type":"integer"},"delivery":{"type":"string"}}}}},"description":"The `total` and ranked `results`, each with `rank`, `title` and (where present) `productId`, `url`, `image`, `seller`, `price`, `currency`, `rating`, `reviews`, `delivery`."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"6000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Google Shopping product search API - search Google Shopping by keyword (US) and get ranked product offers across sellers. Live Google Shopping data: title, product URL, image, seller, price, currency, star rating, review count, Google product id and delivery info. Compare product prices across merchants. No matches returns empty results.","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.006000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"6000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Google Shopping product search API - search Google Shopping by keyword (US) and get ranked product offers across sellers. Live Google Shopping data: title, product URL, image, seller, price, currency, star rating, review count, Google product id and delivery info. Compare product prices across merchants. No matches returns empty results.","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"6000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Google Shopping product search API - search Google Shopping by keyword (US) and get ranked product offers across sellers. Live Google Shopping data: title, product URL, image, seller, price, currency, star rating, review count, Google product id and delivery info. Compare product prices across merchants. No matches returns empty results.","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}}},"x-service-info":{"categories":["business"],"docs":{"homepage":"https://products.openverbs.com","apiReference":"https://products.openverbs.com/openapi.json"}}}