{ "openapi": "3.0.1", "info": { "title": "Naver Place Multi-Location Review Monitor", "description": "Enter Naver Place locations (ID + your label) and get change rows - new reviews, owner replies added or edited - plus one free summary row per location: unanswered reviews, oldest unanswered age, reply rate, rating, top keywords. For franchises and agencies. No reviewer personal data.", "version": "0.2", "x-build-id": "9BT59AvYefTQQ95B4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/magenta_courser~multi-location-review-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-magenta_courser-multi-location-review-monitor", "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/magenta_courser~multi-location-review-monitor/runs": { "post": { "operationId": "runs-sync-magenta_courser-multi-location-review-monitor", "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/magenta_courser~multi-location-review-monitor/run-sync": { "post": { "operationId": "run-sync-magenta_courser-multi-location-review-monitor", "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": [ "locations" ], "properties": { "locations": { "title": "Locations", "type": "array", "description": "List of locations to monitor. Each item is an object: {\"placeId\": \"1922651675\", \"label\": \"Seongsu store\", \"group\": \"Client A\"}. placeId is the Naver Place ID (digits) or a Naver Map place URL such as https://map.naver.com/p/entry/place/1922651675; the \"id\" field from Naver Place Search Scraper works directly. label and group are optional free text (your store name, client, region, brand) and are copied to every output row so you can filter and group reports. A plain ID or URL string is also accepted. Duplicate places are checked once." }, "windowDays": { "title": "Observation window (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "How many days back, by VISIT date, each run reads for every location. Whole number from 1 to 365. Default 30. Changes (new reviews, owner replies added or edited) are detected only for reviews inside this window, and the summary numbers (unanswered count, reply rate, average rating, top keywords) are calculated over this window - they are a sample, not the whole history of the place. Example: 14 for a fast daily check, 90 to keep tracking late replies.", "default": 30 }, "maxReviewsPerLocation": { "title": "Max reviews read per location", "minimum": 1, "maximum": 500, "type": "integer", "description": "Upper limit of reviews read inside the observation window for one location, newest visit first. Whole number from 1 to 500. Default 200. If a busy location has more reviews in the window, the summary row shows stopReason \"maxReviewsReached\" and windowFullyScanned false - raise this value or shorten the window. Reading reviews is not charged per review.", "default": 200 }, "emitExistingOnFirstRun": { "title": "First run: also return existing reviews", "type": "boolean", "description": "true or false. Default false. The first run for a location only records a starting point: it returns the summary row but no change rows, so you are not charged for reviews that already existed. Set to true to also get every review currently inside the window as a change row (eventType \"newReview\", isBaseline true) on that first run - useful to load the current backlog of unanswered reviews. These rows are charged like other change rows.", "default": false }, "historyStoreName": { "title": "History name", "type": "string", "description": "Name of the key-value store in your Apify account that remembers which reviews and owner replies were already reported. Default multi-location-review-monitor-history. Use a different name for each independent schedule or client, e.g. reviews-client-a. Letters, digits and \"-\" only. Do not run two runs with the same history name at the same time." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Keep the default Apify Proxy (datacenter). Naver rate-limits repeated requests from one IP (HTTP 429); the Actor uses a new proxy session for every request attempt.", "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 }, "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 } } } } } } } } } }