{
"openapi": "3.0.1",
"info": {
"title": "Google Maps Scraper — Leads, Emails & Reviews",
"description": "Extract every Google Maps place in any city, polygon or radius: phones, websites, emails & socials, hours, ratings and reviews. Fast HTTP engine, no browser, no login. Filters are free, out-of-area places are never charged, and your spending cap is never exceeded.",
"version": "0.1",
"x-build-id": "TUHhsbjAb02Hks8oJ"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/amrhassan25~google-maps-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-amrhassan25-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/amrhassan25~google-maps-scraper/runs": {
"post": {
"operationId": "runs-sync-amrhassan25-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/amrhassan25~google-maps-scraper/run-sync": {
"post": {
"operationId": "run-sync-amrhassan25-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": {
"searchStringsArray": {
"title": "🔍 Search terms",
"type": "array",
"description": "What you would type into Google Maps, e.g. restaurant, dentist, coffee shop. Each term is searched separately across the whole location; a place found by two terms is delivered and charged once. Put the place name in Location, not here, to get full-area coverage.",
"items": {
"type": "string"
}
},
"locationQuery": {
"title": "📍 Location",
"type": "string",
"description": "City, district, county, state or country, e.g. Austin, Texas, USA or Paris, France. Its real boundary is looked up on OpenStreetMap, the area is covered with a map grid, and places outside the boundary are skipped and never charged. Leave empty to get what Google shows for the search term alone (up to ~150 places)."
},
"maxCrawledPlacesPerSearch": {
"title": "Maximum places per search term",
"minimum": 1,
"type": "integer",
"description": "Stops each search term after this many places. Leave empty to get every place in the area. Filtered-out places do not count."
},
"language": {
"title": "🌍 Language",
"enum": [
"en",
"af",
"ar",
"bg",
"ca",
"cs",
"da",
"de",
"el",
"es",
"es-419",
"et",
"fa",
"fi",
"fil",
"fr",
"he",
"hi",
"hr",
"hu",
"id",
"it",
"ja",
"ko",
"lt",
"lv",
"ms",
"nl",
"no",
"pl",
"pt-BR",
"pt-PT",
"ro",
"ru",
"sk",
"sl",
"sr",
"sv",
"th",
"tr",
"uk",
"ur",
"vi",
"zh-CN",
"zh-TW"
],
"type": "string",
"description": "Language of place names, categories, opening hours and review translations.",
"default": "en"
},
"startUrls": {
"title": "Google Maps URLs",
"type": "array",
"description": "Place URLs (/maps/place/…), search URLs (/maps/search/…, searched in the map view of the link), share links (maps.app.goo.gl/…) and ?cid= links.",
"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 (ChIJ…), CIDs (a long number), or feature IDs (0x…:0x…).",
"items": {
"type": "string"
}
},
"countryCode": {
"title": "Country",
"type": "string",
"description": "Two-letter country code, e.g. us, de, eg. Also sets the Google region for results."
},
"state": {
"title": "State / region",
"type": "string",
"description": "E.g. Texas."
},
"county": {
"title": "County",
"type": "string",
"description": "E.g. Travis County."
},
"city": {
"title": "City",
"type": "string",
"description": "E.g. Austin."
},
"postalCode": {
"title": "Postal code",
"type": "string",
"description": "Searches about 2 km around the postal code's centre. Combine with Country for reliable results."
},
"customGeolocation": {
"title": "Custom area (GeoJSON)",
"type": "object",
"description": "A GeoJSON Polygon, MultiPolygon, or a Point with radiusKm. Coordinates are [longitude, latitude]. A 3 km circle: {\"type\": \"Point\", \"coordinates\": [-97.7431, 30.2672], \"radiusKm\": 3}. You can draw polygons at geojson.io."
},
"categoryFilterWords": {
"title": "Only these categories",
"type": "array",
"description": "Keep only places whose Google category contains one of these words, e.g. restaurant keeps “Italian restaurant” and drops “Bar”.",
"items": {
"type": "string"
}
},
"searchMatching": {
"title": "Place name must match the search term",
"enum": [
"all",
"only_includes",
"only_exact"
],
"type": "string",
"description": "Useful for brand searches like Starbucks, where Google also shows other coffee shops.",
"default": "all"
},
"placeMinimumStars": {
"title": "Minimum rating",
"enum": [
"",
"two",
"twoAndHalf",
"three",
"threeAndHalf",
"four",
"fourAndHalf"
],
"type": "string",
"description": "Skip places rated below this.",
"default": ""
},
"minimumReviews": {
"title": "Minimum number of reviews",
"minimum": 0,
"type": "integer",
"description": "Skip places with fewer reviews."
},
"website": {
"title": "Website",
"enum": [
"allPlaces",
"withWebsite",
"withoutWebsite"
],
"type": "string",
"description": "“Only places without a website” is a classic lead list for web agencies.",
"default": "allPlaces"
},
"skipClosedPlaces": {
"title": "Skip closed places",
"type": "boolean",
"description": "Skip places marked permanently or temporarily closed.",
"default": false
},
"scrapeContacts": {
"title": "📧 Emails & social profiles from websites",
"type": "boolean",
"description": "Visits each place's own website (and its contact page when needed) to find emails, phones, and Facebook, Instagram, LinkedIn, X, YouTube, TikTok and Pinterest profiles. Charged only when something is found.",
"default": false
},
"scrapePlaceDetailPage": {
"title": "Place details",
"type": "boolean",
"description": "Adds the review star histogram, review keywords (“people often mention”), plus code, the building the place is located in, and more photos. One extra request per place.",
"default": false
},
"maxReviews": {
"title": "Reviews per place",
"minimum": 0,
"type": "integer",
"description": "0 = no reviews. Reviews come with text, stars, exact date, owner reply, photos, detailed ratings (food / service / atmosphere) and the reviewer. Set a large number to get all reviews of a place.",
"default": 0
},
"reviewsSort": {
"title": "Reviews order",
"enum": [
"newest",
"mostRelevant",
"highestRanking",
"lowestRanking"
],
"type": "string",
"description": "Order in which reviews are collected.",
"default": "newest"
},
"reviewsStartDate": {
"title": "Only reviews since",
"type": "string",
"description": "A date (2025-01-31) or a period (3 months, 1 year, 10 days). With “Newest first”, collection stops at the first older review, so you only pay for what you need."
},
"scrapeReviewsPersonalData": {
"title": "Include reviewer names and profiles",
"type": "boolean",
"description": "Reviewer name, ID, profile URL and photo. Turn off to receive anonymous reviews.",
"default": true
},
"maxImages": {
"title": "Photo URLs per place",
"minimum": 0,
"type": "integer",
"description": "0 = only the main photo. Photo URLs are free.",
"default": 0
},
"onlyNewPlaces": {
"title": "Only new places",
"type": "boolean",
"description": "Remembers the places delivered by earlier runs of the same search and delivers (and charges) only new ones. The first run delivers everything.",
"default": false
},
"monitoringId": {
"title": "Monitoring name",
"type": "string",
"description": "Optional. Runs with the same name share their memory. By default the memory is tied to the exact search terms and location."
},
"maxCrawledPlaces": {
"title": "Maximum places in total",
"minimum": 1,
"type": "integer",
"description": "Hard cap across all search terms, URLs and place IDs."
},
"maxConcurrency": {
"title": "Places processed in parallel",
"minimum": 1,
"maximum": 50,
"type": "integer",
"description": "How many places are enriched (details, reviews, website) at once.",
"default": 20
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Proxy traffic is included in the price. The default Apify datacenter proxy works well for Google Maps; if Google starts refusing it, the run switches itself to residential proxies.",
"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
}
}
}
}
}
}
}
}
}
}