{"uid":"cap_wVXA6_OeeL2F8fM8wEoch","slug":"google-shopping-search-1c3e67d5","name":"Google Shopping Search","description":"Search Google Shopping across retailers. Returns normalized product title, price, currency, seller, rating, review count, product URL, image and rank. For shopping agents, retailer discovery and price research.","url":"https://agent-commerce-factory-jm.austriaeast.cloudapp.azure.com/v1/google-shopping/search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["query"],"properties":{"depth":{"type":"integer","default":40,"maximum":40,"minimum":1},"query":{"type":"string","maxLength":700,"minLength":1},"languageCode":{"type":"string","default":"en"},"locationCode":{"type":"integer","default":2840,"minimum":1}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["machine","route","items"],"properties":{"count":{"type":"integer"},"items":{"type":"array","items":{"type":"object","properties":{"url":{"type":["string","null"]},"rank":{"type":["integer","null"]},"price":{"type":["number","null"]},"title":{"type":["string","null"]},"rating":{"type":["number","null"]},"seller":{"type":["string","null"]},"reviews":{"type":["integer","null"]},"currency":{"type":["string","null"]},"imageUrl":{"type":["string","null"]},"productId":{"type":["string","null"]}}}},"query":{"type":"string"},"route":{"type":"string"},"machine":{"type":"string"},"economics":{"type":"object","properties":{"sellPriceUsd":{"type":"number"},"upstreamCostUsdActual":{"type":["number","null"]}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0035","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0035/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0035","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0035","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_IIJmG_-c6iuHEG0ldEugy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0035","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Google Shopping across multiple retailers and return normalized product listings with price, seller, rating, and image data.","exampleAgentPrompt":"Search Google Shopping for 'Sony WH-1000XM5 headphones' and show me the top 10 results with price, seller, rating, and a link to buy — search in English for the US market.","exampleUseCases":[{"title":"Price comparison for a specific product","prompt":"Find me the best price for a LEGO Technic Bugatti Chiron set across all retailers on Google Shopping — get me the top 20 results in English for the US market, with seller names and ratings."},{"title":"Retailer discovery for niche item","prompt":"Search Google Shopping for 'handmade ceramic pour-over coffee dripper' and tell me which sellers carry it, what they charge, and how they're rated — pull the top 15 results for the US."},{"title":"Price research for gifting budget","prompt":"I need to buy a KitchenAid stand mixer as a gift — search Google Shopping for it and give me the top 10 listings with prices, sellers, and review counts so I can pick the best deal."}],"resultDescription":"Returns a ranked list of product items, each containing: product title, price (numeric), currency code, seller name, star rating, review count, product page URL, image URL, product ID, and rank. Also includes the original query, route/machine metadata, and economics (sell price in USD, upstream cost).","failureModes":["Empty results if query matches no Google Shopping listings","Query too long (over 700 characters) returns validation error","Depth out of range (must be 1–40) returns schema validation error","Invalid or unsupported locationCode may yield empty or irrelevant results","Payment failure (x402) if USDC balance insufficient","Timeout or upstream Google Shopping outage returns server error"],"whenToPreferThis":"Prefer this endpoint when you need real-time Google Shopping product listings with normalized price, seller, rating, and image data across multiple retailers. It is ideal for shopping agents doing price comparison, retailer discovery, or product research. Choose this over Amazon-specific endpoints when you want broad multi-retailer coverage rather than ASIN-level offer data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:30:45.257Z","isFirstParty":false,"canonicalSlug":"google-shopping-search-1c3e67d5"}