# Google Shopping

Search Google Shopping products. Takes q, location, uule and more, all optional. Served by Litescrape.

Search Google Shopping products.

- Tool ID: `litescrape/google-shopping`
- Provider: [Litescrape](/providers/litescrape.md)
- Capability: [Google Shopping](/tools/ecommerce/google-shopping.md)
- Price: $0.00015 per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


```json
{
  "model": "per_call",
  "amountUsd": 0.00015
}
```

Pricing source: [https://litescrape.com/pricing](https://litescrape.com/pricing). $0.15 per 1,000 successful HTTP 200 requests; every native endpoint costs one call. Failed requests are not billed. Prepaid credits expire after six months..

Price verification date: 2026-11-03.

## Complete input schema


```json
{
  "additionalProperties": false,
  "properties": {
    "q": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Product query, up to 2,048 characters with no controls. Optional when a shoprs token is supplied."
    },
    "location": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Named search origin, up to 512 characters and 63 UTF-8 bytes once encoded. Conflicts with uule."
    },
    "uule": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Canonical Google location token, up to 2,048 characters. Conflicts with location."
    },
    "google_domain": {
      "default": "google.com",
      "type": "string",
      "description": "Validated first-party Google domain."
    },
    "gl": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Two-letter country code, normalized to lowercase."
    },
    "hl": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Language code such as en, en-GB, or de."
    },
    "device": {
      "default": "desktop",
      "enum": [
        "desktop",
        "tablet",
        "mobile"
      ],
      "type": "string",
      "description": "Google returns its real layout for the selected device."
    },
    "shoprs": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Google refinement token from a previous response, up to 4,096 characters. An explicit refinement replaces the one it carries."
    },
    "min_price": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "Lower price bound, 0 through 1,000,000,000. Excludes the other refinements."
    },
    "max_price": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "Upper price bound, at or above min_price. Excludes the other refinements."
    },
    "sort_by": {
      "anyOf": [
        {
          "enum": [
            "",
            "1",
            "2",
            "3",
            "4"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Price low to high, price high to low, rating high to low, or Google’s default relevance. Combines with one refinement."
    },
    "free_shipping": {
      "default": false,
      "type": "boolean",
      "description": "Only products with free shipping. Excludes the other refinements."
    },
    "on_sale": {
      "default": false,
      "type": "boolean",
      "description": "Only products Google marks as on sale. Excludes the other refinements."
    },
    "small_business": {
      "default": false,
      "type": "boolean",
      "description": "Only products from small businesses. Excludes the other refinements."
    },
    "start": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "Result offset from 0 through 1,000."
    },
    "num": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "1 through 100. Responses are capped to this count and transparently consume Google’s fixed 40-product pages when needed."
    }
  },
  "type": "object",
  "allOf": [
    {
      "anyOf": [
        {
          "required": [
            "q"
          ],
          "properties": {
            "q": {
              "not": {
                "enum": [
                  null,
                  ""
                ]
              }
            }
          }
        },
        {
          "required": [
            "shoprs"
          ],
          "properties": {
            "shoprs": {
              "not": {
                "enum": [
                  null,
                  ""
                ]
              }
            }
          }
        }
      ]
    }
  ]
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "litescrape/google-shopping",
  "input": {
    "q": "coffee maker",
    "num": 3,
    "hl": "en",
    "gl": "us"
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://litescrape.com/docs/reference#google-shopping-parameters)

[REST inspection](https://api.agentik.cc/v1/tools/litescrape/google-shopping) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/litescrape/google-shopping) · [Agent index](/llms.txt)