POST /v1/places
Google Places API
The local results Google shows for a search: name, address, coordinates, rating, review count, category, hours and IDs for every business, localized to any city and language. Pay per page, not per field.
Overview
What the Google Places API does
The Google Places API endpoint returns the local results for a search. It returns the same Google Maps search results and fields as /v1/maps, with the same location and ll rules, under the name local SEO tools and Places API users look for.
It's a practical alternative to Google's Places API when you need search results rather than a places database: no billing account, no field masks and no per-SKU pricing. For one place's full listing, use the Place Details API.
What you get
-
places[]array - Same as the Maps API: position, title, address, country, latitude, longitude, timezone, rating, rating_count, type, types, website, phone_number, opening_hours, weekly_hours, 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/places \
-H "Authorization: Bearer $SERPKITE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"q":"dentist","location":"Austin, Texas, United States"}'Response (illustrative, placeholder domains)
{
"request": {
"endpoint": "places",
"engine": "google",
"q": "dentist",
"location": "Austin, Texas, United States",
"country": "us",
"language": "en",
"page": 1
},
"results": [
{
"position": 1,
"title": "Example Family Dental",
"address": "100 Example Ave, Austin, TX 78701",
"latitude": 30.2711,
"longitude": -97.7437,
"rating": 4.9,
"rating_count": 612,
"type": "Dentist",
"types": [
"Dentist",
"Cosmetic dentist"
],
"website": "https://dental.example.com",
"phone_number": "(512) 555-0100",
"country": "US",
"timezone": "America/Chicago",
"place_id": "ChIJexample1111111111111",
"cid": "4412233445566778899"
},
{
"position": 2,
"title": "Downtown Example Dentistry",
"address": "250 Sample St, Austin, TX 78702",
"rating": 4.6,
"rating_count": 208,
"type": "Cosmetic dentist",
"cid": "1234567890123456789"
}
],
"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/places 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 | – | Maps and places: search the map at a point and zoom, as "@lat,lng,zoomz", e.g. "@52.52,13.40,14z" (zoom defaults to 14z), 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/places reference. Queue up to 100 requests at half price with POST /v1/batches.
Use cases
What people build with the Google Places API
Local rank tracking
Track your position in the local pack per city and keyword.
Directory building
Assemble business directories by category and region.
Assistant lookups
Resolve "plumber in Leeds" to real, rated businesses.
Pricing
Google Places 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 Places API: common questions
Keep exploring
Related APIs and integrations
Start building
Start with the Google Places API
2,500 free credits, then 1,000 every month. No credit card.