{ "openapi": "3.0.1", "info": { "title": "Google Maps Place Details & Identity Resolver", "description": "A high-precision data engine to resolve, normalize, and extract complete Google Maps place profiles. Match and enrich business data using URLs, Place IDs, CIDs, or search queries with absolute accuracy.", "version": "0.0", "x-build-id": "rkKHfDdyNdewCDduw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapecraft~google-maps-place-details-identity-resolver/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapecraft-google-maps-place-details-identity-resolver", "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/scrapecraft~google-maps-place-details-identity-resolver/runs": { "post": { "operationId": "runs-sync-scrapecraft-google-maps-place-details-identity-resolver", "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/scrapecraft~google-maps-place-details-identity-resolver/run-sync": { "post": { "operationId": "run-sync-scrapecraft-google-maps-place-details-identity-resolver", "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": { "strategy": { "title": "Resolution Strategy", "enum": [ "auto", "url", "cid", "placeId", "search" ], "type": "string", "description": "Controls how the actor resolves the target company. Auto uses this priority: URL, CID, Place ID, then search query.", "default": "auto" }, "url": { "title": "Google Maps Place URL", "pattern": "https?://.*google\\.com/maps/.*", "type": "string", "description": "Full URL of the Google Maps place. Optional if searchQuery, placeId, or cid is provided." }, "placeId": { "title": "Google Place ID (Optional)", "type": "string", "description": "Unique Google Place ID of the establishment. Navigates directly and avoids any text-search ambiguity." }, "cid": { "title": "Google Maps CID (Optional)", "type": "string", "description": "Google Maps Customer ID (CID). Navigates directly to the place without search. Accepts a decimal CID string, a maps URL with ?cid= or ludocid=, cid:12345 / ludocid=12345 text, or a place URL containing a hex CID pair (0x...:0x...). Keep large CIDs as strings — do not convert to JSON numbers." }, "searchQuery": { "title": "Search Query (Company Name)", "type": "string", "description": "Company name to search for on Google Maps. Used if URL is not provided." }, "website": { "title": "Company Website (Optional)", "type": "string", "description": "The company's website to match against the search results to guarantee accuracy." }, "proxyConfig": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies are strongly recommended for cloud runs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "blockAssets": { "title": "Block Images / Fonts", "type": "boolean", "description": "Block image/font/media requests to speed up scraping and reduce bandwidth.", "default": true }, "includeImages": { "title": "Include place photos", "type": "boolean", "description": "When enabled, collects photo URLs plus web results and About from the Maps UI (slower). When disabled, those fields come from the preview API only and image fields are empty.", "default": false }, "maxImages": { "title": "Max photos (optional)", "minimum": 1, "type": "integer", "description": "When includeImages is true: leave empty to collect all photos found in the gallery; set a positive number to keep only that many URLs." }, "language": { "title": "Language (Optional)", "type": "string", "description": "Language code for the Google Maps interface (e.g. 'en', 'es', 'fr', 'de'). Defaults to English ('en').", "default": "en" } } }, "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 } } } } } } } } } }