Skip to main content
POST
Google Maps Place Details API

Get Google Maps Places

Fetch normalized places data from Google Maps. Each non-empty submitted URL reserves 0.15 credits. The task settles at 0.15 credits per successfully returned standard result, and unused reserved credits are refunded.

Request Body

Request Constraints

  • urls is required and must contain at least one non-empty string. This endpoint does not accept results_limit.
  • 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, and protocol-relative references are also accepted.
  • The runtime does not require a specific path such as /maps/place. Its internal result ceiling is the number of non-empty submitted URLs.

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

Response

Task accepted

code
integer
data
object