Google Maps
Google Maps listings for a search: name, rating, review count, address, phone, website, category, position and place_id.
GET /api/v1/mapsCost: 1 per request (0 if cached)Example request
curl -G "https://goddsapi.com/api/v1/maps" \ -H "Authorization: Bearer YOUR_API_KEY" \ --data-urlencode "q=plumber" \ --data-urlencode "location=Chicago, IL"
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
qrequired | string | — | What to look for, e.g. "plumber". |
location | string | — | Town or area, e.g. "Chicago, IL". Naming the town is what Google itself uses. |
gl | string | — | Country code. |
hl | string | — | Language code. |
page | integer 1–5 | 1 | 20 results per page. |
api_key | string | — | Your key, if you can't send the Authorization: Bearer header. Never logged. |
no_cache | boolean | false | true forces a fresh search (charged). Otherwise identical queries within your plan's cache window are served free. |
Example response
Shortened to one item per list.
{
"search_metadata": {
"id": "srch_3f9c0d7b2a41e6c8d5b19a70",
"status": "success",
"api_version": "v1",
"endpoint": "maps",
"provider": "serpapi",
"cached": false,
"credits_charged": 1,
"time_taken_ms": 1840,
"created_at": "2026-11-20T15:04:05.000Z"
},
"search_parameters": {
"endpoint": "maps",
"q": "plumber",
"location": "Chicago, IL",
"page": 1
},
"local_results": [
{
"position": 1,
"name": "Example Plumbing",
"place_id": "ChIJkaUn1JPTD4gR7ZWpE9cCuow",
"rating": 4.8,
"review_count": 1556,
"address": "1137 W Example Ave, Chicago, IL 60614",
"phone": "(773) 555-0171",
"website": "https://www.example-plumbing.com/",
"category": "Plumber",
"latitude": 41.9214708,
"longitude": -87.6573983
}
]
}