{ "openapi": "3.0.1", "info": { "title": "Naver Map Reviews Scraper - Korean Ratings & Blog Posts", "description": "Scrape reviews from any Naver Map place in South Korea. Returns visitor reviews with star rating, author, visit date, repeat-visit count, photos, menu ordered, voted keywords and the owner's reply, plus the Naver blog and cafe posts linked to the place. Give a place ID or a place URL.", "version": "0.1", "x-build-id": "FSw3VJWAHc5Df5viY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s-r~naver-map-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s-r-naver-map-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/s-r~naver-map-reviews/runs": { "post": { "operationId": "runs-sync-s-r-naver-map-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/s-r~naver-map-reviews/run-sync": { "post": { "operationId": "run-sync-s-r-naver-map-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", "properties": { "placeIds": { "title": "Place IDs or place URLs", "type": "array", "description": "Naver Map places to read reviews for. Paste either the numeric place ID or the full place URL, for example https://map.naver.com/p/entry/place/1668757640 or https://pcmap.place.naver.com/restaurant/1668757640/home. Both forms work and mixing them is fine.", "default": [ "1668757640" ], "items": { "type": "string" } }, "reviewType": { "title": "Which reviews", "enum": [ "visitor", "blog", "both" ], "type": "string", "description": "Visitor reviews are the star-rated reviews people write on Naver itself. Blog reviews are the Naver blog and cafe posts Naver has linked to the place; they carry a title, a link and the post body but no star rating. Pick 'Both' to get each kind in one run, told apart by the review_type column.", "default": "visitor" }, "maxReviewsPerPlace": { "title": "Max reviews per place", "minimum": 1, "maximum": 3000, "type": "integer", "description": "How many reviews to return for each place, per review type. Naver caps what it will serve regardless of what you ask for: roughly 3,000 visitor reviews per place, and a few hundred blog posts at most. The run summary reports the cap it hit so a short result is never mistaken for a place losing its reviews.", "default": 100 }, "sort": { "title": "Sort order", "enum": [ "recommend", "recent", "rating" ], "type": "string", "description": "How Naver orders the visitor reviews before they are read. 'Recommended' is Naver's own default ordering, 'Newest first' walks back from today, and 'By rating' leads with the highest ratings. Blog posts always come back in Naver's own order and ignore this setting.", "default": "recommend" } } }, "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 } } } } } } } } } }