# Google Maps reviews

Takes data id, place id, hl and more, all optional. Served by Litescrape.

Get reviews for a Google Maps place. Fresh requests only; saved-query and conversation continuation tokens are not supported.

- Tool ID: `litescrape/google-reviews`
- Name in the catalog: Google Maps Reviews
- Provider: [Litescrape](/providers/litescrape.md)
- Capability: [Google Maps reviews](/tools/google-maps/reviews.md)
- Price: $0.00015 per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


```json
{
  "model": "per_call",
  "amountUsd": 0.00015
}
```

Pricing source: [https://litescrape.com/pricing](https://litescrape.com/pricing). $0.15 per 1,000 successful HTTP 200 requests; every native endpoint costs one call. Failed requests are not billed. Prepaid credits expire after six months..

Price verification date: 2026-11-03.

## Complete input schema


```json
{
  "additionalProperties": false,
  "properties": {
    "data_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Hexadecimal Google Maps feature identifier.\n\nFormat: 0x123:0x456 Exactly one of data_id or place_id is required."
    },
    "place_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Google place identifier for the business whose reviews should be returned.\n\nExactly one of place_id or data_id is required."
    },
    "hl": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Language used for returned review labels and place context."
    },
    "gl": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Lowercase two-letter country code used for regional localization."
    },
    "sort_by": {
      "anyOf": [
        {
          "enum": [
            "qualityScore",
            "newestFirst",
            "ratingHigh",
            "ratingLow"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Controls the order of returned reviews."
    },
    "topic_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Returns reviews associated with a topic ID from the topics response group.\n\nCannot be combined with query."
    },
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Returns reviews matching a free-text query.\n\nCannot be combined with topic_id."
    },
    "num": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Requested number of unique reviews to return.\n\nInitial 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": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "description": "Includes additional review-provider icon and scale metadata when available."
    }
  },
  "type": "object",
  "allOf": [
    {
      "oneOf": [
        {
          "required": [
            "data_id"
          ],
          "properties": {
            "data_id": {
              "not": {
                "enum": [
                  null,
                  ""
                ]
              }
            }
          }
        },
        {
          "required": [
            "place_id"
          ],
          "properties": {
            "place_id": {
              "not": {
                "enum": [
                  null,
                  ""
                ]
              }
            }
          }
        }
      ]
    }
  ]
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "litescrape/google-reviews",
  "input": {
    "data_id": "0x88e5b787f92eb419:0x837211a455038baa",
    "num": 2,
    "sort_by": "newestFirst"
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://litescrape.com/docs/reference#reviews-parameters)

[REST inspection](https://api.agentik.cc/v1/tools/litescrape/google-reviews) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/litescrape/google-reviews) · [Agent index](/llms.txt)