Google Maps Places Scraper

sfoln/google-maps-search · Lead generation, Travel, SEO tools On request

Search Google Maps by keyword and location and get one clean JSON row per place: name, category, address, phone, website, rating, review count, opening hours, coordinates and place ID. $0.80 per 1,000 places + $0.002 per search. No browser needed.

Request access Run it$0.80 / 1,000 google maps place, more below

About

What it does

Google Maps Places Scraper searches Google Maps the way you would in the app — "roofing contractors Philadelphia", "dentist near Austin" — and returns one clean, normalized record per place: name, category, full address with parts, phone, website and domain, rating and review count, opening hours and open-now flag, coordinates, Google place ID and CID. Built for lead generation, local-SEO audits, market mapping and AI agents that need structured local business data in seconds, without running a browser.

Price

Price per delivered record

Event	Price	Per 1,000	Charged for
Google Maps place `google-maps-place`	$0.0008	$0.80 / 1,000	Charged once per Google Maps place (business) delivered as a dataset record.
Google Maps query `google-maps-query`	$0.002	$2 / 1,000	Charged once per search query that returned at least one place, or that returned none but was billed upstream (covers the per-search upstream fee).

Apify free plan: up to 10 items per run. Paid plans have no per-run cap; set maxTotalChargeUsd to cap spend.

Run

Call it from code, an agent or the Console

This API is private on Apify for now. Email us and we will publish it for you, usually within two working days. The calls below work once it is public. contact@sfoln.com

curl · synchronous run, rows in the response

curl -X POST "https://api.apify.com/v2/actors/sfoln~google-maps-search/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"queries":["pizza restaurants in Brooklyn"],"location":"New York,New York,United States","maxPlacesPerQuery":5}'

mcp.json · hosted Apify MCP server

{
  "mcpServers": {
    "apify": {
      "type": "http",
      "url": "https://mcp.apify.com?tools=sfoln/google-maps-search"
    }
  }
}

asynchronous run · for large batches

POST https://api.apify.com/v2/actors/sfoln~google-maps-search/runs?maxTotalChargeUsd=1
GET  https://api.apify.com/v2/actor-runs/{runId}            # until status is SUCCEEDED
GET  https://api.apify.com/v2/datasets/{defaultDatasetId}/items?format=json

Authenticate with an Apify API token. MCP clients can instead sign in with OAuth when prompted. Example prompt for an agent: Find 20 pizza restaurants in Brooklyn on Google Maps and list their ratings, review counts, phone numbers and websites.

Input

Input fields

Enter one or more Google Maps searches. Every place found becomes one dataset record; each query also gets one summary record.

Field	Type	Default	Meaning
`queries` *	`array`	required	Search queries What you would type into Google Maps, one per line (e.g. "roofing contractors Philadelphia"). To override the location for a single query write "query \| location". Also accepts objects { "query": "...", "location": "..." }. Accounts on the Apify free plan can process up to 10 queries per run.
`location`	`string`	—	Location Where to search: a DataForSEO location name ("Philadelphia,Pennsylvania,United States"), a numeric location code (2840 = United States), or coordinates "latitude,longitude[,zoom]" (e.g. "40.6782,-73.9442,13"). Leave empty for the whole United States.
`languageCode`	`string`	`"en"`	Language code Language of the results (ISO code such as en, de, es, fr, pt-br).
`maxPlacesPerQuery`	`integer`	`20`	Max places per query How many places to return (and pay for) per query. Google Maps returns at most about 100 places per search. Range 1–100.
`depth`	`integer`	—	Search depth (advanced) Number of results requested from Google per query (defaults to Max places per query, capped at 100 so each query stays one upstream search; values below Max places per query are raised to it). Places beyond Max places per query are discarded and never charged; raise it only if sponsored results crowd out regular places. Range 1–100.
`device`	`string`	`"desktop"`	Device Emulated device for the search. One of `"desktop"`, `"mobile"`.
`maxQueries`	`integer`	`100`	Max queries Safety cap on the number of queries processed in this run. Range 1–10000.
`concurrency`	`integer`	`3`	Concurrency How many queries run in parallel. Kept low because the upstream concurrency limit is shared by all runs of this Actor. Range 1–6.
`includeRaw`	`boolean`	`false`	Include raw upstream response Attach the unmodified provider item to each place record (larger output).

