{
"openapi": "3.0.1",
"info": {
"title": "Google Maps Scraper Turbo: Business Leads, Phones & Emails",
"description": "Scrape Google Maps business leads for $0.40 per 1,000 places: name, phone, website, rating, review count, opening hours and coordinates, plus emails and social links on request. No browser, so 1,000+ places in minutes, past Google's 120-result limit. CSV, Excel, JSON, API.",
"version": "1.0",
"x-build-id": "cpCQA5gpr0zWpPkqY"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/meskaoui.azeddine~google-maps-turbo-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-meskaoui.azeddine-google-maps-turbo-scraper",
"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/meskaoui.azeddine~google-maps-turbo-scraper/runs": {
"post": {
"operationId": "runs-sync-meskaoui.azeddine-google-maps-turbo-scraper",
"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/meskaoui.azeddine~google-maps-turbo-scraper/run-sync": {
"post": {
"operationId": "run-sync-meskaoui.azeddine-google-maps-turbo-scraper",
"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 term(s)",
"type": "array",
"description": "What you would type into the Google Maps search bar, e.g. dentist or coffee shop. One term per line. Distinct terms cover more ground than near-synonyms.",
"items": {
"type": "string"
}
},
"locationQuery": {
"title": "๐ Location",
"type": "string",
"description": "Free text, simplest form first: City, Country. A whole country or region works too โ the Actor splits it into tiles internally. Resolved via OpenStreetMap; check your area on Nominatim if results look off."
},
"maxCrawledPlacesPerSearch": {
"title": "๐ฏ Places per search term",
"minimum": 0,
"type": "integer",
"description": "Hard cap per search term. Leave empty or 0 to extract everything the area yields โ combine with Total places cap to protect your budget."
},
"maxTotalPlaces": {
"title": "๐งฎ Total places cap (all terms combined)",
"minimum": 0,
"type": "integer",
"description": "Absolute ceiling for the whole run. 0 means no ceiling. This is your budget guardrail.",
"default": 0
},
"language": {
"title": "๐ Language",
"enum": [
"en",
"fr",
"es",
"de",
"it",
"pt-PT",
"pt-BR",
"nl",
"pl",
"ar",
"tr",
"ru",
"ja",
"ko",
"zh-CN",
"hi",
"id",
"sv",
"da",
"no",
"fi",
"cs",
"el",
"he",
"ro",
"hu",
"uk",
"vi",
"th"
],
"type": "string",
"description": "Language of the returned place details.",
"default": "en"
},
"countryCode": {
"title": "๐บ Country",
"type": "string",
"description": "Two-letter country code used to bias Google's results and to constrain geocoding, e.g. ma, fr, us."
},
"city": {
"title": "๐ City",
"type": "string",
"description": "City name alone โ do not include state or country here."
},
"state": {
"title": "State / region",
"type": "string",
"description": "State or region, mostly useful for US and large federal countries."
},
"county": {
"title": "County / department",
"type": "string",
"description": "County, regional district or dรฉpartement depending on the country."
},
"postalCode": {
"title": "Postal code",
"type": "string",
"description": "One postal code at a time. Combine with Country, never with City."
},
"customGeolocation": {
"title": "๐ฐ Custom search area",
"type": "object",
"description": "GeoJSON-style area, coordinate order [longitude, latitude]. Supports Polygon, MultiPolygon and Circle (with radiusKm). Overrides all location fields above."
},
"startUrls": {
"title": "๐ Google Maps URLs",
"type": "array",
"description": "Google Maps search or place URLs. Place URLs (including ?cid= and place_id: forms) are scraped directly; search URLs are treated as a search term.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"placeIds": {
"title": "๐ Place IDs",
"type": "array",
"description": "Google Place IDs, e.g. ChIJreV9aqYWdkgROM_boL6YbwA. One per line.",
"items": {
"type": "string"
}
},
"categoryFilterWords": {
"title": "๐ข Category keywords",
"type": "array",
"description": "Keep only places whose Google category contains one of these words (case-insensitive substring match). Leave empty to keep everything.",
"items": {
"type": "string"
}
},
"searchMatching": {
"title": "Name matching",
"enum": [
"all",
"only_includes",
"only_exact"
],
"type": "string",
"description": "Restrict results by how the place name relates to your search term.",
"default": "all"
},
"placeMinimumStars": {
"title": "Minimum star rating",
"enum": [
"",
"two",
"twoAndHalf",
"three",
"threeAndHalf",
"four",
"fourAndHalf"
],
"type": "string",
"description": "Keep only places rated at or above this. Places with no rating are dropped.",
"default": ""
},
"website": {
"title": "Website filter",
"enum": [
"allPlaces",
"withWebsite",
"withoutWebsite"
],
"type": "string",
"description": "Keep only places that have a website, or only those that do not (useful for web-design prospecting).",
"default": "allPlaces"
},
"skipClosedPlaces": {
"title": "โฉ Skip closed places",
"type": "boolean",
"description": "Drop places marked permanently or temporarily closed.",
"default": false
},
"extractContactsFromWebsite": {
"title": "๐ง Extract emails & socials from the business website",
"type": "boolean",
"description": "Visits each business website and pulls emails, social profiles and tel: numbers. Slower and billed as a separate event, but this is what turns a place list into a lead list.",
"default": false
},
"contactPagesPerSite": {
"title": "Extra pages per website",
"minimum": 0,
"maximum": 10,
"type": "integer",
"description": "Beyond the homepage, how many contact/about/legal pages to open per site. 0 = homepage only.",
"default": 2
},
"tilingMode": {
"title": "๐งฉ Area tiling strategy",
"enum": [
"auto",
"aggressive",
"off"
],
"type": "string",
"description": "Google returns at most ~120 places per query. Auto splits a tile into four only when it saturates. Aggressive splits earlier and deeper โ best coverage, more requests. Off sends one query per term (fastest, least complete).",
"default": "auto"
},
"maxTileDepth": {
"title": "Max tiling depth",
"minimum": 0,
"maximum": 7,
"type": "integer",
"description": "How many times a tile may be quartered. Each level multiplies request count by up to 4 โ raise it only for dense city centres.",
"default": 3
},
"saturationThreshold": {
"title": "Saturation threshold",
"minimum": 10,
"maximum": 120,
"type": "integer",
"description": "A tile returning at least this many places is considered saturated and gets split.",
"default": 55
},
"minTileMeters": {
"title": "Minimum tile size (metres)",
"minimum": 100,
"maximum": 100000,
"type": "integer",
"description": "Stop splitting once a tile's longest side falls below this. Prevents pointless subdivision of a single street.",
"default": 400
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 60,
"type": "integer",
"description": "Parallel HTTP requests. 20 is a good default with Apify Proxy; lower it if you see blocks.",
"default": 20
},
"dedupeAcrossSearches": {
"title": "Deduplicate across search terms",
"type": "boolean",
"description": "A place found by two different terms is emitted once. Turn off if you need one row per (term, place).",
"default": true
},
"calibrationMode": {
"title": "๐ฌ Calibration mode",
"type": "boolean",
"description": "Saves up to 5 raw Google payloads to the key-value store as CALIBRATION_SAMPLES. Only useful for debugging with the developer.",
"default": false
},
"proxyConfiguration": {
"title": "๐ Proxy",
"type": "object",
"description": "Keep Apify Proxy on. The automatic group works: IPs that Google slows down are dropped within seconds and replaced. Residential is only worth its price on very large runs.",
"default": {
"useApifyProxy": true
}
}
}
},
"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
},
"PROXY_UNBLOCKER_UNITS": {
"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
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}