{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper Pro", "description": "Extract businesses from Google Maps by search term and location, URL or place ID: name, address, phone, website, rating, reviews count and distribution, opening hours, categories, coordinates, reviews, images and emails from websites. No API key. Pay per place.", "version": "1.0", "x-build-id": "oC4s9vrustMZhrGpC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/badr_xba~google-maps-scraper-pro/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-badr_xba-google-maps-scraper-pro", "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/badr_xba~google-maps-scraper-pro/runs": { "post": { "operationId": "runs-sync-badr_xba-google-maps-scraper-pro", "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/badr_xba~google-maps-scraper-pro/run-sync": { "post": { "operationId": "run-sync-badr_xba-google-maps-scraper-pro", "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 term(s)", "type": "array", "description": "What you would type in the Google Maps search bar, e.g. restaurant or dentist. Use distinct terms (restaurant, bar, cafe) rather than synonyms. You can also write the place in the term (dentist in Chicago), paste Google Maps links (place, search, maps.app.goo.gl short links, ?cid=) or place IDs (ChIJ…). A list pasted on one line (restaurant, bar, cafe) is split automatically and duplicates are removed.", "items": { "type": "string" } }, "locationQuery": { "title": "πŸ“ Location", "type": "string", "description": "Where to search, in plain text: New York, USA, Paris, France, 10001, USA, Casablanca, Morocco (accents optional). GPS coordinates (40.7128, -74.0060) work too. Whole cities and regions are split automatically into smaller squares to go past Google's 120-results limit." }, "maxCrawledPlacesPerSearch": { "title": "πŸ’― Number of places to extract (per search term or URL)", "minimum": 1, "type": "integer", "description": "Places you want per search term. Leave empty to get all the places found." }, "language": { "title": "🌍 Language", "enum": [ "en", "fr", "de", "es", "it", "pt-BR", "pt-PT", "nl", "pl", "tr", "ar", "ru", "ja", "ko", "zh-CN", "zh-TW", "hi", "id", "ms", "th", "vi", "sv", "no", "da", "fi", "cs", "ro", "el", "hu", "uk", "iw", "fa" ], "type": "string", "description": "Language of categories, opening hours and descriptions.", "default": "en" }, "categoryFilterWords": { "title": "🎒 Place categories ($)", "type": "array", "description": "Keep only places whose Google category contains one of these words (e.g. pizza keeps \"Pizza restaurant\"). List synonyms too (divorce lawyer, divorce attorney). Without search terms, categories are also used as search terms.", "items": { "type": "string" } }, "searchMatching": { "title": "Get exact name matches ($)", "enum": [ "all", "only_includes", "only_exact" ], "type": "string", "description": "Keep only places whose name contains, or exactly matches, the search term.", "default": "all" }, "placeMinimumStars": { "title": "Set a minimum star rating ($)", "enum": [ "", "two", "twoAndHalf", "three", "threeAndHalf", "four", "fourAndHalf" ], "type": "string", "description": "Keep only places rated at least this. Places without reviews are skipped.", "default": "" }, "website": { "title": "Places with/without a 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 temporarily or permanently closed.", "default": false }, "scrapePlaceDetailPage": { "title": "Scrape place detail page ($)", "type": "boolean", "description": "Opens each place's detail: reviews distribution, review tags, owner description, plus code, order online link, and fills fields the search list sometimes leaves empty. Turned on automatically by reviews or images.", "default": false }, "maxReviews": { "title": "Number of reviews to extract ($)", "minimum": 0, "type": "integer", "description": "Reviews per place: text, stars, date, reviewer, owner response, photos and context. Google sends the most relevant reviews with each place (usually about 5): that is the maximum per place. 0 = no reviews.", "default": 0 }, "reviewsStartDate": { "title": "Only reviews newer than", "type": "string", "description": "2024-05-03, 2024-05-03T20:00:00 or a period such as \"3 months\" (UTC)." }, "reviewsFilterString": { "title": "Filter reviews by keywords", "type": "string", "description": "Keep only reviews containing this text.", "default": "" }, "scrapeReviewsPersonalData": { "title": "πŸ§›β€β™‚οΈ Include reviewers' data", "type": "boolean", "description": "Reviewer name, ID, profile URL and photo. Personal data is protected by the GDPR: collect it only for a legitimate reason. The review ID is always included.", "default": true }, "maxImages": { "title": "Number of images to extract ($)", "minimum": 0, "type": "integer", "description": "Images per place, in full size (Google sends a few with each place). 0 = none.", "default": 0 }, "scrapeContacts": { "title": "⏩ Add-on: Company contacts enrichment ($)", "type": "boolean", "description": "Visits each place's website to add emails and social profiles (Facebook, Instagram, LinkedIn, X, YouTube, TikTok…). Billed only for websites actually read.", "default": false }, "countryCode": { "title": "πŸ—Ί Country", "enum": [ "", "us", "gb", "ca", "au", "fr", "de", "es", "it", "nl", "be", "ch", "at", "pt", "ie", "se", "no", "dk", "fi", "pl", "cz", "ro", "gr", "tr", "ma", "dz", "tn", "eg", "sa", "ae", "qa", "in", "pk", "id", "my", "sg", "ph", "th", "vn", "jp", "kr", "cn", "br", "mx", "ar", "co", "cl", "pe", "za", "ng", "ke", "nz", "il", "ua", "ru" ], "type": "string", "description": "Country, alone or with city / state / county / postal code below.", "default": "" }, "city": { "title": "πŸŒ‡ City", "type": "string", "description": "City name only, e.g. Pittsburgh. Used instead of Location when filled." }, "state": { "title": "State", "type": "string", "description": "e.g. Massachusetts." }, "county": { "title": "County", "type": "string", "description": "e.g. New York County." }, "postalCode": { "title": "Postal code", "type": "string", "description": "One postal code, combined with Country (not City)." }, "customGeolocation": { "title": "πŸ›° Custom search area (longitude first)", "type": "object", "description": "GeoJSON Point (with optional \"radiusKm\", default 5), Polygon or MultiPolygon, coordinates as [longitude, latitude]. Used when Location is empty." }, "startUrls": { "title": "Google Maps URLs", "type": "array", "description": "Place URLs (…/maps/place/…, ?cid=…, ?q=place_id:…), short links (maps.app.goo.gl/…) or search URLs (…/maps/search/pizza/@40.75,-73.98,14z β€” searched in the area shown on the map; without coordinates, the Location is used). Place URLs include the place details.", "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 (27 characters starting with ChIJ or GhIJ). Place details are included.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave off: the Actor reads Google directly and switches to Apify datacenter addresses only when needed.", "default": { "useApifyProxy": false } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 16, "type": "integer", "description": "Parallel requests to Google.", "default": 8 } } }, "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 } } } } } } } } } }