Pricing

from $1.00 / 1,000 place scrapeds

Try for free

Go to Apify Store

Google Maps Scraper

Try for free

Stop wasting your budget on slow, resource-heavy browser-based scrapers. This is the fastest, most cost-effective, and data-rich Google Maps scraper on Apify, designed for high-scale lead generation and market research.

Pricing

from $1.00 / 1,000 place scrapeds

Rating

5.0

(1)

Developer

VortexData

Actor stats

Bookmarked

Total users

Monthly active users

a day ago

Last modified

Categories

Lead generation

Automation

Developer tools

You can access the Google Maps Scraper programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "1.3",
    "x-build-id": "GAIHs0VEj05A14hyJ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/vortex_data~google-maps/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-vortex_data-google-maps",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/vortex_data~google-maps/runs": {
      "post": {
        "operationId": "runs-sync-vortex_data-google-maps",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/vortex_data~google-maps/run-sync": {
      "post": {
        "operationId": "run-sync-vortex_data-google-maps",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "searchStringsArray": {
            "title": "🔍 Search terms",
            "uniqueItems": true,
            "type": "array",
            "description": "Search queries to scrape, e.g. ['restaurant', 'cafe', 'pub']. Each term searches independently across all seed viewports and languages. You can also use direct place IDs in the format `place_id:ChIJ…`.",
            "items": {
              "type": "string"
            }
          },
          "locationQuery": {
            "title": "📍 Location",
            "type": "string",
            "description": "Free-text location, e.g. 'New York, USA' or 'Manhattan'. Resolved via OpenStreetMap Nominatim. Ignored if customGeolocation is set. If empty, falls back to the discrete geo fields below (countryCode/state/city/postalCode)."
          },
          "startUrls": {
            "title": "🔗 Direct Google Maps URLs",
            "type": "array",
            "description": "Direct google.com/maps/place/... URLs. Scraped without going through search.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "placeIds": {
            "title": "🗃 Place IDs",
            "uniqueItems": true,
            "type": "array",
            "description": "List of Google Place IDs (format `ChIJ…`). Each one is fetched directly without going through search.",
            "items": {
              "type": "string"
            }
          },
          "maxCrawledPlacesPerSearch": {
            "title": "💯 Max places per search term",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Hard cap per search term across all viewports & languages. Quad-tree subdivision stops when this is hit. Default 500 — increase for dense city-scale scraping.",
            "default": 500
          },
          "maxPlacesPerViewport": {
            "title": "Max places per viewport",
            "minimum": 1,
            "maximum": 120,
            "type": "integer",
            "description": "Per-viewport cap. Google itself returns ≤120 per viewport scroll; values above 120 have no effect for one viewport.",
            "default": 80
          },
          "enableSubdivision": {
            "title": "Quad-tree subdivision",
            "type": "boolean",
            "description": "When a viewport saturates (≥18 new of 20 first-page results), split into 4 quadrants and recurse. This is what unlocks scraping >120 results per area. Leave on.",
            "default": true
          },
          "maxSubdivisionDepth": {
            "title": "Max subdivision depth",
            "minimum": 0,
            "maximum": 7,
            "type": "integer",
            "description": "Max recursive splits. Each level multiplies viewports by 4 (depth=4 → up to 256 viewports per seed).",
            "default": 4
          },
          "language": {
            "title": "🌍 Primary language",
            "type": "string",
            "description": "Google UI language (hl=). Affects place names, opening-hours strings, tag labels, etc.",
            "default": "en"
          },
          "additionalLanguages": {
            "title": "Additional languages",
            "uniqueItems": true,
            "type": "array",
            "description": "Extra language codes to re-search the same areas. Useful for non-English regions where Google returns different translations & categories per language. Each language adds ~Nx searches.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "zoom": {
            "title": "Initial zoom",
            "minimum": 1,
            "maximum": 21,
            "type": "integer",
            "description": "Override auto-derived zoom of the seed viewport. Higher zoom = denser results before subdivision."
          },
          "multiZoomDelta": {
            "title": "Multi-zoom expansion (±N)",
            "minimum": 0,
            "maximum": 3,
            "type": "integer",
            "description": "Search each seed at zoom-N..zoom+N to maximize coverage. delta=1 → 3 zoom levels per seed (3x cost, +30-70% unique places). delta=0 disables.",
            "default": 0
          },
          "categoryFilterWords": {
            "title": "🎢 Category filter words",
            "uniqueItems": true,
            "type": "array",
            "description": "Keep only places whose categories contain ANY of these words (case-insensitive substring). Example: ['pizza', 'italian']. ⚠️ Categories can lead to false negatives — many places aren't tagged with the synonym you'd expect. Prefer multiple search terms when possible.",
            "items": {
              "type": "string"
            }
          },
          "searchMatching": {
            "title": "Match search term against title",
            "enum": [
              "all",
              "only_includes",
              "only_exact"
            ],
            "type": "string",
            "description": "Restrict places by how their title matches the search term. 'all' keeps everything. 'only_includes' requires every word of the term in the title. 'only_exact' requires the title to equal the term.",
            "default": "all"
          },
          "placeMinimumStars": {
            "title": "⭐ Minimum star rating",
            "enum": [
              "",
              "two",
              "twoAndHalf",
              "three",
              "threeAndHalf",
              "four",
              "fourAndHalf"
            ],
            "type": "string",
            "description": "Drop places with rating below this threshold. Places with no reviews are also dropped.",
            "default": ""
          },
          "websiteFilter": {
            "title": "🌐 Website filter",
            "enum": [
              "allPlaces",
              "withWebsite",
              "withoutWebsite"
            ],
            "type": "string",
            "description": "Keep only places that have / don't have a website. Useful for lead generation (target unclaimed/no-website businesses).",
            "default": "allPlaces"
          },
          "skipClosedPlaces": {
            "title": "⏩ Skip permanently / temporarily closed",
            "type": "boolean",
            "description": "Drop places that Google has marked as permanently or temporarily closed.",
            "default": false
          },
          "geoStrictMatch": {
            "title": "🌍 Strict geographic match",
            "type": "boolean",
            "description": "When ON (default), drops places whose coordinates fall outside the queried region's bounding box. Critical for state/country-level queries: without this, Google's residential-IP fallback can return places from completely different countries (e.g. searching 'Karnataka, India' returning Texas schools). Turn OFF only if you intentionally want to scrape a wider area than the queried location's polygon.",
            "default": true
          },
          "extractContactsFromWebsite": {
            "title": "📧 Extract emails & socials from each business website",
            "type": "boolean",
            "description": "When enabled, the actor visits each place's website and scrapes its homepage (and optionally a /contact page) for: email addresses, additional phone numbers, and social-media URLs (Facebook, Instagram, LinkedIn, Twitter/X, YouTube, TikTok, Pinterest, WhatsApp). Adds 1–2 HTTP requests per place that has a website (~84% of places). Domain-level cache means chain stores share one fetch.",
            "default": false
          },
          "contactsFetchContactPage": {
            "title": "Fall back to /contact page if homepage has no email",
            "type": "boolean",
            "description": "When the homepage doesn't yield any email address, fetch one common contact-style page (/contact, /contact-us, /impressum, etc.). Doubles HTTP cost in the worst case.",
            "default": true
          },
          "contactsTimeoutSecs": {
            "title": "Per-website timeout (s)",
            "minimum": 3,
            "maximum": 60,
            "type": "integer",
            "description": "Hard timeout per website fetch. Kept short to avoid stalling on slow sites.",
            "default": 10
          },
          "contactsSkipChains": {
            "title": "Skip global chains for contacts enrichment",
            "type": "boolean",
            "description": "Skip enrichment for big chains (McDonald's, Starbucks, Hilton, etc.) — their corporate websites don't represent the local franchise and flood your dataset with the same generic info.",
            "default": true
          },
          "countryCode": {
            "title": "🗺 Country",
            "type": "string",
            "description": "Discrete location field — used only when 📍 Location is empty. Combine with state/county/city/postalCode for precise geocoding."
          },
          "state": {
            "title": "State / region",
            "type": "string",
            "description": "Discrete location field. Used only when 📍 Location is empty."
          },
          "county": {
            "title": "County",
            "type": "string",
            "description": "Discrete location field (US county / Canadian regional district / French département). Used only when 📍 Location is empty."
          },
          "city": {
            "title": "🌇 City",
            "type": "string",
            "description": "Discrete location field. ⚠️ Do not include state/country here. Used only when 📍 Location is empty."
          },
          "postalCode": {
            "title": "Postal code",
            "type": "string",
            "description": "Discrete location field. Combine with countryCode (never with city). Used only when 📍 Location is empty."
          },
          "customGeolocation": {
            "title": "🛰 Custom search area (GeoJSON)",
            "type": "object",
            "description": "GeoJSON Polygon, MultiPolygon, or Point. Overrides locationQuery and discrete geo fields. Point requires 'radiusKm'. MultiPolygon yields one seed per polygon."
          },
          "concurrency": {
            "title": "Concurrent tasks",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "How many viewports run in parallel. Each on its own sticky proxy session. Tune up for speed, down if rate-limited.",
            "default": 8
          },
          "requestTimeoutSecs": {
            "title": "Per-request HTTP timeout (s)",
            "minimum": 5,
            "maximum": 60,
            "type": "integer",
            "description": "Per-HTTP-request timeout in seconds. Increase if your residential proxies are slow.",
            "default": 15
          },
          "minRequestIntervalMs": {
            "title": "Min interval between requests (ms)",
            "minimum": 0,
            "maximum": 5000,
            "type": "integer",
            "description": "Global throttle: minimum gap between any two outbound requests. 0 = disabled.",
            "default": 0
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Apify proxy settings. Residential proxies are strongly recommended.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ]
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Google Maps Scraper OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Google Maps Scraper from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Google Maps Scraper API in Python

Google Maps Scraper API in JavaScript

Google Maps Scraper API through CLI

Google Maps Scraper API

Google Maps Scraper

theguide/google-maps-scraper

The most complete and cost-effective Google Maps Scraper on the market. Extract businesses, emails, social media profiles, and reviews with zero external API costs.

TheGuide

Google Maps Lead Scraper

brennanthethird/google-maps-lead-scraper

Brennan Jones

Google Maps Scraper

mohamedgb00714/Google-Maps-Scraper

mohamed el hadi msaid

Google Maps Scraper

johnadeolu401/google-maps-scraper

John Adeolu

Google Maps Scraper

oneary/google-maps-scraper

Luan

Google Maps Scraper

creactivostudios/google-maps-scraper

Creactivo Studios

3.0

Google Maps Scraper

surigami/google-maps-scraper

📍 Google Maps Scraper Google Maps Scraper lets you extract business data from Google Maps.

surigami

Google Maps Scraper

betterdevsscrape/google-maps-scraper

Scrape Google Maps in seconds. Extract businesses, reviews, images, contacts, emails, social media, opening hours, and more. The fastest Google Maps scraper on Apify with pay-per-event pricing.

Better Devs Scrape

Google Maps Scraper

paulwrsc/google-maps-scraper

Scrapes business data from Google Maps

Paul Würschinger

Google Maps Scraper Basic By WebUnlocker

webunlocker/google-maps-scraper-basic-by-webunlocker

The fastest, most cost-effective Google Maps scraper on Apify. Extract 20-50 businesses per request at 50-70% lower cost than competitors. Get names, ratings, reviews, phone numbers, websites, addresses, and coordinates instantly. Perfect for quick lead generation and basic market research.