# Get Google Maps Reviews for a Place

> Get Google Maps Reviews for a Place is a paid API for AI agents from agents.litescrape.com, paid per call via MPP, $0.000150/call, status unknown (last checked 2026-09-18).

Returns paginated Google Maps reviews for a specific place, including ratings, snippets, reviewer details, and topic groupings.

## Facts

- Endpoint: GET https://agents.litescrape.com/api/google/reviews
- Price: $0.000150/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-18
- Activations on Zero: 0
- Provider: agents.litescrape.com
- Website: https://agents.litescrape.com
- Canonical page: https://www.zero.xyz/c/agents-litescrape-com-get-google-maps-reviews-for-a-place-a138a2d8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-jL8A-dwU6VrRVVfW5UIz

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-litescrape-com-get-google-maps-reviews-for-a-place-a138a2d8
```

Example prompt: Pull me the 50 most recent Google Maps reviews for the place with ID ChIJN1t_tDeuEmsRUsoyG83frY4, sorted by newest first — I want the rating, snippet, and reviewer name for each one.

## When to prefer this

Choose this endpoint when you need structured Google Maps review data for a specific known place (identified by place_id or data_id), want to filter or sort reviews, or need to paginate through large review sets. Prefer it over general web search when you specifically want Google Maps review content with reviewer metadata and topic groupings. Use it over Yelp or TripAdvisor review endpoints when Google Maps is the target review source.

## Known failure modes

- Neither place_id nor data_id provided — returns 400 error with error_code indicating missing required parameter
- Both query and topic_id supplied simultaneously — mutually exclusive, returns 400 error
- next_page_token is invalid or expired — returns error indicating bad continuation token
- num exceeds 20 on a filtered or continuation request — capped or error returned
- Invalid place_id or data_id for a non-existent place — returns empty reviews array or 404-style error
- Rate limiting or upstream Google Maps unavailability — retryable error with retryable:true in response body

## How this service works

Returns reviews for one place identified by place_id or data_id (exactly one is required): each review carries the rating, snippet, date, and reviewer details, alongside the topics Google groups them into and pagination.next_page_token for the next page. Sort with sort_by, filter by free-text query or a topic_id, and set num for up to 100 reviews on an unfiltered first request (up to 20 on filtered or continuation requests). One call is one request.

## Output

Returns an array of reviews each containing a star rating, text snippet, relative date, and reviewer profile details; a topics array with topic_id values usable as filters; a pagination object with next_page_token and a ready-made next URL when more results exist; and search_metadata with request status and timing.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "gl": {
   "type": "string",
   "default": "us",
   "maxLength": 2,
   "minLength": 2,
   "description": "Two-letter country code, lowercase."
  },
  "hl": {
   "type": "string",
   "default": "en",
   "description": "Language for review labels and place context."
  },
  "num": {
   "type": "integer",
   "default": 8,
   "maximum": 100,
   "minimum": 1,
   "description": "Number of reviews. 1 to 100 on an unfiltered first request, 1 to 20 on filtered or continuation requests."
  },
  "query": {
   "type": "string",
   "description": "Only reviews matching this free-text query. Cannot be combined with topic_id."
  },
  "data_id": {
   "type": "string",
   "description": "Hexadecimal Maps feature ID in the form 0x123:0x456. Required unless place_id is supplied."
  },
  "sort_by": {
   "enum": [
    "qualityScore",
    "newestFirst",
    "ratingHigh",
    "ratingLow"
   ],
   "type": "string",
   "default": "qualityScore",
   "description": "Review order."
  },
  "place_id": {
   "type": "string",
   "description": "Google place ID of the business. Required unless data_id is supplied."
  },
  "topic_id": {
   "type": "string",
   "description": "Only reviews under this topic from the topics group. Cannot be combined with query."
  },
  "next_page_token": {
   "type": "string",
   "description": "Continuation token from pagination.next_page_token, passed back unchanged. Continuation requests default to ten reviews."
  },
  "source_metadata": {
   "type": "boolean",
   "default": false,
   "description": "Include review-provider icon and scale metadata when available."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "topics": {
   "type": "array",
   "items": {
    "type": "object"
   },
   "description": "Review topics with the topic_id usable as a filter."
  },
  "reviews": {
   "type": "array",
   "items": {
    "type": "object"
   },
   "description": "Reviews: rating, snippet, date, reviewer details."
  },
  "pagination": {
   "type": "object",
   "description": "Present when more results exist: next (a ready-made URL for the next page) or next_page_token."
  },
  "search_metadata": {
   "type": "object",
   "properties": {
    "id": {
     "type": "string"
    },
    "status": {
     "type": "string"
    },
    "total_time_taken": {
     "type": "number"
    }
   }
  },
  "search_parameters": {
   "type": "object",
   "description": "The request parameters as normalized by the API."
  }
 },
 "description": "Successful responses carry request metadata, the normalized parameters, and the result groups available for the operation. Optional groups are omitted when the source does not provide them. Errors are a JSON body with error, error_code, status_code, request_id, retryable, and the echoed search_parameters."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-litescrape-com-get-google-maps-reviews-for-a-place-a138a2d8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.litescrape.com](https://www.zero.xyz/host/agents.litescrape.com/llms.txt)