{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper: Businesses, Phones, Websites & Ratings", "description": "Scrape Google Maps business listings for any search and location: name, category, address, phone, website, rating, review count, opening hours, coordinates and place ID. Up to 140 places per search. No login, no browser, fast and cheap.", "version": "0.1", "x-build-id": "FGRpwbxSjrH829TxF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/redfoxscout~google-maps-business-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-redfoxscout-google-maps-business-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/redfoxscout~google-maps-business-scraper/runs": { "post": { "operationId": "runs-sync-redfoxscout-google-maps-business-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/redfoxscout~google-maps-business-scraper/run-sync": { "post": { "operationId": "run-sync-redfoxscout-google-maps-business-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": { "searchQueries": { "title": "What to search", "type": "array", "description": "Searches as you would type them in Google Maps, one per line, e.g. dentists in Dubai, or just dentists with a location below. Optional when you give Google Maps URLs or place IDs.", "items": { "type": "string" } }, "locations": { "title": "Locations (optional)", "type": "array", "description": "Cities or areas. Every search is run in every location ( in ).", "items": { "type": "string" } }, "searchWholeArea": { "title": "Cover the whole area (every place, not one search)", "type": "boolean", "description": "A normal Google Maps search ends after ~120-250 places. On: the area (location, \"in \" or your map point) is split into map tiles, busy tiles are split again, and every matching place is returned once. Duplicates are free. Use with a higher max results.", "default": false }, "startUrls": { "title": "Google Maps URLs (optional)", "type": "array", "description": "Google Maps search URLs (maps/search/...@lat,lng,zoom), place URLs, ?cid= links or maps.app.goo.gl short links.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "placeIds": { "title": "Place IDs (optional)", "type": "array", "description": "Google place IDs such as ChIJ1S_Bov20RIYRe7MiR8tYawY. One row per place.", "items": { "type": "string" } }, "language": { "title": "Language", "type": "string", "description": "Language of names and categories, e.g. en, de, ar, fr.", "default": "en" }, "countryCode": { "title": "Country code", "type": "string", "description": "Two-letter country code Google uses for regional results, e.g. us, gb, ae.", "default": "us" }, "latitude": { "title": "Map point latitude (optional)", "type": "number", "description": "Search around a point instead of a named place, e.g. 25.2048. Use with longitude and radius." }, "longitude": { "title": "Map point longitude (optional)", "type": "number", "description": "e.g. 55.2708." }, "radiusKm": { "title": "Radius around the point (km)", "minimum": 0.2, "maximum": 200, "type": "number", "description": "Size of the circle around the map point. Places outside it are left out. With Cover the whole area every place inside it is returned.", "default": 5 }, "skipClosedPlaces": { "title": "Skip closed places", "type": "boolean", "description": "Leave out places Google marks as permanently or temporarily closed.", "default": false }, "categoryFilterWords": { "title": "Only these categories (optional)", "type": "array", "description": "Keep a place only if one of its Google categories contains one of these words, e.g. dentist, orthodontist.", "items": { "type": "string" } }, "searchMatching": { "title": "Name must match the search", "enum": [ "all", "only_includes", "only_exact" ], "type": "string", "description": "Useful for brand searches (e.g. Starbucks): drop places Google adds that are not that business.", "default": "all" }, "minRating": { "title": "Minimum rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Skip places rated below this. Places without a rating are skipped when this is set." }, "minReviews": { "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": "Places without a website are prospects for web design and marketing agencies.", "default": "allPlaces" }, "skipWithoutWebsite": { "title": "Only places with a website", "type": "boolean", "description": "Older switch, same as Website = Only places with a website.", "default": false }, "skipWithoutPhone": { "title": "Only places with a phone number", "type": "boolean", "description": "Skip places that list no phone.", "default": false }, "maxItems": { "title": "Max results per search", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop each search after this many places. A normal search ends after ~120-250; with Cover the whole area use hundreds or thousands.", "default": 60 }, "maxConcurrency": { "title": "Searches in parallel", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many searches run at once.", "default": 3 }, "proxyConfiguration": { "title": "Proxy (optional)", "type": "object", "description": "Off by default and usually not needed. Turn on for very large sweeps if Google starts rate-limiting.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }