{ "openapi": "3.0.1", "info": { "title": "Google Maps Reviewer Geo Profile API", "description": "Infer a Google Maps reviewer's home region from their review history. Clusters review coordinates into a standardized home-region guess (city/state/country + ISO codes), a confidence score, and a local-vs-travel footprint. One row per reviewer, for reviewer vetting and fraud research. MCP-ready.", "version": "0.0", "x-build-id": "G5HRwn371TgWx20y9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/johnvc~google-maps-reviewer-geo-profile-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-johnvc-google-maps-reviewer-geo-profile-api", "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/johnvc~google-maps-reviewer-geo-profile-api/runs": { "post": { "operationId": "runs-sync-johnvc-google-maps-reviewer-geo-profile-api", "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/johnvc~google-maps-reviewer-geo-profile-api/run-sync": { "post": { "operationId": "run-sync-johnvc-google-maps-reviewer-geo-profile-api", "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": { "contributorId": { "title": "Contributor ID", "type": "string", "description": "Enter a single Google Maps contributor ID (the long numeric ID from a reviewer's profile, e.g. '107022004965696773221'). Provide this, `contributorIds`, or both. You can read a contributor ID from any place review's reviewer." }, "contributorIds": { "title": "Contributor IDs", "type": "array", "description": "Provide a list of Google Maps contributor IDs to profile in one run. Merged with `contributorId` and de-duplicated. One derived row is returned per reviewer.", "items": { "type": "string" } }, "regionGranularity": { "title": "Region Granularity", "enum": [ "city", "admin1", "country" ], "type": "string", "description": "Level the home-region guess and confidence are computed at: 'city' (e.g. Chicago, IL), 'admin1' (state or province), or 'country'. The row always includes the full standardized breakdown (city, admin, country, ISO codes) regardless. Default 'city'.", "default": "city" }, "minCityPopulation": { "title": "Minimum City Population", "minimum": 0, "type": "integer", "description": "Snap each review to the nearest city with at least this population, so big-metro neighborhoods (e.g. 'Chicago Loop') group under the principal city ('Chicago'). Default 100000. Lower it (e.g. 1000) to keep smaller towns distinct, at the cost of large metros fragmenting across neighborhoods.", "default": 100000 }, "hl": { "title": "Language Code", "type": "string", "description": "Set the two-letter interface language code (e.g. 'en', 'es', 'de'). Affects the source review text; the region output is standardized independently of this. Defaults to 'en'.", "default": "en" }, "maxResultsPerContributor": { "title": "Maximum Reviews Per Contributor", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many reviews to analyze per contributor, most recent first. Default 100, maximum 200. Deeper history sharpens the home-region signal by diluting a travel-heavy recent window; the analysis cost is the same at any depth. The endpoint returns fewer if the contributor has fewer.", "default": 100 } } }, "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 } } } } } } } } } }