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
/v1/places/searchSend 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®ion=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
| Field | Type | Description |
|---|---|---|
| data[].id | string | null | Place ID (ChIJ…), the primary identifier; null for the rare places without one. |
| data[].ids | object | Every identifier: place_id, cid, feature_id and google_maps_url. |
| data[].name | string | Name of the place. |
| data[].categories | string[] | Categories, the main one first, e.g. “Tuscan restaurant”. |
| data[].address | object | formatted, street, postal_code, city, region and country_code. |
| data[].location | object | lat and lng. |
| data[].rating | number | null | Average rating, from 1 to 5. |
| data[].review_count | integer | null | Number of reviews on Google Maps. |
| data[].phone | string | null | Phone number in local format. |
| data[].website | string | null | Website of the business. |
| data[].status | string | null | operational, temporarily_closed or permanently_closed; null when Google does not say. |
| pagination | object | next_cursor and has_more: repeat the call with the cursor until has_more is false. |
| meta.credits_used | integer | Credits charged for this call: always 1. |
Parameters
| Parameter | In | Type | Default | Description |
|---|---|---|---|---|
| q | query | string | required | What to search, as you would type it in Google Maps, e.g. trattoria in Florence. Up to 300 characters. |
| language | query | string | en | Language of names and addresses, e.g. en, it, pt-BR. |
| region | query | string | us | Two-letter country code that biases the results, e.g. it. |
| lat, lng | query | number | – | Centre of the area to search, in degrees. Give both or neither: only one of them is refused with 400 invalid_location. |
| radius_km | query | number | – | Radius of the area around lat and lng, up to 100 km. |
| limit | query | integer | 20 | Places per page, from 1 to 20. |
| cursor | query | string | – | 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
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.
Related APIs and tools
- Google Maps Reviews APIEvery review of a place, paged with cursors, sortable, filtered by language and translated.
- Google Maps Place Details APIAddress, coordinates, opening hours, phone, website, attributes and photos of one place.
- Free Google Maps reviews toolPaste a Google Maps link and see the place with its 10 newest reviews, without an account.
Every parameter, field and error code is in the API reference.
Start searching Google Maps places
Create an account and get 200 free calls every month. Your first search is one quick start away.