{ "openapi": "3.0.1", "info": { "title": "Naver Place Reviews Scraper", "description": "Collect public visitor reviews from one or more Naver Place listings in a single run. Each review shows its text, dates, visit details, and star rating when Naver provides one. No Naver login is needed.", "version": "0.0", "x-build-id": "CfA0BosJOoOayRqsy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~naver-place-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-naver-place-reviews", "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/maximedupre~naver-place-reviews/runs": { "post": { "operationId": "runs-sync-maximedupre-naver-place-reviews", "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/maximedupre~naver-place-reviews/run-sync": { "post": { "operationId": "run-sync-maximedupre-naver-place-reviews", "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": [ "findPlacesBy" ], "properties": { "findPlacesBy": { "title": "Find places by", "enum": [ "placeLinks", "businessNames", "searchKeywords" ], "type": "string", "description": "Each run uses one way to find places. Naver Place links: use the accepted links you paste. Business names: find the Naver Place that matches each name. Search keywords: collect the places that Naver's search list shows for each keyword. For another search, start a separate run." }, "placeLinks": { "title": "Naver Place links", "type": "array", "description": "Paste one Naver Place link on each row. These links are accepted: https://map.naver.com/p/entry/place/..., https://m.place.naver.com/..., and https://pcmap.place.naver.com/... Each place is collected on its own.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "businessNames": { "title": "Business names", "type": "array", "description": "Type the name of each business as it appears on Naver. Each name collects its matching Naver Place.", "items": { "type": "string" } }, "searchKeywords": { "title": "Search keywords", "type": "array", "description": "Type a keyword, such as a neighborhood and a category. Each keyword collects the places that Naver's search list shows for it. That can be fewer than the total number of matches that Naver reports. All keywords in one run use the same settings.", "items": { "type": "string" } }, "onlyNewReviews": { "title": "Only new reviews", "type": "boolean", "description": "When on, only visitor reviews that appeared since the place's previous run are collected. When off, all visitor reviews are collected, up to the review limit.", "default": false }, "reviewOrder": { "title": "Review order", "enum": [ "newestFirst", "oldestFirst" ], "type": "string", "description": "Reviews are listed by visit date, not by the date each review was written. Newest first lists the latest visits first. Oldest first reads every review for a place before it returns any. A place with many reviews takes many pages to read. With Oldest first, the review limit only applies after that full read.", "default": "newestFirst" }, "maxReviewsPerPlace": { "title": "Review limit per place", "minimum": 1, "type": "integer", "description": "Optional. Stops after this many visitor reviews for each place. Leave empty to return all available visitor reviews for each place, until Naver has no more to show." }, "includeBlogAndCafePosts": { "title": "Include blog and cafe posts", "type": "boolean", "description": "Adds blog posts and cafe articles from each place's blog tab that are publicly accessible. Naver lists only a limited number of posts for each place. A run can collect fewer posts than the number Naver reports for that place. The review limit does not count them. Each saved post is charged separately. Turn off to collect visitor reviews only.", "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 }, "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 } } } } } } } } } }