Google Maps API

Search businesses and places by keyword and area, get address, phone, website, hours, rating and attributes of a place, and page through its reviews with owner responses.

Overview and use cases on the Google Maps API page; response format, pagination and errors are the same for every API (conventions).

GET/v1/maps/places/search3 credits / call

Places matching a query, optionally around a point, up to 20 per call.

ParameterInTypeDefaultDescription
q*querystring—What to search, e.g. dentist in Berlin
languagequerystringenResult language (en, it, pt-BR...)
regionquerystringusTwo-letter country code to bias results
latquerynumber (-90–90)—Latitude of the search centre (with lng)
lngquerynumber (-180–180)—Longitude of the search centre (with lat)
radius_kmquerynumber (0.1–100)—Radius around lat/lng in km
limitqueryinteger (1–20)20Places per page (max 20)
cursorquerystring—pagination.next_cursor of the previous page
curl "https://api.scrapecrate.com/v1/maps/places/search?q=pizzeria%20in%20Milan" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "data": [
    {
      "id": "ChIJ2eUgeAK6j4ARbn5u_wAGqWA",
      "name": "Pizzeria Da Mario",
      "primary_category": "Pizza restaurant",
      "categories": [
        "Pizza restaurant",
        "Italian restaurant"
      ],
      "address": {
        "formatted": "Via Roma 1, 20121 Milano MI, Italy",
        "city": "Milano",
        "country_code": "IT"
      },
      "location": {
        "lat": 45.4642,
        "lng": 9.19
      },
      "rating": 4.6,
      "review_count": 1284,
      "phone": "+39 02 1234567",
      "website": "https://example.com",
      "status": "operational"
    }
  ],
  "pagination": {
    "next_cursor": "eyJwIjoyfQ",
    "has_more": true
  },
  "meta": {
    "request_id": "req_8f2c1a9b0d3e4f5a6b7c",
    "credits_used": 3,
    "credits_remaining": 9999
  }
}

Get place details

GET/v1/maps/places/{place_id}3 credits / call

Full details of a place by place ID, CID or feature ID.

ParameterInTypeDefaultDescription
place_id*pathstring—Place ID, CID or feature ID (use /places/resolve for URLs)
languagequerystringenResult language
regionquerystringusTwo-letter country code
curl "https://api.scrapecrate.com/v1/maps/places/ChIJ2eUgeAK6j4ARbn5u_wAGqWA" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "data": {
    "id": "ChIJ2eUgeAK6j4ARbn5u_wAGqWA",
    "cid": "12345678901234567890",
    "name": "Pizzeria Da Mario",
    "primary_category": "Pizza restaurant",
    "address": {
      "formatted": "Via Roma 1, 20121 Milano MI, Italy",
      "street": "Via Roma 1",
      "postal_code": "20121",
      "city": "Milano",
      "country_code": "IT"
    },
    "location": {
      "lat": 45.4642,
      "lng": 9.19
    },
    "rating": 4.6,
    "review_count": 1284,
    "phone": "+39 02 1234567",
    "website": "https://example.com",
    "timezone": "Europe/Rome",
    "opening_hours": {
      "weekly": [
        {
          "day": "monday",
          "open": "12:00",
          "close": "23:00"
        }
      ]
    },
    "attributes": {
      "Service options": [
        "Dine-in",
        "Takeaway"
      ]
    },
    "photos": [
      {
        "url": "https://example.com/photo.jpg",
        "width": 1024,
        "height": 768
      }
    ]
  },
  "meta": {
    "request_id": "req_8f2c1a9b0d3e4f5a6b7c",
    "credits_used": 3,
    "credits_remaining": 9999
  }
}

List place reviews

GET/v1/maps/places/{place_id}/reviews3 credits / call

Reviews of a place with rating, text, translation, date and owner response.

ParameterInTypeDefaultDescription
place_id*pathstring—Place ID, CID or feature ID
sortqueryrelevant | newest | highest | lowestrelevantReview order
languagequerystringenLanguage of translations
limitqueryinteger (1–20)20Reviews per page (max 20, one page of the source)
cursorquerystring—pagination.next_cursor of the previous page
curl "https://api.scrapecrate.com/v1/maps/places/ChIJ2eUgeAK6j4ARbn5u_wAGqWA/reviews" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "data": [
    {
      "id": "ChZDSUhNMG9nS0VJQ0FnSUNz",
      "rating": 5,
      "published_at": "2026-10-02T19:12:00Z",
      "language": "it",
      "text": "Pizza ottima, servizio veloce.",
      "translated_text": "Great pizza, fast service.",
      "author": {
        "id": "a_5f2c9e",
        "review_count": 31,
        "is_local_guide": true
      },
      "owner_response": {
        "text": "Grazie!",
        "published_at": "2026-10-03T08:00:00Z"
      }
    }
  ],
  "pagination": {
    "next_cursor": "eyJwIjoyfQ",
    "has_more": true
  },
  "meta": {
    "request_id": "req_8f2c1a9b0d3e4f5a6b7c",
    "credits_used": 3,
    "credits_remaining": 9999
  }
}

Resolve a Maps URL or ID

GET/v1/maps/places/resolve3 credits / call

Turn any Google Maps URL, short link, CID or feature ID into the place IDs.

ParameterInTypeDefaultDescription
input*querystring—A Maps URL, short link, CID or feature ID
curl "https://api.scrapecrate.com/v1/maps/places/resolve?input=https%3A%2F%2Fmaps.app.goo.gl%2Fabc123" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "data": {
    "place_id": "ChIJ2eUgeAK6j4ARbn5u_wAGqWA",
    "cid": "12345678901234567890",
    "feature_id": "0x4786c6aec34636a1:0xab7f4e27101a2e13",
    "google_maps_url": "https://www.google.com/maps?cid=12345678901234567890"
  },
  "meta": {
    "request_id": "req_8f2c1a9b0d3e4f5a6b7c",
    "credits_used": 3,
    "credits_remaining": 9999
  }
}