GoddsAPIFree API key
GoddsAPI Docs

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

NameTypeDefaultDescription
qrequiredstring—What to look for, e.g. "plumber".
locationstring—Town or area, e.g. "Chicago, IL". Naming the town is what Google itself uses.
glstring—Country code.
hlstring—Language code.
pageinteger 1–5120 results per page.
api_keystring—Your key, if you can't send the Authorization: Bearer header. Never logged.
no_cachebooleanfalsetrue 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
    }
  ]
}