Skip to main content
POST
Google maps search

Request contract

  • Method and path: POST /apis/v1/serpapi/google-maps-search
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/serpapi/google-maps-search
  • Runtime facts: 1d8d2010628130bd331b470b564dd1cd5784989899ccf3e384a8de02a69e0558
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Usage-based billing; Default request estimate: $0.0253 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.0253
  • Declared unit rate (USD): 1e-06
  • Billing unit: provider_credit
  • Cost contract: response_units
  • Published reference multiplier: 1.0
  • Declared maximum count/units: 10000000
  • Settlement evidence source: response_body

Authorizations

Authorization
string
header
required

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

Body

application/json
q
string
required

Search query for Google Maps (e.g., 'coffee shops', 'restaurants near Central Park').

Examples:

"pizza in New York"

"hotels near LAX"

ll
string

GPS coordinates for the search, formatted as '@latitude,longitude,zoom_level'. Required when using pagination (start parameter). If unspecified and start is not provided, search may be less geographically specific or use a default location. Results are strictly viewport-bound to the area defined by the coordinates and zoom level; adjust coordinates and paginate via start to cover adjacent areas.

Examples:

"@40.7455096,-74.0083012,14z"

"@34.052235,-118.243683,12z"

start
integer

Starting result index for pagination, used to get subsequent pages of results. When start is provided, ll parameter becomes required. For the first page, omit start (or use start=0 only if ll is also provided).

Examples:

0

10

20

Response

Tool result data

results
object
required