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

Google Maps places, 20 a page with rating, reviews, address, hours, website and coordinates, for any query and viewport, or one place by ID.

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

// from request to code

Integrate Google Maps

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

APIGoogle Maps
More options 21
Search or exact place

Use a query, or one exact-place identifier. The API validates combinations.

Geography

Choose one viewport family: ll, location, or latitude and longitude.

Filters

Filter places by price, rating and opening hours.

Localization & pagination

Control locale and the native Maps result offset.

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, 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_maps",
    "arguments": {
      "q": "coffee shops in Austin, TX",
      "type": "search",
      "ll": "@30.2672,-97.7431,14z",
      "hl": "en",
      "gl": "us"
    }
  }
}

Read all parameters →

JSON POST request example

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

POST · application/json
{
  "q": "787 Coffee New York",
  "type": "search",
  "hl": "en",
  "gl": "us"
}

// request reference

Google Maps parameters

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

Request and search query

q
QueryConditional

The business, category, address, or natural-language query to search. Required when type is search.

Type string · GET query or POST JSON

Example / input hint: coffee shops in Austin, TX

  • Examples: coffee shops in Austin, dentist near Denver
type
Result typeConditional

Chooses a result search or an exact place response. Required for query and filter searches.

Type string · GET query or POST JSON

Accepted valuessearchplace
  • Use place when sending an exact-place data sequence.

Geographic location

ll
ViewportOptional

A complete viewport containing latitude, longitude, and either zoom or radius.

Type string · GET query or POST JSON

Example / input hint: @30.2672,-97.7431,14z

  • Format: @lat,lon,14z or @lat,lon,5000m
location
LocationOptional

A named geographic location resolved by the API. Cannot be combined with ll or lat/lon.

Type string · GET query or POST JSON

Example / input hint: Austin, Texas

  • Requires z or m.
lat
LatitudeOptional

Latitude for a coordinate-based viewport. Must be supplied with lon and either z or m.

Type string | number · GET query or POST JSON

Example / input hint: 30.2672

lon
LongitudeOptional

Longitude for a coordinate-based viewport. Must be supplied with lat and either z or m.

Type string | number · GET query or POST JSON

Example / input hint: -97.7431

z
ZoomConditional

Google Maps zoom level for location or lat/lon geography.

Type string | number · GET query or POST JSON

Example / input hint: 14

  • Accepted range: 3 through 30.
  • Cannot be combined with m.
m
Radius (meters)Conditional

Search radius in meters for location or lat/lon geography.

Type string | integer · GET query or POST JSON

Example / input hint: 5000

  • Accepted range: 1 through 15,028,132.
  • Cannot be combined with z.
nearby
Nearby wordingOptional

Uses the supplied geography as a nearby-search scope.

Type boolean · GET query or POST JSON

Accepted valuestruefalse
  • Requires ll, location, or a lat/lon pair.

Exact place

data
data sequenceConditional

A Google Maps protobuf parameter sequence for search filters or an exact place.

Type string · GET query or POST JSON

Example / input hint: !4m5!3m4…

  • Maximum length: 8,192 characters.
  • Exact-place data requires type=place.
place_id
place_idConditional

A Google place identifier used to resolve one exact place or request live foot traffic.

Type string · GET query or POST JSON

Example / input hint: ChIJ…

  • Cannot be combined with data_cid or exact-place data on the primary Maps endpoint.
  • It is the only required parameter on /api/google/maps/popular-times.
  • Every response is fetched live; places without published data return popular_times: null.
data_cid
data_cidConditional

A decimal Google CID used to resolve one exact place.

Type string | integer · GET query or POST JSON

Example / input hint: 1234567890

  • Cannot be combined with place_id or exact-place data.

Localization

hl
LanguageOptional

Language used for Google Maps labels and returned text.

Type string · GET query or POST JSON

Example / input hint: en

  • Examples: en, es, fr, de
gl
CountryOptional

Two-letter country code used for regional result localization.

Type string · GET query or POST JSON

Example / input hint: us

  • Examples: us, gb, ca, au
google_domain
Google domainOptional

Validated Google domain used for the request.

Type string · GET query or POST JSON

Example / input hint: google.com

  • Examples: google.com, google.co.uk, google.ca

Search filters

min_price
Minimum priceOptional

Minimum price level for returned places.

Type string | integer · GET query or POST JSON

Example / input hint: 1

  • Must be non-negative and cannot exceed max_price.
max_price
Maximum priceOptional

Maximum price level for returned places.

Type string | integer · GET query or POST JSON

Example / input hint: 4

  • Must be non-negative and cannot be lower than min_price.
min_rating
Minimum ratingOptional

Preferred minimum Google rating.

Type string | number · GET query or POST JSON

  • Google treats this as a relevance preference.
open_state
Open stateOptional

Filters by the current open state.

Type string · GET query or POST JSON

Accepted valuesnow24h
  • Cannot be combined with open_on_day or open_at_hour.
