{"uid":"cap_guI7IbPKfTPJ7aLiu2jAe","slug":"agents-litescrape-com-search-google-shopping-a235fc5a","name":"Search Google Shopping","description":"Searches Google Shopping and returns shopping_results (position, title, price, merchant, rating, and the gpcid, headline_offer_docid, and image_docid identifiers that open the product), category blocks, sponsored listings, and Google's refinement chips as shoprs tokens. Google applies one refinement at a time: the price range, on_sale, free_shipping, and small_business filters are mutually exclusive, and sort_by combines with any one of them. num caps the response at up to 100 products and pages through Google's 40-product pages for you. One call is one request.","url":"https://agents.litescrape.com/api/google/shopping","method":"GET","headers":{},"bodySchema":{"type":"object","required":["q"],"properties":{"q":{"type":"string","maxLength":2048,"description":"Product query. Optional when a shoprs token is supplied."},"gl":{"type":"string","maxLength":2,"minLength":2,"description":"Two-letter country code for result localization, lowercase."},"hl":{"type":"string","default":"en","description":"Interface and result language code, such as en, en-GB, or de."},"num":{"type":"integer","maximum":100,"minimum":1,"description":"Number of products to return."},"uule":{"type":"string","maxLength":2048,"description":"Pre-encoded Google location token. Conflicts with location."},"start":{"type":"integer","default":0,"maximum":1000,"minimum":0,"description":"Result offset."},"device":{"enum":["desktop","tablet","mobile"],"type":"string","default":"desktop","description":"Device layout Google renders."},"shoprs":{"type":"string","maxLength":4096,"description":"Refinement token from a previous response. An explicit refinement replaces the one it carries."},"on_sale":{"type":"boolean","default":false,"description":"Only products Google marks as on sale. Excludes the other refinements."},"sort_by":{"enum":["1","2","3","4"],"type":"string","description":"1 price low to high, 2 price high to low, 3 rating high to low, 4 Google's default relevance. Combines with one refinement."},"location":{"type":"string","maxLength":512,"description":"Human-readable search origin, such as Austin, Texas. Conflicts with uule."},"max_price":{"type":"number","minimum":0,"description":"Upper price bound, at or above min_price. Excludes the other refinements."},"min_price":{"type":"number","maximum":1000000000,"minimum":0,"description":"Lower price bound. Excludes the other refinements."},"free_shipping":{"type":"boolean","default":false,"description":"Only products with free shipping. Excludes the other refinements."},"google_domain":{"type":"string","default":"google.com","description":"Google domain to query, such as google.com or google.co.uk."},"small_business":{"type":"boolean","default":false,"description":"Only products from small businesses. Excludes the other refinements."}}},"responseSchema":{"type":"object","properties":{"pagination":{"type":"object","description":"Present when more results exist: next (a ready-made URL for the next page) or next_page_token."},"search_metadata":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"total_time_taken":{"type":"number"}}},"shopping_results":{"type":"array","items":{"type":"object"},"description":"Products: position, title, price, merchant, rating, gpcid, headline_offer_docid, image_docid, litescrape_product_link."},"search_parameters":{"type":"object","description":"The request parameters as normalized by the API."}},"description":"Successful responses carry request metadata, the normalized parameters, and the result groups available for the operation. Optional groups are omitted when the source does not provide them. Errors are a JSON body with error, error_code, status_code, request_id, retryable, and the echoed search_parameters."},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.000150","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","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":"static","summary":"$0.000150/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.000150","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.000150","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xkhHqEMC19822okk3ESHi","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.000150","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.litescrape.com","brandSlug":"agents-litescrape-com-mpp","brandBaseUrl":"https://agents.litescrape.com","brandDocsUrl":null,"whatItDoes":"Searches Google Shopping and returns structured product listings with prices, merchants, ratings, and refinement tokens for filtering and pagination.","exampleAgentPrompt":"Search Google Shopping for wireless noise-cancelling headphones under $150, sorted by price low to high, and show me the top 20 results with free shipping in the US.","exampleUseCases":[{"title":"Price comparison for a specific product","prompt":"Search Google Shopping for Sony WH-1000XM5 headphones, sort by price low to high, and give me the top 10 listings with the merchant name, price, and rating for each."},{"title":"On-sale product discovery","prompt":"Find me products on Google Shopping that are currently on sale for 'standing desk', limited to results between $200 and $600, and return up to 25 results for the US market."},{"title":"Localized shopping search","prompt":"Search Google Shopping for 'organic coffee beans' in the UK using google.co.uk, language English, and show me the top 15 results sorted by rating high to low."}],"resultDescription":"Returns a JSON object with shopping_results (array of products with position, title, price, merchant, rating, gpcid, headline_offer_docid, image_docid, and litescrape_product_link), optional category blocks, sponsored listings, Google refinement chips as shoprs tokens for follow-up filtering, search_metadata (id, status, time taken), search_parameters (normalized inputs), and a pagination object with a next URL or next_page_token when more results exist.","failureModes":["Missing required query parameter 'q' when no shoprs token is provided — returns 400 error JSON with error_code and message","Invalid country code or language code — may return empty results or localization errors","Mutually exclusive filters used together (e.g. on_sale + free_shipping) — API enforces one refinement at a time, may silently apply only one","start offset exceeds 1000 — returns 400 or empty results","Rate limit or payment failure — returns 402 or 429 with retryable flag","Google Shopping returns no results for niche query — shopping_results array is empty","Invalid shoprs token from a previous session — may return error or unexpected results"],"whenToPreferThis":"Choose this endpoint when you need live, structured Google Shopping product data including prices, merchants, ratings, and product identifiers — especially when you want to filter by price range, sale status, free shipping, or small business, or sort by price or rating. Prefer this over generic web search endpoints when the user's intent is product discovery or price comparison. Use the shoprs refinement token system for stateful multi-step shopping flows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-18T17:29:17.338Z","isFirstParty":false}