Google Maps Places API

The ScrapeMapsAPI Google Maps Places API searches Google Maps by text, like the search box of the Maps app, and returns the places it finds as JSON: name, categories, full address, coordinates, rating and review count, phone, website and business status, with every identifier of the place. Bias the search to an area with a latitude, a longitude and a radius, choose the language and the country, and page through the results with a cursor, 20 places at a time.

No credit card needed. One API key works on every endpoint.

Quick example

GET/v1/places/search

Send your key in the X-API-Key header (or as Authorization: Bearer) to the base URL https://api.scrapemapsapi.com. The official SDKs wrap the same call: pip install scrapemapsapi or npm install scrapemapsapi.

curl "https://api.scrapemapsapi.com/v1/places/search?q=trattoria%20in%20Florence&region=it&limit=20" \
  -H "X-API-Key: key_your_api_key"

Sample response

A successful call answers with HTTP 200: the places in data, the cursor of the next page in pagination and the cost in meta.credits_used, 1 credit per call. Sponsored results are left out.

{
  "data": [
    {
      "id": "ChIJ8cLgoQNUKhMReGlaTjwrH40",
      "ids": {
        "place_id": "ChIJ8cLgoQNUKhMReGlaTjwrH40",
        "cid": "10168894021638449528",
        "feature_id": "0x132a5403a1e0c2f1:0x8d1f2b3c4e5a6978",
        "google_maps_url": "https://www.google.com/maps?cid=10168894021638449528"
      },
      "name": "Trattoria Da Neri",
      "categories": [
        "Tuscan restaurant",
        "Italian restaurant"
      ],
      "address": {
        "formatted": "Via dei Neri, 42/r, 50122 Firenze FI, Italy",
        "street": "Via dei Neri, 42/r",
        "postal_code": "50122",
        "city": "Firenze",
        "region": "Toscana",
        "country_code": "IT"
      },
      "location": {
        "lat": 43.7681,
        "lng": 11.258
      },
      "rating": 4.6,
      "review_count": 2843,
      "phone": "055 123 4567",
      "website": "https://www.trattoriadaneri.example",
      "status": "operational"
    }
  ],
  "pagination": {
    "next_cursor": "eyJvIjoyMCwicSI6InRyYXR0b3JpYSJ9",
    "has_more": true
  },
  "meta": {
    "credits_used": 1,
    "cached": false,
    "query": "trattoria in Florence",
    "language": "en",
    "region": "it"
  }
}

Illustrative values for a fictional restaurant: a real response carries the live data of the place you ask for.

Response fields

FieldTypeDescription
data[].idstring | nullPlace ID (ChIJ…), the primary identifier; null for the rare places without one.
data[].idsobjectEvery identifier: place_id, cid, feature_id and google_maps_url.
data[].namestringName of the place.
data[].categoriesstring[]Categories, the main one first, e.g. “Tuscan restaurant”.
data[].addressobjectformatted, street, postal_code, city, region and country_code.
data[].locationobjectlat and lng.
data[].ratingnumber | nullAverage rating, from 1 to 5.
data[].review_countinteger | nullNumber of reviews on Google Maps.
data[].phonestring | nullPhone number in local format.
data[].websitestring | nullWebsite of the business.
data[].statusstring | nulloperational, temporarily_closed or permanently_closed; null when Google does not say.
paginationobjectnext_cursor and has_more: repeat the call with the cursor until has_more is false.
meta.credits_usedintegerCredits charged for this call: always 1.

Parameters

ParameterInTypeDefaultDescription
qquerystringrequiredWhat to search, as you would type it in Google Maps, e.g. trattoria in Florence. Up to 300 characters.
languagequerystringenLanguage of names and addresses, e.g. en, it, pt-BR.
regionquerystringusTwo-letter country code that biases the results, e.g. it.
lat, lngquerynumber–Centre of the area to search, in degrees. Give both or neither: only one of them is refused with 400 invalid_location.
radius_kmquerynumber–Radius of the area around lat and lng, up to 100 km.
limitqueryinteger20Places per page, from 1 to 20.
cursorquerystring–pagination.next_cursor of the previous page. Cursors are opaque and belong to one query.

Without a key the API answers 401 missing_api_key, with a wrong or disabled key 401 invalid_api_key, and with no credits left 402 insufficient_credits. When Google Maps cannot be reached the answer is 503 upstream_unavailable: retry in a minute. Errors are never billed, and every error code is documented.

What you get, and what you don't

Search returns the places Google Maps lists for a query, the organic results without ads, in the order Google ranks them. Each place carries enough to show it on a map or in a list; the Place Details API adds opening hours, attributes and photos, and the Reviews API what customers say.

Results are cached for 24 hours per query, language, region and area. A query that matches exactly one place, such as a business name and its city, returns that single place.

Use cases

Lead generation

Build lists of businesses by category and city, such as dentists in Lyon or gyms in Austin, with phone, website and address ready for your CRM.

Maps and store locators

Show the places around a point with their coordinates, rating and status, and refresh them on a schedule instead of copying them by hand.

Market research

Count the competitors in a neighbourhood, compare their ratings and review counts, and find areas where a category is missing.

Data matching

Match the names and addresses in your database to Google Maps places and store their place IDs, to fetch details and reviews later.

Search and the official Google Places API

Google's Places API offers Text Search with its own pricing tiers and field masks, and needs a Google Cloud project with billing enabled. It is the choice when you need Google's official terms.

ScrapeMapsAPI returns the same kind of results with one API key and one bill, at 1 credit per page of 20 places: 1,000 places take 50 calls, $0.15 at the list price and $0.075 with the largest credit pack.

Pricing

Search is billed per call: 1 credit for a page of up to 20 places, so ask for full pages. A query without results is a call too (1 credit). The 200 free calls of every month cover up to 4000 places.

  • 200 free calls every month, no credit card
  • Then $3 per 1,000 calls, down to $1.50 with credit packs
  • 1 credit per successful call; errors are free
  • Credits valid for 12 months from purchase, no subscription

See all prices and credit packs

Also in the MCP server for AI assistants

Ask your assistant “find the best-rated trattorias near Santa Croce in Florence” and it calls search_places, then get_place or get_reviews for the ones you pick.

The MCP server gives Claude, Cursor and other MCP clients the same data as tools. Run it with uvx scrapemapsapi-mcp (or npx -y scrapemapsapi-mcp) with your API key in SCRAPEMAPSAPI_API_KEY; the MCP server guide has the setup for each client. Tool calls are billed like API calls.

Tools: search_places, get_place, get_reviews

Frequently asked questions

How many places does one search return?
Up to 20 per page (limit from 1 to 20). When pagination.has_more is true, repeat the call with cursor set to pagination.next_cursor to get the next ones.
Can I search around a location?
Yes. Pass lat and lng (both, or neither) and optionally radius_km, up to 100 km. The area biases the results, as moving the map does in Google Maps.
How much does a place search cost?
1 credit per call, and a call returns up to 20 places. 200 free calls a month, then $3 per 1,000 calls, down to $1.50 with credit packs.
Does the search return opening hours and reviews?
Search returns a summary of each place: name, categories, address, coordinates, rating, review count, phone, website and status. Opening hours, attributes and photos come from the place details endpoint (1 credit), reviews from the reviews endpoint.
Do I need a Google Cloud account?
No. One ScrapeMapsAPI API key, in the X-API-Key header or as a Bearer token, is all you need.
Are ads included in the results?
No. Sponsored entries are skipped: you get the organic results in the order of Google Maps.

Start searching Google Maps places

Create an account and get 200 free calls every month. Your first search is one quick start away.