{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper with Emails", "description": "Extract Google Maps business listings with website, phone, email and social profiles - and a coverage report that says when an area could not be read exhaustively.", "version": "0.1", "x-build-id": "yZi9jGKzESkgZNo1V" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/al_mansouri~verified-maps-harvester/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-al_mansouri-verified-maps-harvester", "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/al_mansouri~verified-maps-harvester/runs": { "post": { "operationId": "runs-sync-al_mansouri-verified-maps-harvester", "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/al_mansouri~verified-maps-harvester/run-sync": { "post": { "operationId": "run-sync-al_mansouri-verified-maps-harvester", "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", "required": [ "searchStringsArray" ], "properties": { "searchStringsArray": { "title": "Search terms", "type": "array", "description": "What to look for, for example \"coffee shop\" or \"dentist\". Use terms that overlap as little as possible: \"restaurant, bar, cafe\" finds far more than \"restaurant, restaurants, chinese restaurant\".", "items": { "type": "string" } }, "locationQuery": { "title": "Location", "type": "string", "description": "The city, region, or country to search, for example \"Jersey City, New Jersey\". The outline is looked up on OpenStreetMap, so results follow the real administrative boundary rather than a square around a point." }, "customGeolocation": { "title": "Custom search area", "type": "object", "description": "A GeoJSON Polygon, MultiPolygon, or Point to search instead of a named location. A Point accepts an extra \"radiusKm\" value. Note GeoJSON lists longitude before latitude. Use this when the area you want is not a place with a name." }, "maxPlacesPerSearch": { "title": "Maximum places per search term", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many places for each search term. Dense areas are subdivided automatically to get past Google's limit of about 120 results per map view.", "default": 100 }, "language": { "title": "Language", "type": "string", "description": "The language Google should answer in, as a two-letter code. Affects category names and opening hours.", "default": "en" }, "restrictToArea": { "title": "Only return places inside the area", "type": "boolean", "description": "Google returns nearby places from outside the area you asked for. Leave this on to discard them. Turning it off returns more rows, but some will be outside your area.", "default": true }, "scrapePlaceDetails": { "title": "Also open each place for website and phone", "type": "boolean", "description": "Opens every place's own page to collect its website, phone number, full address, opening hours and categories. These are not shown in Google's results list, so they cannot be collected without it. Roughly triples the time a run takes and is charged at a higher rate per place.", "default": false }, "enrichContacts": { "title": "Also read each website for email addresses", "type": "boolean", "description": "Visits the website of every place that has one and collects email addresses and social profiles from it. Google never publishes a business email, so this is the only way to get one. Turns on the previous option automatically, since the website address comes from it. Adds roughly a second per place and is charged at the highest rate.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Google blocks datacenter addresses far sooner than residential ones. Residential proxies cost more per run but reach more results before being throttled.", "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 } } }, "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 } } } } } } } } } }