Lead Generation

Google Maps Places

Local business listings from Google Maps — name, website, phone, address, category and rating.

google-maps-placesgoogle-mapsgoogle-placeslead-generationlocal-businessdirectory

656 rows in the dataset

Download the dataset

Get every row this scraper has collected as one CSV or JSONL file. If the data is older than maxAgeHours, the scraper is re-run with its configured settings first. The key needs the datasets:export scope.

DOWNLOAD_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/datasets/google-maps-places/downloads" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{"maxAgeHours":24,"format":"csv"}' | jq -r '.id')while true; do  STATUS=$(curl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY" | jq -r '.status')  [ "$STATUS" != "refreshing" ] && break  sleep 5donecurl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID/file" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -o dataset.csv

At its current 656 rows, this download costs 7 credits when the data is fresh enough, or 14 credits when it has to be refreshed first.

The rate is 1 credit per 100 rows cached and 2 credits live, charged on the rows in the dataset when the download becomes ready. A failed refresh is not charged. The file stays downloadable for 24 hours. See pricing.

Start a run

To choose the targets yourself, send the parameters below as input. The call returns 202 with the run; the key needs the scrapers:run scope and the account a positive credit balance.

curl -X POST "https://api.pandorlabs.com/v1/scrapers/google-maps-places/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "query": "coffee shop",      "locations": [        "new york",        "los angeles",        "chicago",        "houston",        "phoenix",        "philadelphia",        "san antonio",        "san diego",        "dallas",        "austin",        "miami",        "seattle",        "san francisco"      ],      "requireWebsite": false,      "requirePhone": false    }  }'

A run is billed at the live rate once it finishes: 2 credits per 100 rows it collected. A run that collects nothing costs nothing.

Parameters

Every parameter is optional. Anything you leave out uses the default shown here; an unknown name or an invalid value is rejected with a 400 that lists each problem.

Targeting

query
string
Search query
The trade or business type to look for. Combined with each location.
Default
coffee shop
Example
plumber
locations
string[]
Locations
Metro names from the built-in table (new york, los angeles, chicago, houston, phoenix, philadelphia, san antonio, san diego, dallas, austin, miami, seattle, san francisco) or explicit `lat,long` pairs. Any coordinate pair works, so a larger target set is a matter of pasting one in rather than editing the scraper.
Default
["new york","los angeles","chicago","houston","phoenix","philadelphia","san antonio","san diego","dallas","austin","miami","seattle","san francisco"]
Example
austin, dallas, 30.2672,-97.7431
requireWebsite
boolean
Require a website
Drops listings with no website. Leave off to keep businesses whose absent site is the reason to call them.
Default
false
requirePhone
boolean
Require a phone number
Drops listings with no published phone. Google omits the phone on a large minority of results.
Default
false
maxPlaces
number
Max places per run
Rows persist and re-runs upsert, so a ceiling here bounds one run, not the dataset.
Default
2000
Range
1 to 100000

Advanced

path
enum
Collection path
Auto prefers the supported API. Choosing `api` with no key configured fails the run rather than silently falling back.
Default
auto
Allowed values
auto
api
pb
apiVariant
enum
Places API variant
Legacy Text Search was closed to new Google Cloud customers in March 2025 and only works on accounts that already used it.
Default
new
Allowed values
new
legacy
apiKey
string
API key override
Defaults to GOOGLE_MAPS_API_KEY, then GOOGLE_PLACES_API_KEY. Set here only to run against a different key.
Default
none
gridSize
number
Grid size (map endpoint)
Side of the square of search points built around each location. Costs gridSize² requests per location, so 5 is 25 and 15 is 225.
Default
5
Range
1 to 20
zoom
number
Map altitude (map endpoint)
The endpoint’s `1d` parameter, in metres. Lower covers less ground per request but hits the 20-result cap less often.
Default
13499.795714815926
Range
100 to 10000000
resultsPerRequest
number
Results per request (map endpoint)
Google truncates above 20 without saying so.
Default
20
Range
1 to 20
requestDelayMs
number
Delay between requests (ms)
Default
800
Range
0 to 30000

Input as JSON Schema

The same schema the API validates against. Use it as a tool input schema or to generate a typed client.

inputSchema

