{
"openapi": "3.0.1",
"info": {
"title": "Google Maps Scraper — Google Places API & Business Leads",
"description": "Google Places API without limits: every business on Google Maps for any search and area, with phone, website, rating, reviews count, address, coordinates, hours and attributes. Optional emails and social profiles from each website. Scans whole cities. No browser.",
"version": "0.1",
"x-build-id": "jJF2EsBvdyBUEqnF7"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/prestilink~google-maps-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-prestilink-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/prestilink~google-maps-scraper/runs": {
"post": {
"operationId": "runs-sync-prestilink-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/prestilink~google-maps-scraper/run-sync": {
"post": {
"operationId": "run-sync-prestilink-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",
"properties": {
"searchTerms": {
"title": "What to search",
"type": "array",
"description": "One per line, as you would type it on Google Maps: dentist, italian restaurant, plumber. You can also write the place in it: coffee shop in Lisbon.",
"items": {
"type": "string"
}
},
"location": {
"title": "Location",
"type": "string",
"description": "City, region, postcode or address, like Austin, TX, Paris 11e or 90210. Added to every search term."
},
"maxPlacesPerSearch": {
"title": "Max places per search",
"minimum": 1,
"maximum": 20000,
"type": "integer",
"description": "Google stops a single search at about 170 places. Ask for more and the Actor scans the whole area tile by tile to find every place.",
"default": 100
},
"scrapeContacts": {
"title": "Emails and social profiles",
"type": "boolean",
"description": "Visit each place's website and collect emails and social profiles (Facebook, Instagram, LinkedIn, X, YouTube, TikTok, WhatsApp). Charged per website checked.",
"default": false
},
"website": {
"title": "Website",
"enum": [
"any",
"with",
"without"
],
"type": "string",
"description": "Places without a website are leads for web designers and agencies.",
"default": "any"
},
"phone": {
"title": "Phone",
"enum": [
"any",
"with"
],
"type": "string",
"description": "Keep only places that list a phone number.",
"default": "any"
},
"minRating": {
"title": "Minimum rating",
"enum": [
"0",
"3",
"3.5",
"4",
"4.5"
],
"type": "string",
"description": "Keep only places rated at least this high.",
"default": "0"
},
"minReviews": {
"title": "Minimum number of reviews",
"minimum": 0,
"maximum": 1000000,
"type": "integer",
"description": "Keep only places with at least this many reviews.",
"default": 0
},
"categoryFilter": {
"title": "Category must contain",
"type": "array",
"description": "Keep only places whose Google category contains one of these words, like dentist or orthodont. Removes off-topic results.",
"items": {
"type": "string"
}
},
"skipClosed": {
"title": "Skip closed places",
"type": "boolean",
"description": "Leave out places marked permanently or temporarily closed.",
"default": true
},
"language": {
"title": "Language",
"type": "string",
"description": "Language of categories, hours and descriptions: en, fr, de, es, it, pt, ar...",
"default": "en"
},
"countryCode": {
"title": "Country",
"type": "string",
"description": "Two-letter country code, like US or FR, to read Google Maps as a local user would."
},
"latitude": {
"title": "Latitude",
"type": "string",
"description": "Instead of a location: search around this point, like 30.2672. Set longitude too."
},
"longitude": {
"title": "Longitude",
"type": "string",
"description": "Like -97.7431."
},
"radiusKm": {
"title": "Radius (km)",
"minimum": 1,
"maximum": 300,
"type": "integer",
"description": "How far from the location or point to scan when you ask for more places than one search returns. Empty means the Actor sizes it from the first results."
},
"startUrls": {
"title": "Google Maps search URLs",
"type": "array",
"description": "Paste Google Maps search URLs, like https://www.google.com/maps/search/dentist+in+austin/@30.26,-97.74,13z. The search and the map area are reused.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}