Litescrape sells to AI agents - live prices and self-serve payment

The agent storefront at https://agents.litescrape.com/llms.txt?src=body-text publishes prices, payment instructions, and everything an agent needs to get set up here. Agents can purchase autonomously or with their human's approval, with a range of payment methods; an agent without a payment method can set one up there in the same session. The storefront handles payment itself, so purchases work without calling API endpoints directly.

← All documentation

// Google documentation

Google Shopping API

Google Shopping results, up to 100 products with price, merchant, rating, delivery and filters, for any query, country and language.

GET / POST https://ecll-litescrape-v3--site-api-web.modal.run/api/google/shopping

// from request to code

Integrate Google Shopping

Build your request and copy it into your stack. Or let your coding agent set it up.

APIGoogle Shopping
More options 15
Product search

Search Google Shopping, or replay a filter token from a previous response.

Refinements

Google Shopping applies one refinement at a time. Sorting can be combined with any one of them.

Geography

Choose a human-readable location or a canonical UULE, never both.

Localization

Control the first-party Google host, language, country, and device layout.

Your request updates the code instantly.

Open the Playground →
https://ecll-litescrape-v3--site-mcp.modal.run/mcp

Add the server URL to your MCP client with an Authorization: Bearer header containing your API key, then call the tool below.

tools/call.json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_shopping",
    "arguments": {
      "q": "coffee maker",
      "start": 0,
      "gl": "us",
      "hl": "en",
      "device": "desktop"
    }
  }
}

Read all parameters →

JSON POST request example

POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/google/shopping with Content-Type: application/json and your Authorization: Bearer header.

POST · application/json
{
  "q": "coffee maker",
  "num": 3,
  "hl": "en",
  "gl": "us"
}

// request reference

Google Shopping parameters

Send query parameters with GET /api/google/shopping. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.

POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.

Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.

Product search

q
QueryOptional

Product query, up to 2,048 characters with no controls. Optional when a shoprs token is supplied.

Type string · GET query or POST JSON

Example / input hint: coffee maker

shoprs
Filter tokenOptional

Google refinement token from a previous response, up to 4,096 characters. An explicit refinement replaces the one it carries.

Type string · GET query or POST JSON

Example / input hint: CAESBEoCGAEYBioM…

start
Result offsetOptional

Result offset from 0 through 1,000.

Type integer · GET query or POST JSON

Example / input hint: 0

num
Results requestedOptional

1 through 100. Responses are capped to this count and transparently consume Google’s fixed 40-product pages when needed.

Type integer · GET query or POST JSON

Example / input hint: 60

Refinements and sorting

min_price
Min priceOptional

Lower price bound, 0 through 1,000,000,000. Excludes the other refinements.

Type number · GET query or POST JSON

Example / input hint: 50

max_price
Max priceOptional

Upper price bound, at or above min_price. Excludes the other refinements.

Type number · GET query or POST JSON

Example / input hint: 100

sort_by
Sort byOptional

Price low to high, price high to low, rating high to low, or Google’s default relevance. Combines with one refinement.

Type string · GET query or POST JSON

Accepted values1234
free_shipping
Free shippingOptional

Only products with free shipping. Excludes the other refinements.

Type boolean · GET query or POST JSON · Default false

Accepted valuestruefalse
on_sale
On saleOptional

Only products Google marks as on sale. Excludes the other refinements.

Type boolean · GET query or POST JSON · Default false

Accepted valuestruefalse
small_business
Small businessOptional

Only products from small businesses. Excludes the other refinements.

Type boolean · GET query or POST JSON · Default false

Accepted valuestruefalse

Geography and localization

location
LocationOptional

Named search origin, up to 512 characters and 63 UTF-8 bytes once encoded. Conflicts with uule.

Type string · GET query or POST JSON

Example / input hint: Austin, Texas

uule
UULEOptional

Canonical Google location token, up to 2,048 characters. Conflicts with location.

Type string · GET query or POST JSON

Example / input hint: w+CAIQICI…

google_domain
Google domainOptional

Validated first-party Google domain.

Type string · GET query or POST JSON · Default google.com

Example / input hint: google.com

gl
CountryOptional

Two-letter country code, normalized to lowercase.

Type string · GET query or POST JSON

Example / input hint: us

hl
LanguageOptional

Language code such as en, en-GB, or de.

Type string · GET query or POST JSON

Example / input hint: en

device
DeviceOptional

Google returns its real layout for the selected device.

Type string · GET query or POST JSON · Default desktop

Accepted valuesdesktoptabletmobile

// response

Work with the complete JSON response

Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.

Response groups include inline_shopping_results, search_information, product_result, shopping_results, categorized_shopping_results, carousel_filters, filters, offers, product_reviews, related_products, search_metadata, search_parameters, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.

The SDK examples use raise_for_error() or raiseForError() so API errors are not mistaken for successful results.

Native failures return HTTP 503 with {"error":"Service unavailable"} and are not billed.

More Google APIs