{"uid":"cap_Gnz3jAXxaAjNgpQn1sXZ_","slug":"agents-openwebninja-com-google-shopping-deals-search-d2c47e89","name":"Google Shopping Deals Search","description":"Search for product deals on Google Shopping with pagination/scrolling support.","url":"https://agents.openwebninja.com/realtime-product-search/v2/deals?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"},"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_ngXeEsaj1xTJaKklFQkxT","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 for product deals on Google Shopping with filtering by store, price range, condition, sale status, shipping, and sorting options.","exampleAgentPrompt":"Find me deals on noise-cancelling headphones on Google Shopping — only show items on sale with free shipping, sorted by lowest price, from Amazon or Best Buy, under $200.","exampleUseCases":[{"title":"Budget electronics gift shopping","prompt":"Search Google Shopping for deals on Nintendo Switch accessories under $50 — only show items that are on sale with free returns, sorted by lowest price."},{"title":"Refurbished laptop deal hunting","prompt":"Find me deals on refurbished MacBook Pro laptops on Google Shopping, only from Amazon or Walmart, priced between $400 and $900, sorted by top rated."},{"title":"Holiday sale product browsing","prompt":"Show me the best deals on kitchen stand mixers on Google Shopping right now — only items currently on sale with free shipping, sorted by best match, in the US."}],"resultDescription":"Returns a list of product deals from Google Shopping matching the query and filters, along with available filter options (including shoprs reference IDs for further filtering), a status string, and a unique request ID. Each page contains up to 40 results.","failureModes":["Missing required 'q' parameter returns validation error","Invalid country or language code may return no results or an error","Stores that don't exist on Google Shopping may yield empty results","Page number beyond available results returns empty data","Rate limiting or quota exhaustion from the underlying API returns an error response"],"whenToPreferThis":"Use this endpoint when you need to search for product deals specifically indexed on Google Shopping, with rich filtering options including sale status, free shipping, free returns, store filtering, condition, and price range. Prefer this over generic product search endpoints when the user wants to compare deals across multiple retailers or needs Google Shopping's deal-specific catalog.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:35:44.525Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-google-shopping-deals-search-d2c47e89"}