{ "openapi": "3.0.1", "info": { "title": "Google Maps Review Health Check — free, no login", "description": "Google Maps reviews toolkit by LeoWorks — free review health check, one business: average stars, owner reply rate, 1-3 star reviews with no reply, last 90 days vs before. No AI, no login. Collection by compass billed to you (~$0.02/30 reviews). Deeper: leoworks/google-maps-review-classifier.", "version": "0.1", "x-build-id": "GyPqeTvu7fuS6zmof" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/leoworks~google-maps-review-health-check/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-leoworks-google-maps-review-health-check", "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/leoworks~google-maps-review-health-check/runs": { "post": { "operationId": "runs-sync-leoworks-google-maps-review-health-check", "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/leoworks~google-maps-review-health-check/run-sync": { "post": { "operationId": "run-sync-leoworks-google-maps-review-health-check", "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": { "place": { "title": "Place — Google Maps URL or place ID preferred", "type": "string", "description": "One business. PREFERRED: its Google Maps URL (the full address-bar URL of the place) or its place ID (starts with ChIJ) — it names the exact branch and “Location” can stay empty. ALTERNATIVE: a business name such as “Joe's Pizza Broadway” — then “Location” (city, country) is REQUIRED; the first Google Maps result inside that location is taken. Search-result pages and coordinates-only URLs do not work. The reviews are collected by compass' Google Maps scraper (compass/crawler-google-places), a separate Actor that Apify bills to your account (about $0.006 per place + $0.0005 per review, its price may change — about $0.02 for 30 reviews); this Actor itself is free. Reviewer names and profiles are never collected. The pre-filled URL is an example (Joe's Pizza Broadway) — replace it with your own place." }, "location": { "title": "Location (city, country) — needed for names, not for URLs", "type": "string", "description": "Where to search for the business name in “Place”, for example “Chicago, USA”. Required when “Place” is a name; leave empty for a URL or place ID." }, "maxReviews": { "title": "Newest reviews to check", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many of the newest reviews to collect and count (1 to 200). Statistics are computed on this sample, so a higher number gives steadier figures and a longer trend; the collection cost grows with it ($0.0005 per review, billed by the scraper).", "default": 30 }, "datasetId": { "title": "Scraper dataset (instead of Place)", "type": "string", "description": "Optional: the dataset of a Google Maps scraper run that already has reviews (compass/crawler-google-places with “Max reviews” above 0). Use this OR “Place”. One card is made per place in the dataset (up to 20). Nothing is collected, so there is no collection cost." } } }, "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 } } } } } } } } } }