{"uid":"cap_fuOEoPOIRDQpDWxIyZsZ9","slug":"agents-openwebninja-com-google-shopping-product-search-fd6f2cd1","name":"Google Shopping Product Search","description":"Search and get product listings (including full product details), sponsored products, and search filters / refinements from Google Shopping.","url":"https://agents.openwebninja.com/realtime-product-search/v2/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["q"],"properties":{"q":{"type":"string","description":"Search query / keyword"},"page":{"type":"integer","default":1,"maximum":100,"minimum":1,"description":"Results page to return (each page contains up to 40 product results)."},"limit":{"type":"integer","default":40,"maximum":120,"minimum":1,"description":"Maximum number of products to return."},"shoprs":{"type":"string","description":"The parameter controls filtering, along with the q parameter.  \n  It should be used in combination with the updated q parameter, which now contains the name of the filter applied next to your original query.  \n  You can get the shoprs filter value from the response of this endpoint, under the filters response field.  \n  In addition, it can be obtained directly from Google Shopping and used with the endpoint."},"stores":{"type":"string","description":"Only return product offers from specific stores.  Accepts a single or a comma delimited list of store names (e.g. best buy,walmart,amazon)."},"country":{"type":"string","default":"us","description":"Country code of the region/country to return offers for. Allowed values: See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2."},"on_sale":{"type":"boolean","default":false,"description":"Only return product offers that are currently on sale."},"sort_by":{"enum":["BEST_MATCH","TOP_RATED","LOWEST_PRICE","HIGHEST_PRICE"],"type":"string","default":"BEST_MATCH","description":"Sort product offers by best match, top rated, lowest or highest price."},"language":{"type":"string","default":"en","description":"The language of the results. Allowed values: See https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes."},"max_price":{"type":"number","description":"Only return product offers with price lower than a certain value"},"min_price":{"type":"number","description":"Only return product offers with price greater than a certain value"},"free_returns":{"type":"boolean","default":false,"description":"Only return product offers that offer free returns."},"free_shipping":{"type":"boolean","default":false,"description":"Only return product offers that offer free shipping/delivery."},"return_filters":{"type":"boolean","description":"Whether to return filters / refinements from Google Shopping (left refinement filters panel on desktop)."},"product_condition":{"enum":["ANY","NEW","USED","REFURBISHED"],"type":"string","default":"ANY","description":"Only return products with a specific condition."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"filters":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","description":"The title of the filter."},"values":{"type":"array","items":{"type":"object","properties":{"q":{"type":"string","description":"The query parameter value for the filter."},"title":{"type":"string","description":"The display name of the filter value."},"shoprs":{"type":"string","description":"A reference ID for shopping results."}}}},"multivalue":{"type":"boolean","description":"Indicates if multiple values can be selected for the filter."}}}}}},"status":{"type":"string","description":"The status of the response, indicating success or failure."},"request_id":{"type":"string","description":"A unique identifier for the request."}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","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":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_hD1PrvVQdGTuTNYtpv_Ew","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Search Google Shopping for product listings with full details, sponsored products, and filter refinements using keywords and optional filters.","exampleAgentPrompt":"Search Google Shopping for wireless noise-cancelling headphones under $200, sorted by lowest price, only from Amazon or Best Buy, with free shipping, and show me the first 20 results in the US.","exampleUseCases":[{"title":"Budget laptop comparison across retailers","prompt":"Find me laptops on Google Shopping priced between $400 and $800, sorted by lowest price, only from Best Buy, Walmart, and Amazon — show the top 20 results for the US."},{"title":"Sale item discovery for holiday gifts","prompt":"Search Google Shopping for LEGO sets that are currently on sale, with free returns, sorted by top rated, and show me up to 40 results in the US."},{"title":"International product availability check","prompt":"Look up Google Shopping listings for 'Sony WH-1000XM5' in Germany in German, sorted by best match, and return the first 20 products so I can see local pricing and store availability."}],"resultDescription":"Returns an object containing an array of product listings (with full product details and sponsored items), an array of available search filters/refinements (each with title, selectable values, query parameters, and shoprs reference IDs for chaining), plus a status string and unique request ID.","failureModes":["Missing required 'q' parameter returns validation error","Invalid country code returns no results or error","Requested page beyond available results returns empty product list","Store name misspelling results in no filtered offers","Price range filters that are too narrow may return zero results","Rate limiting or quota exhaustion returns 402 or 429 error"],"whenToPreferThis":"Use this endpoint when you need real-time Google Shopping product listings with full details, pricing, and store availability across multiple retailers. Prefer it over Amazon-specific or retailer-specific endpoints when you want cross-retailer comparison, need Google Shopping's filter/refinement system, or need to serve results for countries beyond the US. It is the right choice when the user wants ranked, filterable product search results rather than a single product's details.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:45.982Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-google-shopping-product-search-5bee09b1"}