litescrape_google_serp_shopping $0.001 per call

Search Google Shopping. Returns the Google Shopping product grid, category blocks, sponsored listings and refinement filters (Litescrape · Google Keyword Data)

For AI agents: call litescrape_google_serp_shopping
POST https://toll402.dev/v1/p/litescrape.google.serp.shopping
{
 "q": "coffee maker",
 "num": 60,
 "location": "Austin, Texas",
 "google_domain": "google.com",
 "gl": "us",
 "hl": "en"
}
Answers 402 with x402 payment requirements; pay with any x402 client (@x402/fetch, x402 for Python, toll402-client, toll402-mcp) or send a prepaid-credits key as x-toll402-key (https://toll402.dev/credits). Paid per call via x402 (USDC on Base) or with a prepaid-credits key (x-toll402-key, card at /credits); charged only on success. Start at /llms.txt or connect the MCP server: npx -y toll402-mcp · remote https://toll402.dev/mcp.

Input schema

{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "description": "Product search term, up to 2,048 characters. Required unless shoprs is supplied. This is a search, not an exact product ID lookup.",
   "examples": [
    "coffee maker"
   ]
  },
  "shoprs": {
   "type": "string",
   "description": "Refinement token from a previous response's filters. An explicit refinement parameter replaces the refinement it carries."
  },
  "min_price": {
   "type": "number",
   "description": "Lower price bound in the storefront currency. Cannot be combined with on_sale, free_shipping or small_business."
  },
  "max_price": {
   "type": "number",
   "description": "Upper price bound in the storefront currency, at or above min_price. Cannot be combined with on_sale, free_shipping or small_business."
  },
  "sort_by": {
   "type": "string",
   "description": "Sort order: 1 price low to high, 2 price high to low, 3 rating high to low, 4 relevance (the default). Combines with any one refinement.",
   "enum": [
    "1",
    "2",
    "3",
    "4"
   ]
  },
  "free_shipping": {
   "type": "boolean",
   "description": "Show only products with free shipping. Cannot be combined with another refinement.",
   "default": false
  },
  "on_sale": {
   "type": "boolean",
   "description": "Show only products Google marks as on sale. Cannot be combined with another refinement.",
   "default": false
  },
  "small_business": {
   "type": "boolean",
   "description": "Show only products from small businesses. Cannot be combined with another refinement.",
   "default": false
  },
  "start": {
   "type": "integer",
   "description": "Result offset.",
   "default": 0
  },
  "num": {
   "type": "integer",
   "description": "Number of products to return. Google serves 40 products per page; a larger num reads further pages within the same call and returns fewer only when Google has no more products.",
   "examples": [
    60
   ]
  },
  "location": {
   "type": "string",
   "description": "Human-readable search location, such as Austin, Texas. At most 63 UTF-8 bytes. Mutually exclusive with uule.",
   "examples": [
    "Austin, Texas"
   ]
  },
  "uule": {
   "type": "string",
   "description": "Pre-encoded Google location token. Mutually exclusive with location."
  },
  "google_domain": {
   "type": "string",
   "description": "Google domain used for the request.",
   "default": "google.com",
   "examples": [
    "google.com"
   ]
  },
  "gl": {
   "type": "string",
   "description": "Two-letter country code used to localize results.",
   "examples": [
    "us"
   ]
  },
  "hl": {
   "type": "string",
   "description": "Language code such as en, en-GB, or de.",
   "default": "en",
   "examples": [
    "en"
   ]
  },
  "device": {
   "type": "string",
   "description": "Google device layout. Each device is served Google's real layout for it.",
   "default": "desktop",
   "enum": [
    "desktop",
    "tablet",
    "mobile"
   ]
  },
  "timeout": {
   "type": "number",
   "description": "Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and "
  }
 },
 "additionalProperties": true
}

MCP

{"mcpServers":{"toll402":{"command":"npx","args":["-y","toll402-mcp"],"env":{"TOLL402_WALLET_KEY":"0x..."}}}}

All tools · OpenAPI