{ "openapi": "3.0.1", "info": { "title": "Google Maps · Leads by Category & City", "description": "Pick a trade and a list of cities. We collect matching Maps places and fill phone, website, published email and socials. Never invented. No login.", "version": "1.5", "x-build-id": "UpfWN1hdtVtvOf4qh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/corent1robert~google-maps-city-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-corent1robert-google-maps-city-leads", "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/corent1robert~google-maps-city-leads/runs": { "post": { "operationId": "runs-sync-corent1robert-google-maps-city-leads", "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/corent1robert~google-maps-city-leads/run-sync": { "post": { "operationId": "run-sync-corent1robert-google-maps-city-leads", "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": [ "cities" ], "properties": { "businessCategory": { "title": "Business category", "enum": [ "plumber", "electrician", "roofer", "HVAC", "locksmith", "painter", "cleaning service", "moving company", "car repair", "hair salon", "spa", "tattoo shop", "dentist", "pharmacy", "optician", "veterinarian", "restaurant", "cafe", "bakery", "hotel", "gym", "real estate agency", "lawyer", "notary", "accountant", "insurance agency", "architect", "florist", "driving school", "coworking", "custom" ], "type": "string", "description": "What you would type in Google Maps **before** the city. Presets are shortcuts. Anything else belongs in **Custom Maps query**.", "default": "plumber" }, "customCategory": { "title": "Custom Maps query (optional)", "type": "string", "description": "Overrides the category above. Example: plombier, cabinet dentaire, Italian restaurant. Leave empty to use the preset." }, "cities": { "title": "Cities", "type": "array", "description": "City or area names, one per line. **Paris, Lyon and Marseille** are split into arrondissements so Maps is not stuck on the centre. You can also paste `Lyon 3e` yourself.\n\nExamples: Lyon · Paris · Nantes", "items": { "type": "string" } }, "splitLargeCities": { "title": "Split Paris, Lyon, Marseille into arrondissements", "type": "boolean", "description": "On large French cities, Maps repeats the same downtown pins. We run one search per arrondissement instead (Paris 20, Lyon 9, Marseille 16). Duplicate pins are dropped. Turn off to search the city name only.", "default": true }, "maxPlacesPerCity": { "title": "Places per city", "minimum": 1, "maximum": 80, "type": "integer", "description": "Maps shows a sidebar list, not an infinite directory. **20** is a safe first run. **40–80** is a fuller city scrape. **80** is the practical ceiling for one search.", "default": 20 }, "enrichFromWebsite": { "title": "Find email, phone and socials on the website", "type": "boolean", "description": "When Maps publishes a website, fetch it over HTTP(S). Keep a published mailbox, fill phone only if Maps has none, and keep social URLs when they are on the page. If the pin has a Facebook page and still no email, we run Facebook Pages · Email, Phone & Website. Never invented.", "default": 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 } } } } } } } } } }