Skip to main content
POST
Google Maps Search API

Get Google Maps Search

Fetch normalized search 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

  • query and location are required strings. country, latitude, longitude, zoom_level, and results_limit are optional.
  • latitude and longitude are independent numeric inputs. The current runtime validates their number type but does not impose numeric ranges.
  • zoom_level must be an integer from 0 through 21.
  • results_limit must be an integer from 1 through 2,000 and defaults to 100.

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
location
string
required
Minimum string length: 1
query
string
required

Search query.

Minimum string length: 1
country
string
Minimum string length: 1
latitude
number
Required range: -90 <= x <= 90
longitude
number
Required range: -180 <= x <= 180
results_limit
integer
default:100
Required range: 1 <= x <= 2000
zoom_level
integer
Required range: 0 <= x <= 21

Response

Task accepted

code
integer
data
object