Skip to main content
POST
Get Google reviews

Description

This endpoint retrieves Google reviews for a business using either a keyword search, Google CID, or Place ID. It returns detailed review information including ratings, review text, reviewer profiles, and more.

Endpoint

Headers

  • Content-Type: application/json
  • Authorization: Bearer <API_KEY> (required)

Request Body

Note: At least one of keyword, cid, or placeId must be provided.

Responses

Success (200)

Returns the reviews and business information.
  • Content-Type: application/json
  • X-RateLimit-Limit: The rate limit for the user.
  • X-RateLimit-Remaining: The remaining number of requests for the user.

Bad Request (400)

Returned if the request is invalid.

Unauthorized (401)

Returned if the API key is invalid or missing.

Internal Server Error (500)

Returned if there’s an error during the review fetching process.

Example Request

Notes

  • Credit usage is calculated based on the number of reviews:
    • 50 credits per 10 reviews (rounded up)
    • e.g., 11 reviews would cost 100 credits
  • The maximum number of reviews that can be fetched in a single request is 4490
  • If using a Place ID, it should be in the format returned by Google Maps (e.g., “ChIJrTLr-GyuEmsRBfy61i59si0”)
  • The CID is Google’s unique identifier for a business location. It can be found in the URL when viewing a business on Google Maps

Rate Limiting

Rate limit headers (X-RateLimit-Limit and X-RateLimit-Remaining) are included in the response to indicate the user’s current rate limit status.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Parameters for fetching Google Business reviews. Provide at least one identifier (keyword, cid, or placeId).

keyword
string

Business name or query string.

cid
string

Google CID identifier for the business.

placeId
string

Google Place ID for the business.

reviews
integer
default:10

Maximum number of reviews to return.

Required range: x >= 1
language
string
default:en

ISO language code for the review content.

location
string
default:London,England,United Kingdom

Location bias used when searching by keyword.

sortBy
enum<string>
default:relevant

Sorting strategy for returned reviews.

Available options:
relevant,
newest,
highest_rating,
lowest_rating
requestSource
enum<string>

Optional identifier describing where the API request originated.

Available options:
API,
WEB,
MAKE_DOT_COM,
ZAPIER,
N8N,
PLAYGROUND,
DEFAULT_AUTOMATION,
AGENT_PREVIEW,
AGENT_LIVE,
AUTOPILOT,
STUDIO

Response

Google reviews returned.

type
string
required
se_domain
string
required
location_code
integer
required
language_code
string
required
check_url
string<uri>
required
datetime
string
required
title
string
required
rating
object
required
feature_id
string
required
place_id
string
required
cid
string
required
reviews_count
integer
required
items_count
integer
required
items
object[]
required
keyword
string | null
sub_title
string