# Naver Place Scraper - Korea Local Business & Map Data (`haketa/naver-place-scraper`) Actor

Naver Place & Naver Map scraper (Korea): search local businesses by area + keyword and export name, category, address, phone, rating, visitor & blog review counts, hours and GPS coordinates. Korea local-business lead generation and market data — fast, no login.

- **URL**: https://apify.com/haketa/naver-place-scraper.md
- **Developed by:** [Haketa](https://apify.com/haketa) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 75.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.70 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Naver Place Scraper 🇰🇷 — Korea Local Business & Map Data

Extract **local business data from Naver Place / Naver Map** — Korea's #1 local directory — as clean, structured JSON. Search by **area + keyword** (e.g. `강남 맛집`) and get **name, category, road & lot address, phone, rating, visitor & blog review counts, business hours, coordinates, booking links** and more.

> 💡 **Why Naver, not Google Maps?** In Korea, **Google Maps is structurally weak** (Korean law restricts exporting map data), so Naver dominates local search. Naver Place is *the* source for Korean restaurants, cafes, shops and services — data the global Google Maps scrapers simply can't deliver.

---

### 📋 Table of contents

- [What does it do?](#what-does-it-do)
- [Use cases](#use-cases)
- [How to use it](#how-to-use-it-step-by-step)
- [Input parameters](#input-parameters)
- [Input examples](#input-examples)
- [Output — data fields](#output--data-fields)
- [Sample output record](#sample-output-record)
- [Tips & best practices](#tips--best-practices)
- [Frequently asked questions](#frequently-asked-questions)
- [Changelog](#changelog)

---

### What does it do?

Give it Korean **search queries** (area + keyword) and it returns every matching place with a rich profile:

- 🏪 **Identity:** name, category, business category, description.
- 📍 **Location:** road address, lot (jibun) address, full address, and **GPS coordinates**.
- 📞 **Contact:** phone and Naver virtual phone number.
- ⭐ **Reputation:** visitor review score (rating), visitor review count, **blog/cafe review count**, total review count.
- 🕒 **Details:** business hours, amenities/options, booking link, Naver Pay, Michelin guide flag, images.

Export to **JSON, CSV, Excel, XML or HTML**, or pull from the **Apify API**.

---

### Use cases

**📇 Korea lead generation & local marketing**
- Build lists of Korean businesses by area + category with **phone + address** for outreach.
- Target restaurants, cafes, salons, clinics by neighborhood.

**📊 Market & competitive research**
- Map business density, ratings and review volume across Korean districts.
- Benchmark competitors by reviews and rating.

**🍽️ Food / travel / review platforms**
- Aggregate Korean restaurant/cafe data with ratings and coordinates.

**🤖 Data & AI teams**
- Build Korean local-business datasets with reputation signals.

---

### How to use it (step by step)

No coding required.

1. Click **Try for free / Start**.
2. Add **Search queries** in Korean — area + keyword, e.g. `강남 맛집`, `홍대 카페`, `제주 호텔`.
3. Pick a **Place type** (restaurants, all places, hair/beauty, hospitals, attractions).
4. Set **Max places**.
5. Keep the proxy on its default — **KR Residential** (required).
6. Click **Save & Start**, then export the results.

---

### Input parameters

| Field | Type | Description |
|------|------|-------------|
| `queries` | array | Korean search queries (area + keyword), e.g. `강남 맛집`. |
| `searchType` | string | Place vertical: `restaurant`, `place`, `hairshop`, `hospital`, `attraction`. |
| `maxItems` | integer | Max places. `0` = no limit. Default `200`. |
| `maxPagesPerQuery` | integer | Pagination cap per query (~50 places/page). Default `10`. |
| `proxyConfiguration` | object | **KR Residential required** (Naver needs a Korean IP and rate-limits hard). Default. |
| `maxConcurrency` | integer | Keep low — per-IP rate limits. Default `2`. |

---

### Input examples

**1) Restaurants in Gangnam**

```json
{
  "queries": ["강남 맛집"],
  "searchType": "restaurant",
  "maxItems": 200
}
````

**2) Cafes across several areas**

```json
{
  "queries": ["홍대 카페", "성수 카페", "연남동 카페"],
  "searchType": "restaurant",
  "maxItems": 1000
}
```

**3) Hair salons in Seoul**

```json
{
  "queries": ["서울 미용실"],
  "searchType": "hairshop"
}
```

***

### Output — data fields

One record per place:

| Field | Description |
|------|-------------|
| `placeId` | Naver place ID |
| `name` | Business name |
| `category` / `businessCategory` | Category |
| `description` | Short description |
| `roadAddress` | Road-name address |
| `address` | Lot (jibun) address |
| `fullAddress` / `commonAddress` | Full / common address |
| `phone` / `virtualPhone` | Phone numbers |
| `latitude` / `longitude` | GPS coordinates |
| `visitorReviewScore` | Visitor rating |
| `visitorReviewCount` | Visitor review count |
| `blogCafeReviewCount` | Blog/cafe review count |
| `bookingReviewCount` / `totalReviewCount` | Booking / total review counts |
| `businessHours` / `newBusinessHours` | Hours |
| `options` | Amenities / options |
| `hasBooking` / `bookingUrl` | Naver booking |
| `hasNPay` | Naver Pay accepted |
| `michelinGuide` | Michelin guide info |
| `imageUrl` / `imageCount` / `imageUrls` | Images |
| `placeUrl` / `mobileUrl` | Naver Place URLs |
| `searchQuery` | The query that produced this record |
| `scrapedAt` | ISO timestamp |

***

### Sample output record

```json
{
  "placeId": "1046192699",
  "name": "봉계타 현대백화점 무역센터점",
  "category": "칼국수,만두",
  "roadAddress": "테헤란로 517 현대백화점 무역센터점 10층",
  "address": "삼성동 159-7",
  "phone": "02-3467-6698",
  "latitude": 37.5085258,
  "longitude": 127.059807,
  "visitorReviewScore": 4.5,
  "visitorReviewCount": 2076,
  "blogCafeReviewCount": 512,
  "totalReviewCount": 2588,
  "hasBooking": true,
  "placeUrl": "https://map.naver.com/p/entry/place/1046192699",
  "searchQuery": "강남 맛집",
  "scrapedAt": "2026-06-05T17:00:00.000Z"
}
```

***

### Tips & best practices

- 🇰🇷 **Keep the default KR Residential proxy** — Naver requires a Korean IP and blocks others.
- 🗺️ **Use area + keyword queries** (`강남 맛집`, `부산 카페`) — combine many to cover a region.
- 🧪 **Start with one query** and a small `maxItems` to confirm the output.
- 🐢 **Keep concurrency low** — Naver rate-limits per IP.
- 💾 **Use the Apify API / integrations** to push results into Google Sheets, a CRM, or a webhook, and **schedule** runs to track new openings and ratings.

***

### Frequently asked questions

**Do I need a Korean proxy?**
Yes — Naver only serves a Korean IP reliably and rate-limits others. The actor defaults to KR Residential; keep it.

**Does it include ratings and review counts?**
Yes — visitor rating, visitor review count, and blog/cafe review counts.

**Does it return phone numbers and addresses?**
Yes — phone, virtual phone, road and lot addresses, plus GPS coordinates.

**Can I scrape cafes / salons / clinics, not just restaurants?**
Yes — set the **Place type** (restaurants/cafes, all places, hair & beauty, hospitals, attractions).

**What export formats are supported?**
JSON, CSV, Excel, XML, HTML table, RSS — plus the Apify API and integrations.

***

### Changelog

**0.1.0**

- Initial release: search Naver Place by area + keyword with automatic pagination.
- Rich place records: category, road & lot address, phone & virtual phone, rating, visitor & blog review counts, hours, coordinates, booking and images.
- KR residential proxy handling; fast API-first parsing (no browser).

# Actor input Schema

## `queries` (type: `array`):

Search queries combining area + keyword, in Korean, e.g. '강남 맛집' (Gangnam restaurants), '홍대 카페' (Hongdae cafes), '제주 호텔'. Each query is searched separately.

## `searchType` (type: `string`):

Which Naver Place vertical to search. 'restaurant' for food/cafes, 'place' for general businesses, or a specific vertical.

## `maxItems` (type: `integer`):

Maximum number of places to scrape across all queries. Use 0 for no limit.

## `maxPagesPerQuery` (type: `integer`):

Pagination cap per query (~50 places per page).

## `proxyConfiguration` (type: `object`):

Naver requires a KOREAN (KR) IP and rate-limits aggressively — KR RESIDENTIAL proxies are the reliable default. Keep this.

## `maxConcurrency` (type: `integer`):

Keep low — Naver rate-limits per IP.

## Actor input object example

```json
{
  "queries": [
    "강남 맛집"
  ],
  "searchType": "restaurant",
  "maxItems": 200,
  "maxPagesPerQuery": 10,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "KR"
  },
  "maxConcurrency": 2
}
```

# Actor output Schema

## `places` (type: `string`):

All place records collected during the run.

## `runUrl` (type: `string`):

Open this run in the Apify Console.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "queries": [
        "강남 맛집"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "KR"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("haketa/naver-place-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "queries": ["강남 맛집"],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "KR",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("haketa/naver-place-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "queries": [
    "강남 맛집"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "KR"
  }
}' |
apify call haketa/naver-place-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=haketa/naver-place-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Naver Place Scraper - Korea Local Business & Map Data",
        "description": "Naver Place & Naver Map scraper (Korea): search local businesses by area + keyword and export name, category, address, phone, rating, visitor & blog review counts, hours and GPS coordinates. Korea local-business lead generation and market data — fast, no login.",
        "version": "0.1",
        "x-build-id": "LzfqEoE8brEMs864N"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/haketa~naver-place-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-haketa-naver-place-scraper",
                "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/haketa~naver-place-scraper/runs": {
            "post": {
                "operationId": "runs-sync-haketa-naver-place-scraper",
                "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/haketa~naver-place-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-haketa-naver-place-scraper",
                "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": {
                    "queries": {
                        "title": "Search queries (Korean)",
                        "type": "array",
                        "description": "Search queries combining area + keyword, in Korean, e.g. '강남 맛집' (Gangnam restaurants), '홍대 카페' (Hongdae cafes), '제주 호텔'. Each query is searched separately.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "searchType": {
                        "title": "Place type",
                        "enum": [
                            "restaurant",
                            "place",
                            "hairshop",
                            "hospital",
                            "attraction"
                        ],
                        "type": "string",
                        "description": "Which Naver Place vertical to search. 'restaurant' for food/cafes, 'place' for general businesses, or a specific vertical.",
                        "default": "restaurant"
                    },
                    "maxItems": {
                        "title": "Max places",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum number of places to scrape across all queries. Use 0 for no limit.",
                        "default": 200
                    },
                    "maxPagesPerQuery": {
                        "title": "Max pages per query",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Pagination cap per query (~50 places per page).",
                        "default": 10
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Naver requires a KOREAN (KR) IP and rate-limits aggressively — KR RESIDENTIAL proxies are the reliable default. Keep this.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ],
                            "apifyProxyCountry": "KR"
                        }
                    },
                    "maxConcurrency": {
                        "title": "Max concurrency",
                        "minimum": 1,
                        "maximum": 6,
                        "type": "integer",
                        "description": "Keep low — Naver rate-limits per IP.",
                        "default": 2
                    }
                }
            },
            "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
                                    }
                                }
                            },
                            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```