{"uid":"cap_0Ygo6NfTwEX6ccSC7Nqmr","slug":"agents-openwebninja-com-google-shopping-full-search-us-9607ec2f","name":"Google Shopping Full Search (US)","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/search-v2?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 100 product results)."},"limit":{"type":"integer","default":10,"maximum":100,"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_KCo0iouFJugAp7k4UstI8","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 by keyword and optional filters.","exampleAgentPrompt":"Search Google Shopping for wireless noise-cancelling headphones under $200, sort by lowest price, only show items with free shipping, and return the top 20 results from US stores.","exampleUseCases":[{"title":"Budget laptop price comparison","prompt":"Find me laptops on Google Shopping between $400 and $800, sorted by lowest price, with free shipping, and show me the top 10 results from Best Buy, Walmart, or Amazon."},{"title":"On-sale home appliance discovery","prompt":"Search Google Shopping for stand mixers that are currently on sale, sorted by top rated, and give me the first 15 results — I want to see full product details including which stores are selling them."},{"title":"Gift shopping with category filters","prompt":"Look up 'running shoes for men' on Google Shopping, show me results sorted by best match, limit to 20 products, and include the available filters so I can narrow it down further by brand or size."}],"resultDescription":"Returns a JSON object containing an array of product listings with full product details (name, price, store, images, ratings, etc.), sponsored products, and an array of search filter objects with titles, selectable values, and associated shoprs/query parameters for refining results. Also includes a request ID and status field.","failureModes":["Missing required 'q' parameter returns a 400 validation error","Invalid country or language code may return empty results or an error","Price range with min_price greater than max_price may return zero results","Unsupported store name in 'stores' filter may silently return no results","Exceeding page limit (>100) returns a validation error","Rate limit or quota exhaustion returns a 402 or 429 error","Query returning no Google Shopping matches yields an empty product array"],"whenToPreferThis":"Use this endpoint when you need comprehensive Google Shopping product listings including full product details, sponsored results, and filter refinements — particularly for US-focused shopping queries. Prefer it over simpler search APIs when you need rich filtering (price range, store, condition, sale status, free shipping/returns), pagination across large result sets, or when you want to chain filter refinements using the returned shoprs parameters to progressively narrow results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:21.513Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-google-shopping-full-search-us-9607ec2f"}