{
"openapi": "3.0.1",
"info": {
"title": "Google Maps Email Extractor: Contacts & Socials",
"description": "Google Maps email extractor and scraper: search businesses by keyword and location, get each place's emails, phones and Facebook, Instagram, LinkedIn, X, YouTube and TikTok profiles from its website, plus address, phone, rating, hours and categories. For lead lists. No login.",
"version": "0.1",
"x-build-id": "kyIoubkaQ9iEczfIT"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/deepmine~google-maps-email-extractor/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-deepmine-google-maps-email-extractor",
"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/deepmine~google-maps-email-extractor/runs": {
"post": {
"operationId": "runs-sync-deepmine-google-maps-email-extractor",
"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/deepmine~google-maps-email-extractor/run-sync": {
"post": {
"operationId": "run-sync-deepmine-google-maps-email-extractor",
"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",
"type": "array",
"description": "What you would type in Google Maps, e.g. dentist or coffee shop. Each term is searched in the location below. A term may name its own place (pizza in Austin, TX).",
"items": {
"type": "string"
}
},
"locationQuery": {
"title": "π Location",
"type": "string",
"description": "City, neighborhood, ZIP code, state or country, e.g. Boise, ID or Berlin, Germany. Results stay inside the location's own boundary (a city search doesn't spill into its suburbs). Large areas are searched ZIP code by ZIP code and tile by tile automatically. Empty = Google picks the area your term names."
},
"maxCrawledPlacesPerSearch": {
"title": "π― Number of places per search term",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Places each search term returns at most, e.g. 500. Empty = every place Google Maps has for it in the location."
},
"scrapeContacts": {
"title": "π§ Emails and social profiles from websites ($)",
"type": "boolean",
"description": "On: reads each place's website (home page plus up to 2 contact pages) for emails, phones and Facebook, Instagram, LinkedIn, X, YouTube, TikTok and other profiles. Charged only for places whose website gave a contact. Off: place rows only.",
"default": true
},
"language": {
"title": "π Language",
"enum": [
"en",
"es",
"fr",
"de",
"it",
"pt-BR",
"pt-PT",
"nl",
"pl",
"cs",
"sk",
"hu",
"ro",
"bg",
"el",
"tr",
"ru",
"uk",
"sv",
"da",
"no",
"fi",
"et",
"lv",
"lt",
"hr",
"sl",
"sr",
"ja",
"ko",
"zh-CN",
"zh-TW",
"th",
"vi",
"id",
"ms",
"fil",
"hi",
"ar",
"he",
"fa"
],
"type": "string",
"description": "Language of names, categories, hours and reviews, as Google Maps shows them.",
"default": "en"
},
"categoryFilterWords": {
"title": "π’ Place categories",
"type": "array",
"description": "Keep only places with a category containing one of these words, e.g. dentist, orthodontist. Empty = every category. Places left out are not charged.",
"items": {
"type": "string"
}
},
"searchMatching": {
"title": "Name match",
"enum": [
"all",
"only_includes",
"only_exact"
],
"type": "string",
"description": "Keep only places whose name contains the search term, or is exactly the search term.",
"default": "all"
},
"placeMinimumStars": {
"title": "β Minimum rating",
"enum": [
"",
"two",
"twoAndHalf",
"three",
"threeAndHalf",
"four",
"fourAndHalf"
],
"type": "string",
"description": "Keep only places rated at least this. Places without a rating are left out when this is set.",
"default": ""
},
"website": {
"title": "π Website",
"enum": [
"allPlaces",
"withWebsite",
"withoutWebsite"
],
"type": "string",
"description": "Keep only places with a website (for lead lists), or only places without one.",
"default": "allPlaces"
},
"skipClosedPlaces": {
"title": "β© Skip closed places",
"type": "boolean",
"description": "Leave out places marked temporarily or permanently closed.",
"default": false
},
"startUrls": {
"title": "π Google Maps URLs",
"type": "array",
"description": "Place links (https://www.google.com/maps/place/..., maps.app.goo.gl/..., ?cid= links) and search links (https://www.google.com/maps/search/dentist/@43.61,-116.2,13z). A search link runs as one more 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 (ChIJdzf8kEZZwokRXtSOY0-Kwaw), CIDs (12448382918606115934) or FIDs (0x89c2594690fc3777:0xacc18a4f638ed45e).",
"items": {
"type": "string"
}
},
"countryCode": {
"title": "πΊοΈ Country",
"type": "string",
"description": "Used with the fields below when π Location is empty; also sets the Google country, e.g. de. Two letters."
},
"city": {
"title": "π City",
"type": "string",
"description": "e.g. Pittsburgh."
},
"state": {
"title": "State",
"type": "string",
"description": "e.g. Massachusetts."
},
"county": {
"title": "County",
"type": "string",
"description": "e.g. King County."
},
"postalCode": {
"title": "Postal code",
"type": "string",
"description": "e.g. 10001. Combine with πΊοΈ Country."
},
"customGeolocation": {
"title": "π°οΈ Custom search area (GeoJSON)",
"type": "object",
"description": "A GeoJSON Polygon or MultiPolygon ([longitude, latitude] order), or a Point with radiusKm. Overrides the location. Only places inside are kept."
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Leave as is: Apify datacenter proxy works for Google Maps. A call every datacenter IP refused is retried once on a residential IP.",
"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
}
}
}
}
}
}
}
}
}
}