Google Places
Local pack results from the Places tab: name, address, rating, category, CID.
Local results as shown in Google's Places tab: name, address, rating, category and IDs. Lighter than /v1/maps when you don't need coordinates for every result.
Request body
Send a JSON object with Content-Type: application/json. The same parameters also work
as a query string on GET /v1/places. JSON arrays are rejected: to run many queries at
once, use POST /v1/batches at half price. Unknown parameters
return 400 invalid_request with a message that names the replacement; see
strict validation.
| Parameter | 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…). |
language | string | en | Interface language, as a language code (en, de, fr, pt-BR…). |
location | string | Canonical location for local results, e.g. "Austin, Texas, United States". Overrides country for geo. | |
uule | string | Google-encoded location string. Use instead of location if you already have it. | |
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. One of: 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. |
Example request
Authenticate with Authorization: Bearer $SERPKITE_API_KEY (GET requests may pass
?api_key= instead). The official SDKs read
SERPKITE_API_KEY for you. See Authentication.
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 fields
| Field | Type | Description |
|---|---|---|
request | object | The normalised request, with defaults filled in: endpoint, engine, q, country, language, location, num, page, device, autocorrect… |
results[] | array | Same shape as /v1/maps: title, address, rating, rating_count, type, phone_number, website, place_id, cid… |
meta | object | request_id, credits_used, cached, cached_at, engine (the provider that answered), route (provider attempts, see Search providers), latency_ms, parse_quality (ok, partial, empty), resolved_urls. |
Every billed response also carries credit and latency headers
(X-Credits-Used, X-Credits-Remaining, X-Request-Id…).
Example response
{
"request": {
"endpoint": "places",
"engine": "google",
"q": "dentist",
"location": "Austin, Texas, United States",
"language": "en"
},
"results": [
{
"position": 1,
"title": "Example Family Dental",
"address": "100 Example St, Austin, TX 78701",
"rating": 4.9,
"rating_count": 356,
"type": "Dentist",
"phone_number": "(512) 555-0100",
"website": "https://dental.example.com",
"cid": "9876543210987654321"
}
],
"meta": {
"request_id": "req_01J8ZK4M6Q2V7",
"credits_used": 1,
"cached": false,
"engine": "google",
"latency_ms": 1034,
"parse_quality": "ok",
"resolved_urls": true
}
}Errors
Errors use one shape: {"error":{"code","message","request_id"}}. Errors are never billed.
Full list in Errors.
| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_request | A parameter is missing or invalid. |
| 401 | unauthorized | The API key is missing, invalid or revoked. |
| 402 | insufficient_credits | Your balance is too low. Buy a pack or wait for the monthly free grant. |
| 429 | rate_limited | Too many requests per second for your plan. Retry after the Retry-After header. |
| 503 | upstream_error | Google could not be fetched or parsed. Not billed; retry after Retry-After. |