{
"openapi": "3.0.1",
"info": {
"title": "Google Maps Scraper - Emails, Phones, Reviews & Leads",
"description": "Scrape Google Maps by search phrase, URL or place ID. Get emails, phones, websites, social profiles, ratings, reviews, opening hours, photos, search rank and lead scores - in clean, export-ready columns, with a visual run report.",
"version": "1.0",
"x-build-id": "5Ks5cmi25RuFlHEfq"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/shadowextractor~google-maps-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-shadowextractor-google-maps-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/shadowextractor~google-maps-scraper/runs": {
"post": {
"operationId": "runs-sync-shadowextractor-google-maps-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/shadowextractor~google-maps-scraper/run-sync": {
"post": {
"operationId": "run-sync-shadowextractor-google-maps-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",
"required": [
"searchTerms"
],
"properties": {
"searchTerms": {
"title": "๐ What do you want to scrape?",
"minItems": 1,
"maxItems": 10000,
"type": "array",
"description": "Paste anything โ the actor detects the type for you:
โข Search phrase โ dentists in Austin, TX
โข Google Maps URL โ https://www.google.com/maps/place/...
โข Place ID โ ChIJN1t_tDeuEmsRUsoyG83frY4
โข Data / feature ID โ 0x89c25a31:0x6b1b1c1f
One item per line. Duplicate businesses are saved only once.",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 2000,
"pattern": "\\S"
}
},
"locationQuery": {
"title": "๐ Add a location to every search",
"maxLength": 200,
"type": "string",
"description": "Optional. A city, district, address, ZIP or country appended to plain search phrases (never to URLs or IDs). Leave empty when your searches already name a place."
},
"mode": {
"title": "โ๏ธ How deep should we go?",
"enum": [
"fast",
"contacts",
"full"
],
"type": "string",
"description": "Each level adds requests, data and runtime. Start with Quick to validate your query, then re-run deeper.",
"default": "fast"
},
"maxPlacesPerSearch": {
"title": "๐ข Max places per search term",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Upper limit of unique businesses collected for each search phrase. URLs and place IDs always return exactly one place.",
"default": 20
},
"maxImages": {
"title": "๐ผ Photos per place",
"minimum": 0,
"maximum": 200,
"type": "integer",
"description": "How many photo URLs to keep. Set 0 to skip photos entirely and shrink the output.",
"default": 5
},
"maxReviews": {
"title": "โญ Reviews per place",
"minimum": 0,
"maximum": 1000,
"type": "integer",
"description": "Used in ๐ Full mode. Reviews are attached to their place row, together with aggregated stats: average, star split, owner-response rate and recency.",
"default": 10
},
"reviewsSort": {
"title": "โ๏ธ Which reviews first",
"enum": [
"relevant",
"newest",
"highest",
"lowest"
],
"type": "string",
"description": "Order Google returns reviews in. Use Lowest rating to mine complaints, Newest to monitor reputation.",
"default": "relevant"
},
"categoryFilterWords": {
"title": "โ
Keep only these categories",
"maxItems": 50,
"type": "array",
"description": "A place is kept when its Google category or title contains at least one of these words. Leave empty to keep everything.",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "\\S"
},
"default": []
},
"excludeKeywords": {
"title": "๐ซ Drop places matching these words",
"maxItems": 50,
"type": "array",
"description": "A place is removed when its title, category or address contains any of these words. Great for cutting franchises, chains or irrelevant categories.",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "\\S"
},
"default": []
},
"placeMinimumStars": {
"title": "โญ Minimum Google rating",
"minimum": 0,
"maximum": 5,
"type": "number",
"description": "Keep places rated at or above this value. 0 disables the filter and keeps unrated places too.",
"default": 0
},
"minReviewsCount": {
"title": "๐ฌ Minimum number of reviews",
"minimum": 0,
"maximum": 100000,
"type": "integer",
"description": "Filter out businesses with fewer reviews than this โ a fast way to keep only established places.",
"default": 0
},
"website": {
"title": "๐ Website presence",
"enum": [
"allPlaces",
"withWebsite",
"withoutWebsite"
],
"type": "string",
"description": "Only without a website is the classic lead list for web-design and marketing agencies.",
"default": "allPlaces"
},
"requireContact": {
"title": "๐ Contact requirement",
"enum": [
"any",
"phone",
"email",
"phoneOrEmail",
"phoneAndEmail"
],
"type": "string",
"description": "Keep only rows you can actually reach out to. Email filtering needs ๐ Contacts or ๐ Full mode.",
"default": "any"
},
"skipClosedPlaces": {
"title": "โ Skip closed businesses",
"type": "boolean",
"description": "Exclude places Google marks as permanently or temporarily closed.",
"default": false
},
"openNowOnly": {
"title": "๐ข Only places open right now",
"type": "boolean",
"description": "Keep only businesses Google reports as open at the moment of the run.",
"default": false
},
"language": {
"title": "๐ฃ Result language",
"enum": [
"en",
"es",
"de",
"fr",
"it",
"pt",
"nl",
"pl",
"ru",
"uk",
"tr",
"cs",
"sv",
"da",
"no",
"fi",
"el",
"ro",
"hu",
"bg",
"he",
"ar",
"hi",
"id",
"th",
"vi",
"ja",
"ko",
"zh-CN",
"zh-TW"
],
"type": "string",
"description": "Language Google Maps answers in. Changes category names, opening-hours text and the review language mix.",
"default": "en"
},
"countryCode": {
"title": "๐ Search from this country",
"enum": [
"US",
"GB",
"CA",
"AU",
"NZ",
"IE",
"DE",
"AT",
"CH",
"FR",
"ES",
"PT",
"IT",
"NL",
"BE",
"SE",
"NO",
"DK",
"FI",
"PL",
"CZ",
"SK",
"HU",
"RO",
"BG",
"GR",
"TR",
"UA",
"AE",
"SA",
"IL",
"IN",
"SG",
"MY",
"TH",
"VN",
"ID",
"PH",
"JP",
"KR",
"CN",
"HK",
"TW",
"BR",
"MX",
"AR",
"CL",
"CO",
"ZA",
"NG",
"EG",
"KE",
"MA"
],
"type": "string",
"description": "Google localises results by country. Pick the market you are selling into.",
"default": "US"
},
"fieldPreset": {
"title": "๐ Which columns do you want?",
"enum": [
"essentials",
"leads",
"reviews",
"all"
],
"type": "string",
"description": "Shapes every dataset row so your CSV/Excel export is readable out of the box. Fields always come out in a fixed, logical order.",
"default": "essentials"
},
"deduplicateBy": {
"title": "๐งน Remove duplicates by",
"enum": [
"placeId",
"domain",
"phone",
"domainOrPhone"
],
"type": "string",
"description": "Places are always de-duplicated by Google place ID. Add a stricter rule to collapse multi-location chains or shared phone lines.",
"default": "placeId"
},
"speed": {
"title": "๐ Run speed",
"enum": [
"gentle",
"balanced",
"turbo"
],
"type": "string",
"description": "Higher speed sends more parallel requests. Turbo is best for large keyword lists on residential proxies; drop to Gentle if you see blocked requests.",
"default": "balanced"
},
"maxTotalPlaces": {
"title": "๐ Stop after this many places",
"minimum": 0,
"maximum": 1000000,
"type": "integer",
"description": "Hard budget for the whole run. 0 means no global cap. Useful to keep costs predictable on huge keyword lists.",
"default": 0
},
"proxy": {
"title": "๐ก Proxy",
"type": "object",
"description": "Residential proxies are strongly recommended โ Google Maps blocks datacenter IPs quickly.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "US"
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}