Google Maps Search API
google_maps_search
87.5% off
Find businesses and places on Google Maps with location, contact, rating, and category data.
Search Google Maps for public business and place information. Use ll when a map viewport matters; follow-up tools accept the data_id or place_id returned in output.data.search_results.
TYPEMap search resultsPRICE$0.003125 per requestRESPONSEStructured JSON
{
"request_id": "example_google_maps_search",
"tool": "google_maps_search",
"output": {
"data": {
"search_results": [
{
"address": "San Francisco, CA",
"data_id": "example_data_id",
"place_id": "example_place_id",
"rank": 1,
"rating": 4.8,
"title": "Example Coffee"
}
]
},
"page": 0,
"query": "coffee San Francisco"
},
"usage": {
"price_usd": "0.003125",
"quota": 1563
}
}Google Maps Search API Pricing
Current pricing from the APINEED catalog. Failed requests are refunded; server usage records remain authoritative.
Quick Start
Invoke Google Maps Search with one APINEED key and a JSON request body.
Use your APINEED API key
Reuse the same APINEED API key that your application already uses for LLM, image, and video APIs. Keep it server-side.
Create API keyexport API_NEED_API_KEY=sk-apineed-v1-...Send the request
POST the same input shown in the Playground to /v1/tools/google_maps_search/invoke.
curl 'https://apineed.com/v1/tools/google_maps_search/invoke' \
-H "Authorization: Bearer $API_NEED_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"country": "us",
"language": "en",
"page": 0,
"query": "coffee San Francisco"
}'Read the response
Use output.data.search_results for the result and usage.price_usd for the settled request price.
const places = response.output.data.search_results;Endpoint
This endpoint uses bearer-token authentication and returns a synchronous normalized JSON response.
POST
/v1/tools/google_maps_search/invoke- Authorization
- Bearer $API_NEED_API_KEY
- Content-Type
- application/json
- Billing
- $0.003125 per request on successful invocation
- Response
- request_id, tool, output, usage
Google Maps Search API Parameters
Only query is required. Omitted localization values use the upstream defaults; page is a zero-based offset in steps of 20.
| Name | Type | Requirement | Values | Description |
|---|---|---|---|---|
query | string | Required | 1–500 characters | Google Maps search query, for example coffee or hospitals in New York. |
country | string | Optional | Pattern: ^[A-Za-z]{2}$ | Optional two-letter target country. Defaults upstream to us. |
data | string | Optional | 1–4096 characters | Optional advanced Google Maps data parameter copied from a Maps URL. |
domain | string | Optional | 1–253 characters | Optional Google domain. Defaults upstream to google.com. |
language | string | Optional | Pattern: ^[A-Za-z]{2}$ | Optional two-letter result language. Defaults upstream to en. |
ll | string | Optional | Pattern: ^@-?(?:\d+(?:\.\d+)?),-?(?:\d+(?:\.\d+)?),(?:\d+(?:\.\d+)?)$ | Optional map origin in @latitude,longitude,zoom format. Recommended for precise localization and pagination. |
page | integer | Optional | 0–10000 | Result offset. Start at 0 and increment by 20. |
place_id | string | Optional | 1–2048 characters | Optional Google Place ID for a place-focused search. |
Google Maps Search API Introduction
A practical guide to the request, response, billing, and application use cases.
Google Maps Search API
Search Google Maps for public business and place information. Use ll when a map viewport matters; follow-up tools accept the data_id or place_id returned in output.data.search_results.
Local discovery
Find businesses around a city, neighborhood, or map viewport.
Lead enrichment
Collect public addresses, phone numbers, websites, ratings, and categories.
Maps workflow entry
Obtain identifiers for place details, posts, photos, and reviews.
Request contract
Send a JSON object to /v1/tools/google_maps_search/invoke. Use the required fields, supported optional parameters, and bounds listed above. Undocumented parameters are not guaranteed to be supported.
Response and usage
Read the tool result from output.data.search_results and the settled charge from usage.price_usd. Keep request_id for troubleshooting. Preserve optional response fields rather than assuming they are always present.
Common Questions
Practical answers about authentication, parameters, pricing, and integration.
What does Google Maps Search API do?
Search Google Maps for public business and place information. Use ll when a map viewport matters; follow-up tools accept the data_id or place_id returned in output.data.search_results.
How do I authenticate?
Send a POST request to /v1/tools/google_maps_search/invoke with your APINEED API key in the Authorization: Bearer header. The same key can be used for model APIs. Keep the key on your server, not in browser code.
Can I try this API without entering an API key?
Yes. The Playground uses your signed-in APINEED account and shared balance. Sign in to send a request, or add funds if your balance is insufficient.
Which input fields are required?
Required fields: query. Check the parameter table for types, allowed values, and limits.
Can I omit optional parameters?
Yes. Optional fields: country, data, domain, language, ll, page, place_id. Omitted fields are not sent. Explicit false and 0 values are preserved; use the defaults and limits documented in the parameter table.
How much does a request cost?
The current catalog price is $0.003125 per request. The final charge is recorded in usage.price_usd and your account usage logs. Failed requests are refunded.
How should I read the response?
A successful invocation returns request_id, tool, output, and usage. Read the result from output, preserve request_id for troubleshooting, and inspect usage for the settled charge. The Playground shows the returned JSON without changing it.