Example input

{
  "queries": [
    "pizza restaurants in Brooklyn"
  ],
  "location": "New York,New York,United States",
  "maxPlacesPerQuery": 5
}

Output

One record per input item

Records land in the run's dataset; a synchronous call returns them directly. Each has a status (ok is charged; everything else is free) and a charged flag. The run's OUTPUT record totals items and charges.

Field	Type	Meaning
`recordType`	`string`	Record type place = one Google Maps place (charged google-maps-place); query = per-query summary (charged google-maps-query when ok). e.g. `"place"`
`query`	`string`	Query Search query this record belongs to. e.g. `"pizza restaurants in Brooklyn"`
`location`	`string`	Location Location used for the search.
`input`	`string \| object \| null`	Input The query as entered ({ query, location? }).
`rank`	`integer \| null`	Rank Position in the Google Maps results (1 = first).
`title`	`string \| null`	Name Business / place name.
`originalTitle`	`string \| null`	Original name Name in the original language, when Google shows a translated one.
`description`	`string \| null`	Description Owner description, when shown.
`category`	`string \| null`	Category Primary Google category.
`additionalCategories`	`array`	Additional categories Secondary Google categories.
`categoryIds`	`array`	Category ids Google category ids, e.g. pizza_restaurant.
`address`	`string \| null`	Address Full formatted address.
`addressInfo`	`object \| null`	Address parts street, borough, city, zip, region, countryCode.
`phone`	`string \| null`	Phone Phone number as shown on Google Maps.
`url`	`string \| null`	Website Website URL.
`domain`	`string \| null`	Domain Website domain without www.
`placeId`	`string \| null`	Place ID Google place_id (ChIJ…).
`cid`	`string \| null`	CID Google customer id (maps.google.com/?cid=…).
`featureId`	`string \| null`	Feature ID Google feature id.
`latitude`	`number \| null`	Latitude WGS84 latitude.
`longitude`	`number \| null`	Longitude WGS84 longitude.
`rating`	`object \| null`	Rating { value, votesCount }
`ratingDistribution`	`object \| null`	Rating distribution Number of reviews per star (1–5).
`priceLevel`	`string \| null`	Price level inexpensive \| moderate \| expensive \| very_expensive
`hotelRating`	`number \| null`	Hotel stars Hotel class (stars), for hotels.
`isClaimed`	`boolean \| null`	Claimed Whether the owner has verified the listing.
`currentStatus`	`string \| null`	Current status open \| closed \| temporarily_closed \| closed_forever
`openNow`	`boolean \| null`	Open now True when open at crawl time.
`workHoursSummary`	`string \| null`	Opening hours Compact weekly hours, e.g. "Mon 09:00-17:00; …; Sun closed".
`workHours`	`object \| null`	Opening hours (structured) Day → list of "HH:MM-HH:MM" ranges; null = closed.
`mainImage`	`string \| null`	Main image URL of the main photo.
`totalPhotos`	`integer \| null`	Photos Number of photos on the listing.
`logo`	`string \| null`	Logo URL of the business logo.
`contactUrl`	`string \| null`	Contact URL Contact page link from the listing.
`contributorUrl`	`string \| null`	Contributor URL Owner / contributor profile link.
`bookOnlineUrl`	`string \| null`	Booking URL Online booking link.
`snippet`	`string \| null`	Snippet Short text shown in the results.
`googleMapsUrl`	`string \| null`	Google Maps URL Link to the place on Google Maps.
`placesReturned`	`integer`	Places returned Query records only: number of place records delivered for the query.
`googleMapsSearchUrl`	`string \| null`	Google Maps search URL Query records only: the Google Maps search the places come from.
`status`	`string`	Status ok \| not_found \| error \| skipped_budget \| skipped_free_plan \| skipped_trial e.g. `"ok"`
`charged`	`boolean`	Charged Whether this record incurred a pay-per-event charge.
`chargedEvent`	`string`	Charged event google-maps-place or google-maps-query.
`sponsored`	`boolean`	Sponsored true when a promotional trial paid for this record instead of you: delivered with charged false and never billed (present only then).
`promotionId`	`string`	Promotion Id of the promotional trial that sponsored this record (present only with sponsored).
`trialUnitsApplied`	`integer`	Trial events Events of this record the trial paid for (present only with sponsored).
`retailValueWaivedUsd`	`number`	Value waived (USD) What those events cost at the listed prices, in USD: what you did not pay (present only with sponsored).
`warnings`	`array`	Warnings Query records only: non-fatal notes (places reduced, budget reached...).
`error`	`object`	Error {code, message, provider?} when a query record is not ok; with status skipped_trial or skipped_free_plan the code says why the query did not run (allowance_exhausted, run_cap, not_eligible, ledger_unavailable, free_plan_subsidy_cap, …).
`source`	`string`	Source Upstream data source.
`fetchedAt`	`string`	Fetched at ISO timestamp.

