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 Search API

Organic results, Knowledge Graph, People also ask, related searches and the AI Overview from Google Search, for any country, language or device.

GET https://api.litescrape.com/api/google/search

// from request to code

Integrate Google Search

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

APIGoogle Search
More options 42
Query or entity

Supply a query, Google local CID, or Knowledge Graph machine ID.

Geography

Choose location, uule, or latitude and longitude. Radius depends on device.

Knowledge Graph controls

Pass Google entity, layout, and cached-context tokens without rewriting them.

Localization

Control Google domain, language, country, restrictions, and device.

Filtering & pagination

Apply native Google filtering, vertical, date, safety, and offset controls.

Advanced query

Expose Google’s complete advanced-search parameter family.

Your request updates the code instantly.

Open the Playground →
https://mcp.litescrape.com/mcp

Add the server URL to your MCP client, then call the tool below. A free allowance is available without a key.

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

Read all parameters →

// request reference

Google Search parameters

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

The groups below list every request field, including compatibility restrictions. Read the extended reference for detailed types, defaults, parameter combinations and additional examples.

Query or entity

Supply a query, Google local CID, or Knowledge Graph machine ID.

fast_mode
Fast mode

Return organic results only. Skips AI Overview and all other result groups.

Accepted values / omission behavior Off (default)true Onfalse Off
q
Query

Required unless ludocid or kgmid is supplied; up to 2,048 characters.

Example / input hint: coffee shops in Austin

ludocid
Local CID

Decimal Google CID for a local entity search.

Example / input hint: 1234567890123456789

kgmid
Knowledge Graph ID

Google Knowledge Graph machine ID.

Example / input hint: /m/0k8z

Geography

Choose location, uule, or latitude and longitude. Radius depends on device.

location
Location

Human-readable location; conflicts with uule and lat/lon.

Example / input hint: Austin, Texas

uule
UULE

Pre-encoded Google location; conflicts with location and lat/lon.

Example / input hint: w+CAIQICI…

lat
Latitude

Between -90 and 90; supply with longitude.

Example / input hint: 30.2672

lon
Longitude

Between -180 and 180; supply with latitude.

Example / input hint: -97.7431

radius
Radius (meters)

Decimal meters from 1–199 on desktop or 1–1,000 on tablet/mobile; requires geography.

Example / input hint: 150.75

Knowledge Graph controls

Pass Google entity, layout, and cached-context tokens without rewriting them.

lsig
lsig

Opaque local/Knowledge Graph signature.

si
si

Opaque cached Google search context.

ibp
ibp

Google layout or expansion control.

uds
uds

Opaque Google filter token.

color_scheme
Color scheme

Select Google’s light or dark result presentation.

Accepted values / omission behavior Defaultlightdark

Localization

Control Google domain, language, country, restrictions, and device.

hl
Language

Google interface and result language.

Example / input hint: en

gl
Country

Two-letter country localization code.

Example / input hint: us

google_domain
Google domain

A Google domain such as google.com or google.co.uk.

Example / input hint: google.com

cr
Country restrict

One or more countryXX values joined with |.

Example / input hint: countryUS

lr
Language restrict

One or more lang_xx values joined with |.

Example / input hint: lang_en

device
Device

Select desktop, tablet, or mobile request behavior.

Accepted values / omission behaviordesktoptabletmobile

Filtering & pagination

Apply native Google filtering, vertical, date, safety, and offset controls.

tbs
Search filter

Google tbs filter string.

safe
Safe search

Google adult-content filtering.

Accepted values / omission behavior Defaultactiveoff
nfpr
Auto-correction

Set Google nfpr to 0 or 1.

Accepted values / omission behavior Default01
filter
Similar results

Set Google result filtering to 0 or 1.

Accepted values / omission behavior Default01
pws
Personalization

Set Google pws to 0 or 1; 0 asks for non-personalized results.

Accepted values / omission behavior Default01
peek_pws
Personalization peek

Set Google peek_pws to 0 or 1; forwarded to Google unchanged.

Accepted values / omission behavior Default01
tbm
Vertical

Google vertical such as nws, shop, vid, lcl, or pts. Google Images (isch) is not supported.

Example / input hint: nws

start
Start offset

Non-negative Google result offset.

Example / input hint: 0

num
Results requested

Best-effort first-page result count, 1 to 100.

Example / input hint: 10

Advanced query

Expose Google’s complete advanced-search parameter family.

as_dt
Site mode

Include or exclude as_sitesearch.

Accepted values / omission behavior Defaulti includee exclude
as_epq
Exact phrase

Exact phrase query.

as_eq
Exclude phrase

Excluded phrase query.

as_lq
Links to URL

Require results that link to this HTTP(S) URL.

Example / input hint: https://example.com

as_nlo
Range low

Integer lower bound; requires as_nhi.

Example / input hint: 10

as_nhi
Range high

Integer upper bound; requires as_nlo.

Example / input hint: 100

as_oq
Any terms

Any-of terms.

as_q
All terms

Additional all-of terms.

as_qdr
Date range

d, w, m, or y with an optional positive count.

Example / input hint: m3

as_rq
Related to URL

Find pages related to this HTTP(S) URL.

Example / input hint: https://example.com

as_sitesearch
Site hostname

Hostname to include or exclude.

Example / input hint: example.com

oq
Original query

Autocomplete original-query lineage value; forwarded verbatim.

gs_lp
Autocomplete lineage

Google gs_lp autocomplete-session token; forwarded verbatim.

sclient
Search client

Google client identifier such as gws-wiz-serp.

Example / input hint: gws-wiz-serp

// response

Work with the complete JSON response

Response groups include organic_results, knowledge_graph, ai_overview, related_questions, related_searches, shopping_results, immersive_products, perspectives, pagination. 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.

More Google APIs