Cover a bounding box, circle, or custom polygon with a search grid to collect every business Google Maps exposes for a query, well beyond the usual 120-result cap on a single search. Output fields: na
Cover a bounding box, circle, or custom polygon with a search grid to collect every business Google Maps exposes for a query, well beyond the usual 120-result cap on a single search.
dataspryva~google-maps-grid-based-market-saturation-scanner)references/example-input.jsonreferences/input-schema.jsonreferences/output-fields.jsonShort video breakdown:
Use this skill when the user wants:
Do not use it for private, login-protected or paywalled data.
One JSON row per result. Columns from the Actor's dataset schema:
name: NamecategoryName: CategorytotalScore: RatingreviewsCount: Reviewsaddress: Addressphone: Phonewebsite: WebsiteplaceId: Place IdfeatureId: Feature Idkgmid: KgmidgoogleMapsUrl: Google Maps Urllocation: LocationrankInCell: Rank In CellAll 29 declared fields: references/output-fields.json.
| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| searchQuery | string | yes | | Type of business to search for (e.g., 'pharmacy', 'restaurant', 'dentist'). |
| locationName | string | no | | Name of a public Google Maps location (e.g., 'Brooklyn, NY'). Google resolves its real center anonymously, then the actor scans the user-controlled radiusKm around it. |
| boundingBox | object | no | | Geographic bounding box defining the scan area. Provide north/south/east/west coordinates. |
| circleCenter | object | no | | Center point for a circular scan area. Use with radiusKm. |
| radiusKm | number | no | 5 | Radius in kilometers for circular scan area (used with circleCenter or locationName). |
| customGeolocation | object | no | | Custom GeoJSON Polygon defining the scan boundary. |
| zoomLevel | integer | no | 15 | Controls grid cell granularity. Higher = smaller cells, more thorough coverage. |
| maxPlacesPerCell | integer | no | 120 | Maximum businesses to collect from each grid cell (1–260; Google's ranked window for one cell reaches roughly 136–213 places). |
| maxPagesPerCell | integer | no | 13 | How many 20-result pages to read per cell. Deeper pages surface more businesses — page 1 finds about 20% of a cell's places, page 9 finds all of them. |
| maxTotalResults | integer | no | 10000 | Maximum total businesses to extract across all cells. Stops scanning when reached. |
| deduplicateResults | boolean | no | true | Remove duplicate businesses that appear in multiple adjacent grid cells. |
| enrichDetails | boolean | no | false | Open each place's page for extra fields (price level, Plus Code, photo sample, rating histogram, open/closed status). |
| minRating | number | no | | Only include businesses with a rating at or above this value (1.0–5.0). Leave empty to include all. |
| language | string | no | en | Language for Google Maps interface and results. |
Example:
{
"keyword": "coffee shop",
"location": "Denver, CO",
"gridSize": 7,
"radius": 5,
"maxResultsPerPoint": 20
}
Set APIFY_TOKEN, then call the synchronous endpoint for small and medium runs (it waits up to 300 seconds):
curl -s -X POST "https://api.apify.com/v2/acts/dataspryva~google-maps-grid-based-market-saturation-scanner/run-sync-get-dataset-items" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d @references/example-input.json > output.json
Or with Node 18+: node scripts/run.mjs [input.json].
For large runs, start an async run and read its dataset when it finishes:
RUN=$(curl -s -X POST "https://api.apify.com/v2/acts/dataspryva~google-maps-grid-based-market-saturation-scanner/runs" \
-H "Authorization: Bearer $APIFY_TOKEN" -H "Content-Type: application/json" \
-d @references/example-input.json)
RUN_ID=$(echo "$RUN" | jq -r '.data.id'); DATASET=$(echo "$RUN" | jq -r '.data.defaultDatasetId')
curl -s "https://api.apify.com/v2/actor-runs/$RUN_ID?waitForFinish=60" -H "Authorization: Bearer $APIFY_TOKEN" | jq -r '.data.status'
curl -s "https://api.apify.com/v2/datasets/$DATASET/items?format=json" -H "Authorization: Bearer $APIFY_TOKEN" > output.json
Weekly roundup of top Claude Code skills, MCP servers, and AI coding tips.