Skip to main content
POST
Google Maps Reviews API

Get Google Maps Reviews

Fetch normalized reviews data from Google Maps. Each successfully returned standard result costs 0.15 credits. List endpoints reserve by results_limit and settle against the actual result count.

Request Body

Request Constraints

  • urls is required and must contain at least one non-empty string. Each value must parse to a hostname of google.com, goo.gl, or a subdomain of either host.
  • Any scheme is accepted when an authority and hostname are present, protocol-relative references are also accepted, and no specific path is required.
  • days_limit is optional and must be an integer of at least 1; the runtime imposes no maximum.
  • results_limit must be an integer from 1 through 2,000 and defaults to 100 for the whole task.

Use with MCP

A successful request returns a task_id. Poll it with socq_get_task, then read normalized records from results.items.

Result Fields

Completed Task Response

Authorizations

Authorization
string
header
required

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

Body

application/json
urls
string[]
required

A non-empty list of references whose parsed hostname is google.com, goo.gl, or a subdomain of either host. Any scheme is accepted when an authority and hostname are present; protocol-relative references are also accepted, and no specific path is required.

Minimum array length: 1
Minimum string length: 1
days_limit
integer
Required range: x >= 1
results_limit
integer
default:100
Required range: 1 <= x <= 2000

Response

Task accepted

code
integer
data
object