{ "openapi": "3.0.1", "info": { "title": "Naver Place (네이버 플레이스) Scraper - Korean Business + Reviews", "description": "Search Naver Map by Korean keyword or region, or paste Naver Place links, and get the public listing: place ID, name, category, lot and road address, business phone, coordinates, rating and review counts, plus public visitor reviews on request. Cut-short collection is marked partial, not zero.", "version": "0.0", "x-build-id": "1D7Obd5DE4lPwvRPO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lanternlab318~naver-place/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lanternlab318-naver-place", "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/lanternlab318~naver-place/runs": { "post": { "operationId": "runs-sync-lanternlab318-naver-place", "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/lanternlab318~naver-place/run-sync": { "post": { "operationId": "run-sync-lanternlab318-naver-place", "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": { "searchQueries": { "title": "Search terms", "type": "array", "description": "One Naver Map search term per line, the way you would type it on the map: a keyword plus a region works best, for example \"강남 카페\", \"부산 해운대 호텔\" or \"서울 치과\". Korean terms return far more than English ones because this is Naver's Korean index. Every term is searched separately and its places are labelled with it. A place that matches several of your terms is returned once and charged once. Give this, or placeUrls, or both.", "items": { "type": "string" } }, "placeUrls": { "title": "Naver Place links", "type": "array", "description": "One Naver Place link or numeric place ID per line, for example https://map.naver.com/p/entry/place/1498100901, https://pcmap.place.naver.com/restaurant/1498100901/home or just 1498100901. naver.me short links are not supported: open one and paste the address it lands on. A link whose place no longer exists is reported as not_found, not as a failure.", "items": { "type": "string" } }, "maxPlacesPerQuery": { "title": "Max places per search term", "minimum": 1, "maximum": 300, "type": "integer", "description": "Upper bound on the places one search term may produce. Naver serves 100 places per request and this Actor pages past that, so higher values cost more requests but do reach more places. Naver's own result list for a term runs out well before the total it reports, and the run says per term how many it actually got.", "default": 20 }, "includeReviews": { "title": "Also collect public visitor reviews", "type": "boolean", "description": "With this on, every place collected in the run also returns its public visitor reviews: star rating, review text, the visit date and the publish date as Naver shows them, the receipt/payment origin, and the reviewer's public display nickname. Reviews are charged per review, so leave this off when you only need the business listings.", "default": false }, "maxReviewsPerPlace": { "title": "Max reviews per place", "minimum": 1, "maximum": 500, "type": "integer", "description": "Upper bound on the reviews one place may produce, used only when reviews are on. Naver serves 50 reviews per request and this Actor pages past that with Naver's own cursor, newest first. A place with fewer reviews than this returns all of them and says so.", "default": 50 }, "maxUpstreamRequests": { "title": "Max Naver requests", "minimum": 1, "type": "integer", "description": "Hard ceiling on the HTTP requests this run sends to Naver: search pages, place details and review pages together. At the ceiling collection stops - the inputs not finished are written with partialReason \"upstream_request_cap\" and the run then ends normally. Leave empty and the Actor works a ceiling out from your inputs and limits, so a run is never unbounded." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "The proxy the requests to Naver go through. The default (Apify Proxy, datacenter) is the cheapest and is what this Actor is measured on; Naver serves these public place endpoints over it without a captcha, and the run rotates the exit IP per request because one IP that sends about five requests back to back is rate-limited. A Korean exit is not required.", "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 } } } } } } } } } }