Google Local API documentation

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.

curl --fail-with-body --get 'https://ecll-litescrape-v3--site-api-web.modal.run/api/google/local' \ --header "Authorization: Bearer $LITESCRAPE_API_KEY" \ --data-urlencode 'q=coffee shops' \ --data-urlencode 'start=0' \ --data-urlencode 'location=Austin, Texas' \ --data-urlencode 'gl=us' \ --data-urlencode 'hl=en' \ --data-urlencode 'device=desktop'

JSON POST request example

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

{
  "q": "coffee Austin Texas",
  "hl": "en",
  "gl": "us"
}

// request reference

Google Local parameters

Send query parameters with GET /api/google/local. 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.

Local query and entity

q

QueryRequired

Google Local query, up to 2,048 characters with no controls.

Type string · GET query or POST JSON

Example / input hint: coffee shops

ludocid

Local CIDOptional

Google local CID, up to 128 digits.

Type string · GET query or POST JSON

Example / input hint: 15667002398697190332

tbs

Search filterOptional

Google compatibility token forwarded unchanged; the provider may leave ranking unchanged.

Type string · GET query or POST JSON

Example / input hint: qdr:w

start

Start offsetOptional

Local-result offset through 10,000; source-exhausted offsets above 1,000 return empty.

Type integer · GET query or POST JSON · Default 0

Example / input hint: 0

Local geography

location

LocationOptional

Human-readable location, up to 512 characters.

Type string · GET query or POST JSON

Example / input hint: Austin, Texas

Cannot be combined with uule.

uule

UULEOptional

Canonical Google named-location token, up to 2,048 characters.

Type string · GET query or POST JSON

Example / input hint: w+CAIQICI…

Cannot be combined with location.

Local result localization

google_domain

Google domainOptional

Validated Google domain.

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

Example / input hint: google.com

Examples: google.com, google.co.uk, google.fr.

gl

CountryOptional

Country localization normalized to lowercase.

Type string · GET query or POST JSON

Example / input hint: us

hl

LanguageOptional

Google interface and result language.

Type string · GET query or POST JSON · Default en

Example / input hint: en

device

DeviceOptional

Compatibility value over device-invariant Maps data.

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 local_results, pagination, ads_results, discover_more_places, local_map, search_metadata, search_parameters, litescrape_pagination, 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.

Illustrative success response. Result groups and optional fields depend on upstream content.

{
  "local_results": [
    {
      "address": "12 High Street, London",
      "description": "Traditional breads and pastries.",
      "hours": "Open 24 hours",
      "link": "https://www.google.com/search?q=Legacy+Cafe&ludocid=2468013579",
      "links": {
        "website": "https://legacy.example/"
      },
      "max_rating": 5,
      "place_id": "2468013579",
      "position": 1,
      "position_in_page": 1,
      "price": "££",
      "price_score": 2,
      "provider_id": "2468013579",
      "rating": 4.6,
      "reviews": 2500,
      "reviews_original": "2.5K",
      "service_options": [
        "Delivery"
      ],
      "title": "Legacy Cafe",
      "type": "Bakery"
    }
  ],
  "pagination": {
    "other_pages": {
      "2": "https://www.google.com/search?q=bakery&tbm=lcl&start=10"
    }
  },
  "submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}

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

Google Local API

Integrate Google Local

JSON POST request example

Google Local parameters

Local query and entity

Local geography

Local result localization

Work with the complete JSON response

More Google APIs