{"uid":"cap_OxgzDPzqc9WlEoB7FSCm4","slug":"agents-openwebninja-com-search-light-new-layout-us-google-shopping-e5afc906","name":"Search Light (New Layout / US) — Google Shopping Fast Product Search","description":"Super fast product search endpoint providing product listings, sponsored products, and search filters / refinements from Google Shopping. To search and get the full product details, please refer to the \"Search (Full)\" endpoint.","url":"https://agents.openwebninja.com/realtime-product-search/search-light-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_tkr55rfbpIVRlpCbyp6X3","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":"Performs super-fast product listing searches against Google Shopping, returning product results, sponsored products, and search filters/refinements for US-centric queries.","exampleAgentPrompt":"Search Google Shopping for wireless noise-cancelling headphones under $200, sorted by lowest price, only from Amazon or Best Buy, and show me the first 10 results along with any available filters.","exampleUseCases":[{"title":"Budget laptop hunt with filters","prompt":"Find me laptops under $600 on Google Shopping, sorted by lowest price, only showing new condition items — give me the top 10 results and any filter options I can narrow down with."},{"title":"Sale items from specific retailer","prompt":"Search Google Shopping for 'running shoes' that are currently on sale, only from Nike or Adidas stores, and return up to 20 results sorted by best match."},{"title":"Gift idea price comparison","prompt":"Look up 'LEGO Star Wars sets' on Google Shopping, show me results between $30 and $100 with free shipping, sorted by top rated, and include any search filters I can refine by."}],"resultDescription":"Returns a JSON object containing: an array of product listings (with titles, prices, store names, sponsored flags, and product details), an array of available search filters/refinements (each with a title, selectable values, associated query and shoprs reference IDs, and whether multiple values can be selected), plus a status string and unique request ID for the call.","failureModes":["Missing required 'q' parameter returns a validation error","Invalid country code returns an error or empty results","Price range where min_price exceeds max_price may return empty results","Requesting a page beyond available results returns empty product list","Unsupported store name in 'stores' filter returns no offers","Rate limit exceeded returns 429 or payment-required response"],"whenToPreferThis":"Choose this endpoint when you need fast, lightweight Google Shopping product search results with filtering metadata — ideal for quickly surfacing product listings, prices, and refinement options without fetching full product details. Use the 'Search (Full)' endpoint instead when you need complete product specifications, detailed descriptions, or full offer breakdowns. Prefer this when response speed and filter discovery are the priority.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:10.727Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-search-light-new-layout-us-google-shopping-e5afc906"}