open_on_day
Open on dayOptional

Filters for places open on a specific day.

Type string · GET query or POST JSON

Accepted valuesmontuewedthufrisatsun
open_at_hour
Open at hourOptional

Filters for places open at a specific hour using 24-hour time.

Type string | integer · GET query or POST JSON

Example / input hint: 18

  • Accepted range: 0 through 23.
  • Requires open_on_day.

Pagination

start
Start offsetOptional

Native Maps result offset: 0, 20, 40, and so on. Each request returns up to 20 places and each successful request costs one credit.

Type string | integer · GET query or POST JSON

Example / input hint: 0

  • Use pagination.next when it is present instead of constructing the next request manually.

// 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 search_metadata, search_parameters, search_information, local_results, 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.

200 · application/json
{
  "search_metadata": {
    "id": "3dc823489468ef4a8017866a",
    "status": "Success",
    "json_endpoint": "https://ecll-litescrape-v3--site-api-web.modal.run/api/google/maps?q=Blue+Bottle+Coffee+SF&type=search&google_domain=google.com&hl=en",
    "created_at": "2026-09-19 22:31:24 UTC",
    "processed_at": "2026-09-19 22:31:27 UTC",
    "total_time_taken": 2.882,
    "google_maps_url": "https://www.google.com/maps/search/Blue%20Bottle%20Coffee%20SF/@40.7128,-74.006,50000m/?hl=en"
  },
  "search_parameters": {
    "q": "Blue Bottle Coffee SF",
    "type": "search",
    "google_domain": "google.com",
    "hl": "en"
  },
  "search_information": {
    "local_results_state": "Results for exact spelling",
    "query_displayed": "Blue Bottle Coffee SF"
  },
  "local_results": [
    {
      "position": 1,
      "title": "Blue Bottle Coffee",
      "place_id": "ChIJ3UFdD2KAhYARYOHf4j7DshM",
      "data_id": "0x808580620f5d41dd:0x13b2c33ee2dfe160",
      "data_cid": "1419411507436839264",
      "reviews_link": "https://ecll-litescrape-v3--site-api-web.modal.run/api/google/reviews?data_id=0x808580620f5d41dd%3A0x13b2c33ee2dfe160&hl=en",
      "photos_link": "https://www.google.com/maps/place/@37.791306399999996,-122.4009679,17z/data=!4m2!3m1!1s0x808580620f5d41dd%3A0x13b2c33ee2dfe160?entry=photos",
      "gps_coordinates": {
        "latitude": 37.791306399999996,
        "longitude": -122.4009679
      },
      "place_id_search": "https://ecll-litescrape-v3--site-api-web.modal.run/api/google/maps?place_id=ChIJ3UFdD2KAhYARYOHf4j7DshM&google_domain=google.com&hl=en",
      "provider_id": "/g/11b7xjjm26",
      "rating": 4.4,
      "reviews": 1295,
      "type": "Coffee shop",
      "types": [
        "Coffee shop"
      ],
      "type_id": "coffee_shop",
      "type_ids": [
        "coffee_shop"
      ],
      "address": "115 Sansome St, San Francisco, CA 94104",
      "country": "United States",
      "open_state": "Closed · Opens 8 AM Sun",
      "hours": "Closed · Opens 8 AM Sun",
      "operating_hours": {
        "saturday": "8 AM–2 PM",
        "sunday": "8 AM–2 PM",
        "monday": "6:30 AM–5:30 PM",
        "tuesday": "6:30 AM–5:30 PM",
        "wednesday": "6:30 AM–5:30 PM",
        "thursday": "6:30 AM–5:30 PM",
        "friday": "6:30 AM–5:30 PM"
      },
      "phone": "(510) 661-3510",
      "website": "https://bluebottlecoffee.com/us/eng/northern-california-cafes?utm_source=google&utm_medium=organic&utm_campaign=cafe_business_listing_norcal",
      "description": "Trendy cafe chain offering upscale coffee and pastries, plus coffee beans and brewing equipment.",
      "order_online": "https://www.google.com/searchviewer/42?cvd=CLw_EicKJeICIjIgEhkiF9LX29IPEQoNL2cvMTFiN3hqam0yNhgAOgMI8A0%3D&g2lbs=AEzIGDser7WG-cKvae2Mrv33gvWksxBKHgLb9PDYYzUR3pj1lLmCJv-0CQwsgKlo16uOsngYXXR8&hl=en-US&gl=us&fo_m=MfohQo559jFvMUOzJVpjPL1YMfZ3bInYwBDuMfaXTPp5KXh-&utm_source=tactile&gei=PA2vape2EK_6wbkPjv_y4Aw&ei=PA2vape2EK_6wbkPjv_y4Aw&fo_s=OA,SOE&opi=79508299&ebb=1&cs=0&foub=mcpp",
      "thumbnail": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWmLGxfdtV0Hozce99l85XRy0KB0dADBBNUjinRGbxODq6tPWkP1yRqUU5qQpMyVQQIBwAAasjUDuIHTAXVofjeV8Hg4xwstMT9cuVps-E0hwuQMn10GYodFEpnp_m_MRdM5Zsv4=w114-h86-k-no",
      "source_thumbnail": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWmLGxfdtV0Hozce99l85XRy0KB0dADBBNUjinRGbxODq6tPWkP1yRqUU5qQpMyVQQIBwAAasjUDuIHTAXVofjeV8Hg4xwstMT9cuVps-E0hwuQMn10GYodFEpnp_m_MRdM5Zsv4=w114-h86-k-no",
      "extensions": [
        {
          "accessibility": [
            "Wheelchair accessible entrance",
            "Wheelchair accessible restroom"
          ]
        }
      ]
    },
    {
      "position": 2,
      "title": "Blue Bottle Coffee",
      "place_id": "ChIJSy28upiAhYARkoxpzFnW7b4",
      "data_id": "0x80858098babc2d4b:0xbeedd659cc698c92",
      "data_cid": "13757888117856636050",
      "reviews_link": "https://ecll-litescrape-v3--site-api-web.modal.run/api/google/reviews?data_id=0x80858098babc2d4b%3A0xbeedd659cc698c92&hl=en",
      "photos_link": "https://www.google.com/maps/place/@37.7763342,-122.4232375,17z/data=!4m2!3m1!1s0x80858098babc2d4b%3A0xbeedd659cc698c92?entry=photos",
      "gps_coordinates": {
        "latitude": 37.7763342,
        "longitude": -122.4232375
      },
      "place_id_search": "https://ecll-litescrape-v3--site-api-web.modal.run/api/google/maps?place_id=ChIJSy28upiAhYARkoxpzFnW7b4&google_domain=google.com&hl=en",
      "provider_id": "/m/03p12r2",
      "rating": 4.6,
      "reviews": 904,
      "type": "Coffee shop",
      "types": [
        "Coffee shop"
      ],
      "type_id": "coffee_shop",
      "type_ids": [
        "coffee_shop"
      ],
      "address": "315 Linden St, San Francisco, CA 94102",
      "country": "United States",
      "open_state": "Open · Closes 7:30 PM",
      "hours": "Open · Closes 7:30 PM",
      "operating_hours": {
        "saturday": "6:30 AM–7:30 PM",
        "sunday": "6:30 AM–7:30 PM",
        "monday": "6:30 AM–6:30 PM",
        "tuesday": "6:30 AM–6:30 PM",
        "wednesday": "6:30 AM–6:30 PM",
        "thursday": "6:30 AM–6:30 PM",
        "friday": "6:30 AM–7:30 PM"
      },
      "phone": "(510) 661-3510",
      "website": "https://bluebottlecoffee.com/us/eng/northern-california-cafes?utm_source=google&utm_medium=organic&utm_campaign=cafe_business_listing_norcal",
      "description": "Trendy cafe chain offering upscale coffee drinks & pastries, plus beans & brewing equipment.",
      "order_online": "https://www.google.com/searchviewer/42?cvd=CLw_EiQKIuICHzIdEhYiFNLX29IPDgoKL20vMDNwMTJyMhgAOgMI8A0%3D&g2lbs=AEzIGDtIcb6fFUtKfOHseftjYgret-QegTzX1Z4SQcYof7Pp0NcQ3y5hjNXRF9uqzZzrXJ3eygjN&hl=en-US&gl=us&fo_m=MfohQo559jFvMUOzJVpjPL1YMfZ3bInYwBDuMfaXTPp5KXh-&utm_source=tactile&gei=PA2vape2EK_6wbkPjv_y4Aw&ei=PA2vape2EK_6wbkPjv_y4Aw&fo_s=OA,SOE&opi=79508299&ebb=1&cs=0&foub=mcpp",
      "thumbnail": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWl-KIqwUTpLEdcV0FUsIt6gpcx48v9CLNTGXJ9BPLpBNsii8LgZWjvMMM3ndkQ9KSWobhK5avkPAgi7CKodEbCaCtFNFFxi-Qgrf1Lfq-rDF3CvcjVJaYMclcj1gaL9xr1gjCwz=w114-h86-k-no",
      "source_thumbnail": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWl-KIqwUTpLEdcV0FUsIt6gpcx48v9CLNTGXJ9BPLpBNsii8LgZWjvMMM3ndkQ9KSWobhK5avkPAgi7CKodEbCaCtFNFFxi-Qgrf1Lfq-rDF3CvcjVJaYMclcj1gaL9xr1gjCwz=w114-h86-k-no",
      "extensions": [
        {
          "accessibility": [
            "Wheelchair accessible entrance",
            "Wheelchair accessible parking lot"
          ]
        }
      ]
    }
  ],
  "submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}

More Google APIs