---
title: "Read Google Reviews"
method: POST
path: "/v1/tools/business_reviews"
---

# Read Google Reviews

`POST /v1/tools/business_reviews`

## Request

- Base URL: `https://unstuckapi.com`
- URL: `https://unstuckapi.com/v1/tools/business_reviews`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Read the most recent Google reviews of a local business: star rating, what the customer wrote, and the date. Give the business name and city, or a place_id from business_listings. Use it to judge a business's reputation or see what customers complain about.

Price: $0.05 per call. Charged once per call that returns a result, including an empty result list. Failed calls are free.

## Request body

- object
  - `business` string: Business name, e.g. "Joe's Pizza". Use with location.
  - `location` string: City and state, e.g. "Houston, TX".
  - `place_id` string: Google place_id (from business_listings), instead of name + location.
  - `limit` integer: How many reviews, default 10, max 20.

## Response `200`

Success

- object
  - `tool` 'business_reviews', required
  - `result` object, required
    - `business` string, nullable, required: Business name as Google lists it.
    - `overall_rating` number, nullable, required: Overall star rating, 1 to 5.
    - `reviews` object[], required
      - `rating` number, nullable, required
      - `text` string, nullable, required
      - `date` string, nullable, required: Review timestamp, or a relative time like "2 weeks ago".
  - `charged_usd` number, required
  - `balance_usd` number, required

## Other responses

- `400`: Invalid JSON or input. Not charged.
- `401`: Paid tool without a valid API key.
- `402`: Balance too low for this call. Not charged.
- `404`: Unknown tool.
- `422`: The tool failed. Not charged.
- `429`: Rate limited, free tries used up, or the uncharged-result limit reached. See Retry-After.

---

[API](https://skmtc.dev/unstuckapi/apis/unstuck-api.md) · [All operations](https://skmtc.dev/unstuckapi/apis/unstuck-api/llms.txt) · [OpenAPI document](https://skmtc.dev/unstuckapi/apis/unstuck-api/revisions/ef3ec951224f?raw)