{
"openapi": "3.0.1",
"info": {
"title": "Google Maps Business Leads: Emails & Phones",
"description": "Google Maps business leads: enter business types and a city, get one lead per business with name, category, address, phone, website, rating and reviews, plus the emails and Facebook, Instagram, LinkedIn and X profiles on its website. Only leads with an email, website or phone. No login.",
"version": "0.1",
"x-build-id": "uHiejNQ9eq7YcDGPM"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/deepmine~google-maps-business-leads/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-deepmine-google-maps-business-leads",
"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-business-leads/runs": {
"post": {
"operationId": "runs-sync-deepmine-google-maps-business-leads",
"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-business-leads/run-sync": {
"post": {
"operationId": "run-sync-deepmine-google-maps-business-leads",
"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": "π·οΈ Business types or keywords",
"type": "array",
"description": "The kind of business you want leads for, as you would type it in Google Maps, e.g. plumber, roofing contractor or dentist. Each one is searched in the city or area below. One may name its own place (pizza in Austin, TX).",
"items": {
"type": "string"
}
},
"locationQuery": {
"title": "π City or area",
"type": "string",
"description": "City, neighborhood, ZIP code, state or country, e.g. Denver, CO, Texas or Germany. Leads stay inside its 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."
},
"maxCrawledPlacesPerSearch": {
"title": "π― Number of leads per business type",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Leads each business type returns at most, e.g. 500. Empty = every business Google Maps has for it in the area."
},
"scrapeContacts": {
"title": "π§ Emails and social profiles from websites",
"type": "boolean",
"description": "On (included in the lead price): reads each business's website (home page plus up to 2 contact pages) for emails, phones and Facebook, Instagram, LinkedIn, X, YouTube, TikTok and other profiles. Off: Google Maps fields only, a little faster.",
"default": true
},
"onlyWithEmail": {
"title": "π§ Only leads with an email",
"type": "boolean",
"description": "Keep only businesses whose website gave at least one email. Leads without one are left out and not charged; the search reads further until it has your number of leads (or runs out).",
"default": false
},
"onlyWithWebsite": {
"title": "π Only leads with a website",
"type": "boolean",
"description": "Keep only businesses that list a website on Google Maps. Leads left out are not charged.",
"default": false
},
"onlyWithPhone": {
"title": "π Only leads with a phone",
"type": "boolean",
"description": "Keep only businesses that list a phone number on Google Maps. Leads left out are not charged.",
"default": false
},
"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"
}
},
"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": ""
},
"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"
},
"skipClosedPlaces": {
"title": "β© Skip closed places",
"type": "boolean",
"description": "Leave out places marked temporarily or permanently closed.",
"default": false
},
"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"
},
"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."
},
"startUrls": {
"title": "π Google Maps search links",
"type": "array",
"description": "Search links (https://www.google.com/maps/search/plumber/@39.74,-104.99,12z) run as one more business type. Place links (https://www.google.com/maps/place/..., maps.app.goo.gl/...) work too.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}