POST /v1/maps
Google Maps API
Search Google Maps like a user does and get every business with its address, categories, place ID, rating, review count, coordinates, opening hours, phone number and website. Pick any city with location, or pin a map point and zoom with ll.
Overview
What the Google Maps API does
The Google Maps API returns the list of places Google Maps shows for a search such as "coffee roasters in Berlin". It's the data a person sees in the Maps sidebar, not Google's paid Places API, so there's no per-field SKU pricing and no Cloud billing account.
Results come from Google Maps search data, so the address, categories (type, types), coordinates, website, phone and hours are there in every language, Russian included. Hours come both as display text (opening_hours) and as structured weekly_hours you can compute with.
Every place includes place_id, cid and fid, which you can pass to the Place Details API for its full listing or to the Google Reviews API for its reviews. Use location for a city or region, or ll (for example @52.52,13.40,14z) to search the map at that point and zoom wherever your servers are. Without either, Google guesses the area, so a query like "coffee" needs one of them.
What you get
-
places[]array - position, title, address, country, latitude, longitude, timezone, rating, rating_count, price_level, type, types, website, phone_number, international_phone_number, opening_hours, weekly_hours, description, thumbnail_url, google_maps_url, place_id, cid, fid.
-
requestobject - Echo of the normalized request (endpoint, engine, q, country, language, page…), handy for logging.
-
metaobject - request_id, credits_used, cached, engine, latency_ms, resolved_urls and parse_quality. parse_quality=empty means the call was not billed.
Request
curl https://api.serpkite.com/v1/maps \
-H "Authorization: Bearer $SERPKITE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"q":"coffee roasters","location":"Berlin, Germany"}'Response (illustrative, placeholder domains)
{
"request": {
"endpoint": "maps",
"engine": "google",
"q": "coffee roasters",
"location": "Berlin, Germany",
"country": "de",
"language": "en",
"page": 1
},
"results": [
{
"position": 1,
"title": "Example Coffee Roasters",
"address": "Beispielstraße 12, 10115 Berlin, Germany",
"latitude": 52.5321,
"longitude": 13.3849,
"rating": 4.7,
"rating_count": 1284,
"price_level": "€€",
"type": "Coffee roasters",
"types": [
"Coffee roasters",
"Cafe"
],
"website": "https://roasters.example.com",
"phone_number": "030 0000000",
"international_phone_number": "+49 30 0000000",
"country": "DE",
"timezone": "Europe/Berlin",
"opening_hours": {
"Monday": "8 am–6 pm",
"Saturday": "9 am–5 pm",
"Sunday": "Closed"
},
"weekly_hours": {
"monday": [
{
"open": "08:00",
"close": "18:00"
}
],
"saturday": [
{
"open": "09:00",
"close": "17:00"
}
],
"sunday": []
},
"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0",
"cid": "10219612364826466528"
}
],
"meta": {
"request_id": "req_01J8ZK4M6Q2V7",
"credits_used": 1,
"engine": "google",
"cached": false,
"latency_ms": 812,
"resolved_urls": true,
"parse_quality": "ok"
}
}
Every response also carries X-Credits-Used, X-Credits-Remaining,
X-Cache and X-Tokens-Estimate headers.
Run this query in the playground
Reference
Parameters
The parameters /v1/maps accepts, in the JSON body or the query string.
| Name | Type | Default | Description |
|---|---|---|---|
q
required
|
string | – | The search query. Required. Up to 2,048 characters. |
country
|
string | us | Country to search from, as a two-letter ISO code (us, gb, de, in…). Defaults to the country a location ends in. |
language
|
string | en | Interface language, as a language code with an optional region (en, de, pt-BR, zh-TW…). |
location
|
string | – | Canonical location for local results, e.g. "Austin, Texas, United States". Ending in a country name also sets country. |
ll
|
string | – | Map point and zoom as "@lat,lng,zoomz", e.g. @52.52,13.40,14z (zoom defaults to 14z). Searches the map there wherever the request comes from. Overrides location. |
page
|
integer | 1 | Results page, 1–10. Each page is billed separately. |
format
|
string | json | Response format. markdown is LLM-ready prose; compact is JSON with only the fields agents need. Values: json, compact, markdown. |
fields
|
string | – | Comma-separated projection, e.g. results.title,results.link,knowledge_graph. Cuts tokens. |
max_age
|
integer | – | Accept a cached result up to this many seconds old. Cache hits cost 50% of the credits. |
Full reference, error codes and headers are in the /v1/maps reference. Queue up to 100 requests at half price with POST /v1/batches.
Use cases
What people build with the Google Maps API
Local market research
Count businesses by category and city, with their rating, hours and website.
Local SEO audits
See who ranks in Maps for a keyword, and their rating and review count.
Local agents
Let an assistant answer "find a dentist open Saturday near me" with real data.
Market mapping
Count and geocode competitors across neighborhoods or cities.
Store locator checks
Verify that your locations' hours and phone numbers are right on Google.
Pricing
Google Maps API pricing
Cost per call
1 credit
per page of results
- From $0.60 per 1,000 calls at volume.
- Credits never expire. No subscription.
- Failed, empty and blocked calls are refunded.
- 2,500 free credits = 2,500 calls, then 1,000 credits a month.
For reference: Serper lists Google searches at $1.00 per 1k on its entry tier and $0.30 at its best tier, and its credits expire after 6 months. SerpKite credits cost $1.00 to $0.60 per 1k.
| Pack | Price | Per 1k credits | Per 1k calls | Calls per pack |
|---|---|---|---|---|
| Starter | $10 | $1.00 | $1.00 | 10,000 |
| Growth | $50 | $0.80 | $0.80 | 62,500 |
| Pro | $300 | $0.60 | $0.60 | 500,000 |
FAQ
Google Maps API: common questions
Keep exploring
Related APIs and integrations
Use it from
Start building
Start with the Google Maps API
2,500 free credits, then 1,000 every month. No credit card.