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

Google Maps reviews, up to 100 a call with rating, text, author, date, likes, images and owner replies, sorted by relevance, date or rating.

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

// from request to code

Integrate Google Maps Reviews

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

APIGoogle Maps Reviews
More options 9
Place

Supply exactly one Google place identifier.

Sort & filter

Filter by either a review topic or a free-text query.

Pagination

Continue from an opaque token returned by Litescrape.

Localization & enrichment

Control locale and optional source metadata.

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_reviews",
    "arguments": {
      "place_id": "ChIJT2h1HKZZwokR0kgzEtsa03k",
      "sort_by": "qualityScore",
      "hl": "en",
      "gl": "us"
    }
  }
}

Read all parameters →

JSON POST request example

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

POST · application/json
{
  "data_id": "0x88e5b787f92eb419:0x837211a455038baa",
  "num": 2,
  "sort_by": "newestFirst"
}

// request reference

Google Maps Reviews parameters

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

Place identifier

data_id
data_idConditional

Hexadecimal Google Maps feature identifier.

Type string · GET query or POST JSON

Example / input hint: 0x123:0x456

  • Format: 0x123:0x456
  • Exactly one of data_id or place_id is required.
place_id
place_idConditional

Google place identifier for the business whose reviews should be returned.

Type string · GET query or POST JSON

Example / input hint: ChIJT2h1HKZZwokR0kgzEtsa03k

  • Exactly one of place_id or data_id is required.

Sorting and localization

hl
LanguageOptional

Language used for returned review labels and place context.

Type string · GET query or POST JSON

Example / input hint: en

gl
CountryOptional

Lowercase two-letter country code used for regional localization.

Type string · GET query or POST JSON

Example / input hint: us

sort_by
Sort orderOptional

Controls the order of returned reviews.

Type string · GET query or POST JSON

Accepted valuesqualityScorenewestFirstratingHighratingLow

Review filters

topic_id
Topic IDOptional

Returns reviews associated with a topic ID from the topics response group.

Type string · GET query or POST JSON

Example / input hint: /m/… or fused topic ID

  • Cannot be combined with query.
query
Review queryOptional

Returns reviews matching a free-text query.

Type string · GET query or POST JSON

Example / input hint: parking

  • Cannot be combined with topic_id.
num
Number of reviewsOptional

Requested number of unique reviews to return.

Type integer | string · GET query or POST JSON

Example / input hint: 10

  • Initial unfiltered requests accept 1 through 100; the default remains eight.
  • Requests return one response with up to the requested number of available reviews.
  • Filtered and continuation requests accept 1 through 20.
source_metadata
Source metadataOptional

Includes additional review-provider icon and scale metadata when available.

Type string | boolean · GET query or POST JSON

Accepted valuestruefalse

Pagination

next_page_token
Next page tokenOptional

Opaque continuation token from pagination.next_page_token.

Type string · GET query or POST JSON

Example / input hint: Opaque token from the previous response

  • Pass the token back unchanged.
  • Continuation requests default to ten reviews unless num is provided.

// 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, place_info, reviews, topics, source_summaries, 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.

More Google APIs