{  "type": "object",  "additionalProperties": false,  "properties": {    "query": {      "type": "string",      "maxLength": 2000,      "title": "Search query",      "description": "The trade or business type to look for. Combined with each location.",      "default": "coffee shop",      "examples": [        "plumber"      ]    },    "locations": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Locations",      "description": "Metro names from the built-in table (new york, los angeles, chicago, houston, phoenix, philadelphia, san antonio, san diego, dallas, austin, miami, seattle, san francisco) or explicit `lat,long` pairs. Any coordinate pair works, so a larger target set is a matter of pasting one in rather than editing the scraper.",      "default": [        "new york",        "los angeles",        "chicago",        "houston",        "phoenix",        "philadelphia",        "san antonio",        "san diego",        "dallas",        "austin",        "miami",        "seattle",        "san francisco"      ],      "examples": [        "austin, dallas, 30.2672,-97.7431"      ]    },    "requireWebsite": {      "type": "boolean",      "title": "Require a website",      "description": "Drops listings with no website. Leave off to keep businesses whose absent site is the reason to call them.",      "default": false    },    "requirePhone": {      "type": "boolean",      "title": "Require a phone number",      "description": "Drops listings with no published phone. Google omits the phone on a large minority of results.",      "default": false    },    "maxPlaces": {      "type": "number",      "minimum": 1,      "maximum": 100000,      "title": "Max places per run",      "description": "Rows persist and re-runs upsert, so a ceiling here bounds one run, not the dataset.",      "default": 2000    },    "path": {      "type": "string",      "enum": [        "auto",        "api",        "pb"      ],      "title": "Collection path",      "description": "Auto prefers the supported API. Choosing `api` with no key configured fails the run rather than silently falling back.",      "default": "auto"    },    "apiVariant": {      "type": "string",      "enum": [        "new",        "legacy"      ],      "title": "Places API variant",      "description": "Legacy Text Search was closed to new Google Cloud customers in March 2025 and only works on accounts that already used it.",      "default": "new"    },    "apiKey": {      "type": "string",      "maxLength": 2000,      "title": "API key override",      "description": "Defaults to GOOGLE_MAPS_API_KEY, then GOOGLE_PLACES_API_KEY. Set here only to run against a different key."    },    "gridSize": {      "type": "number",      "minimum": 1,      "maximum": 20,      "title": "Grid size (map endpoint)",      "description": "Side of the square of search points built around each location. Costs gridSize² requests per location, so 5 is 25 and 15 is 225.",      "default": 5    },    "zoom": {      "type": "number",      "minimum": 100,      "maximum": 10000000,      "title": "Map altitude (map endpoint)",      "description": "The endpoint’s `1d` parameter, in metres. Lower covers less ground per request but hits the 20-result cap less often.",      "default": 13499.795714815926    },    "resultsPerRequest": {      "type": "number",      "minimum": 1,      "maximum": 20,      "title": "Results per request (map endpoint)",      "description": "Google truncates above 20 without saying so.",      "default": 20    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 30000,      "title": "Delay between requests (ms)",      "default": 800    }  }}

Run, poll, read rows

The run is asynchronous. Poll it until it reaches a terminal status and its billing is paid, then page through its rows. Until then the rows endpoint answers 409 (still queued or running) or 402 (payment required).

RUN_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/scrapers/google-maps-places/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "query": "coffee shop",      "locations": [        "new york",        "los angeles",        "chicago",        "houston",        "phoenix",        "philadelphia",        "san antonio",        "san diego",        "dallas",        "austin",        "miami",        "seattle",        "san francisco"      ],      "requireWebsite": false,      "requirePhone": false    }  }' | jq -r '.id')while true; do  RUN=$(curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY")  STATUS=$(echo "$RUN" | jq -r '.status')  BILLING=$(echo "$RUN" | jq -r '.billing.status')  case "$STATUS" in queued|running) ;; *) [ "$BILLING" != "pending" ] && break ;; esac  sleep 5doneecho "$RUN" | jq '{status, rowCount, billing}'curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID/rows?page=1&limit=100" \  -H "Authorization: Bearer $PANDORLABS_KEY"

See the API reference for pagination, cancelling and listing runs.

Output fields

Rows have no fixed schema; these are the fields observed in the rows collected so far. Coverage is the share of rows where the field is present.

Field	Type	Coverage
average_rating	number	94%
categories	array	100%
cid	string	100%
city	string	41%
country_code	string	99%
description	string	15%
entity_id	string	100%
full_address	string	99%
hours	array	94%
latitude	number	100%
longitude	number	100%
name	string	100%
neighborhood	string	81%
phone	string	93%
phone_e164	string	93%
place_id	string	100%
primary_category	string	100%
review_count	number	66%
search_location	string	100%
search_query	string	100%
source_path	string	100%
state	string	98%
street_address	string	92%
timezone	string	100%
website	string	80%
website_domain	string	80%
zip	string	41%
created_at	date	100%
first_seen_at	date	100%
last_seen_at	date	100%
updated_at	date	100%
_id	string	100%