Example record

{
  "recordType": "place",
  "query": "pizza restaurants in Brooklyn",
  "location": "New York,New York,United States",
  "rank": 1,
  "title": "Joe's Pizza",
  "category": "Pizza restaurant",
  "additionalCategories": [
    "Takeout restaurant"
  ],
  "categoryIds": [
    "pizza_restaurant",
    "takeout_restaurant"
  ],
  "address": "216 Bedford Ave, Brooklyn, NY 11249",
  "addressInfo": {
    "street": "216 Bedford Ave",
    "borough": "Williamsburg",
    "city": "Brooklyn",
    "zip": "11249",
    "region": "New York",
    "countryCode": "US"
  },
  "phone": "+1 718-555-0100",
  "url": "https://www.example-pizza.com/",
  "domain": "example-pizza.com",
  "placeId": "ChIJxxxxxxxxxxxxxxxxxxxx",
  "cid": "12345678901234567890",
  "featureId": "0x89c25bxxxxxxxx:0x1234xxxxxxxx",
  "latitude": 40.7176,
  "longitude": -73.9587,
  "rating": {
    "value": 4.6,
    "votesCount": 2134
  },
  "ratingDistribution": {
    "1": 60,
    "2": 40,
    "3": 120,
    "4": 400,
    "5": 1514
  },
  "priceLevel": "inexpensive",
  "isClaimed": true,
  "currentStatus": "open",
  "openNow": true,
  "workHoursSummary": "Mon 10:00-23:00; Tue 10:00-23:00; Wed 10:00-23:00; Thu 10:00-23:00; Fri 10:00-01:00; Sat 10:00-01:00; Sun 10:00-23:00",
  "workHours": {
    "monday": [
      "10:00-23:00"
    ],
    "sunday": [
      "10:00-23:00"
    ]
  },
  "mainImage": "https://lh5.googleusercontent.com/p/...",
  "totalPhotos": 812,
  "snippet": "216 Bedford Ave, Brooklyn, NY 11249",
  "googleMapsUrl": "https://www.google.com/maps?cid=12345678901234567890",
  "status": "ok",
  "charged": true,
  "chargedEvent": "google-maps-place",
  "source": "dataforseo",
  "fetchedAt": "2026-10-14T10:00:00.000Z"
}

Machine-readable

This page for agents

/actors/google-maps-search.json — this API as JSON
/actors/google-maps-search.md — this API as Markdown
/catalog.json — the whole catalogue