# Kakao Map Reviews Scraper (카카오맵 리뷰 · KakaoMap Reviews) (`magenta_courser/kakaomap-reviews-scraper`) Actor

Enter Kakao Map place IDs or place URLs and get visitor reviews as flat JSON rows: star rating, text, ISO written date, keyword tags, photos and like count, plus a summary row per place. No reviewer personal data.

- **URL**: https://apify.com/magenta_courser/kakaomap-reviews-scraper.md
- **Developed by:** [SUNGHWAN CHO](https://apify.com/magenta_courser) (community)
- **Categories:** Marketing, Lead generation, Travel
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.40 / 1,000 reviews

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Kakao Map Reviews Scraper (카카오맵 리뷰) | Korean Place Reviews, Ratings & Keyword Tags (2026)

**Languages:** English · [한국어](#korean) · [中文](#chinese) · [日本語](#japanese)

[![$0.50 per 1,000 Kakao Map reviews, as flat JSON, with no reviewer identity](https://raw.githubusercontent.com/experimory-crypto/naver-map-scraper-examples/main/assets/hero-kakaomap-reviews-scraper.png)](https://apify.com/magenta_courser/kakaomap-reviews-scraper)

Enter **Kakao Map place IDs or place URLs** and get **visitor reviews** as flat JSON rows: star rating, review text, written date and last-edit date as ISO timestamps, keyword tags (Korean plus English codes), photo URLs, like count and whether the owner pinned the review, with a summary row per place. No Kakao login, no API key, no browser.

Part of a small set of Korean data Actors from one maintainer: [Kakao Map places](https://apify.com/magenta_courser/kakaomap-place-search-scraper), [Naver Map reviews](https://apify.com/magenta_courser/naver-place-reviews-scraper), [Naver Map places](https://apify.com/magenta_courser/naver-place-search-scraper) and [Naver Shopping ranks](https://apify.com/magenta_courser/naver-shopping-rank-tracker). **Reviewer identity is never collected.**

> **Free plan:** Apify's $5 monthly credit covers about 10,000 reviews with this Actor (at the per-review price plus a $0.00005 start fee per run).

### Why choose this Actor?

**$0.50 per 1,000 reviews, and nothing else per row.**<br>
You pay $0.0005 per review row saved, plus a $0.00005 start fee per run. The place summary and run summary rows are free, a place ID that does not exist is free, and a run that saves nothing costs only the start fee.

**No reviewer identity, by design.**<br>
Kakao's response includes the reviewer's nickname, user ID, profile image, follower and review counts and level badge. The Actor never reads those fields, so they are never in your dataset. You get the review itself (rating, text, dates, tags, photos, likes) and the place's statistics.

**Cheap to re-run on a schedule.**<br>
Kakao lists reviews by last update, newest first. With `reviewsNewerThan` the Actor stops paging at the first review older than your date, so a weekly check of a place with no new reviews reads one page and charges no review rows.

**Usable without reading Korean.**<br>
Every keyword tag comes with an English code (`taste`, `value`, `kindness`, `mood`, `parking`), on each review and in the place's vote totals, so you can aggregate before translating anything.

**Measured, not estimated.** All 57 reviews of one place took 9.1 seconds at 256 MB in run `ulWecDgOe2w9kGSq7` (build 0.1.2, 2026-11-11, default datacenter proxy).

### Quick start

The 100 newest reviews of one place. This is the default input; at the Free-plan price it costs at most about $0.05.

```json
{
  "places": ["10735673"],
  "maxReviewsPerPlace": 100
}
```

[Open the Actor input](https://console.apify.com/actors/2U7Y3bEdLw8F7IkdP/input), paste place IDs or Kakao Map URLs, and click **Start**. Export the dataset as JSON, CSV or Excel.

Don't have place IDs yet? Run [Kakao Map Scraper](https://apify.com/magenta_courser/kakaomap-place-search-scraper) with a keyword such as `성수 카페` (Seongsu cafes) and pass its `id` field into `places`. Or open a place on Kakao Map: the number in `https://place.map.kakao.com/10735673` is the place ID.

#### Copy to your AI assistant

Paste this into ChatGPT, Claude, Cursor or another assistant so it can call the Actor for you:

```text
Use the Apify Actor magenta_courser/kakaomap-reviews-scraper to get Kakao Map (카카오맵) visitor reviews for South Korean businesses.

Input (JSON): "places" (required) is a list of Kakao Map place IDs such as "10735673" or place URLs such as "https://place.map.kakao.com/10735673". Optional: "maxReviewsPerPlace" (integer, default 100), "sort" ("latest" default, or "recommended"), "reviewsNewerThan" ("YYYY-MM-DD", Korea time, compared with the date a review was written or last edited), "onlyPhotoReviews" (boolean, default false), "includePlaceSummary" (boolean, default true).

Output: dataset rows with a "type" field. "review" rows have placeId, placeName, placeRating, placeReviewCount, reviewId, rating, text (Korean, or null), createdAt and updatedAt (UTC ISO), isEdited, keywords and keywordCodes (taste, value, kindness, mood, parking), photoCount, photoUrls, likeCount, isOwnerPick, url. One "placeSummary" row per place has status, stopReason, reviewsSaved, avgRating, totalReviewCount, keywordVotes. One "runSummary" row per run. Missing values are null. Reviewer names and profiles are never returned. Owner replies are not returned.

Run it through the Apify API: POST https://api.apify.com/v2/acts/magenta_courser~kakaomap-reviews-scraper/run-sync-get-dataset-items with my Apify token as a Bearer token and the input as the JSON body. Or connect the MCP server https://mcp.apify.com?tools=magenta_courser/kakaomap-reviews-scraper.

Price: $0.0005 per review row (Free plan). Keep maxReviewsPerPlace small while testing.
```

#### Use it over MCP

Add this server to Claude Desktop, Cursor or any MCP client, authenticated with your Apify token:

```text
https://mcp.apify.com?tools=magenta_courser/kakaomap-reviews-scraper
```

The agent only has to fill `places`; everything else has a default.

### Key features

- **Flexible place input.** Numeric place ID, `place.map.kakao.com/<id>`, `place.map.kakao.com/m/<id>`, `map.kakao.com/?itemId=<id>` and `map.kakao.com/link/map/<id>` URLs. Duplicate places run once.
- **Two sort orders.** `latest` (most recently written or edited first) or `recommended` (Kakao Map's own default order).
- **Up to 100,000 reviews per place** by input limit, 20 per request.
- **Written date and last-edit date as UTC ISO timestamps**, plus an `isEdited` flag.
- **Keyword tags with English codes** on every review, and the place's vote totals per tag.
- **Photos.** `photoUrls` and `photoCount` on every review; `onlyPhotoReviews` asks Kakao for photo reviews only, so other reviews are neither read nor charged.
- **Likes and owner picks.** `likeCount`, and `isOwnerPick` when the business owner pinned the review.
- **Free place summary.** Average rating, total review count and keyword votes per place, with a `status` and `stopReason`.
- **Date cut-off that stops paging early.** `reviewsNewerThan` for scheduled runs.
- **Clean stop at your cost limit.** Rows stored equal rows charged. In run `1VbYYUgKhxKS8gtCm` a $0.01 limit saved exactly 19 reviews and marked the place `budgetLimited`.
- **One bad place does not fail the run.** Other places are still saved; the run fails only when every place fails.

### How to scrape Kakao Map reviews

#### Latest reviews of specific places

```json
{
  "places": [
    "https://place.map.kakao.com/10735673",
    "https://map.kakao.com/?itemId=27259030",
    "22894118"
  ],
  "maxReviewsPerPlace": 300
}
```

#### Every review of a place

Set a high limit. The Actor stops at the end of the list (`stopReason: "endOfReviews"`) and you pay only for the reviews saved.

```json
{
  "places": ["10735673"],
  "maxReviewsPerPlace": 100000
}
```

#### Only reviews written or edited since a date

`reviewsNewerThan` is read as 00:00 Korea time and compared with `updatedAt`. Paging stops at the first older review. A review edited after the date comes back too, with the same `reviewId` and `isEdited: true`.

```json
{
  "places": ["27259030", "965653384"],
  "reviewsNewerThan": "2026-11-01",
  "maxReviewsPerPlace": 1000
}
```

#### Kakao's recommended order

```json
{
  "places": ["22894118"],
  "sort": "recommended",
  "maxReviewsPerPlace": 50
}
```

#### Photo reviews only

```json
{
  "places": ["22894118"],
  "onlyPhotoReviews": true,
  "maxReviewsPerPlace": 30
}
```

#### Review rows only, no summary rows

```json
{
  "places": ["10735673"],
  "maxReviewsPerPlace": 100,
  "includePlaceSummary": false
}
```

The per-place status is still saved in the run's key-value store as `RUN_SUMMARY`.

### Input parameters

| Field | Type | Default | Description |
|---|---|---|---|
| `places` | array of strings | — | **Required.** Kakao Map place IDs or place URLs, one per line. Lines without a place ID are skipped with a warning. Short `kko.to` links are not supported. |
| `maxReviewsPerPlace` | integer | `100` | 1 to 100,000. Reviews to save per place. |
| `sort` | string | `latest` | `latest` = most recently written or edited first. `recommended` = Kakao Map's default order. When `reviewsNewerThan` is set, `latest` is always used. |
| `reviewsNewerThan` | string | — | `YYYY-MM-DD`, read as 00:00 Korea time (UTC+9). Saves only reviews written or last edited on or after this date. |
| `onlyPhotoReviews` | boolean | `false` | Only reviews that have at least one photo. |
| `includePlaceSummary` | boolean | `true` | Add the free `placeSummary` and `runSummary` rows to the dataset. |
| `proxyConfiguration` | object | Apify Proxy | Keep the default (datacenter). Kakao Map may reject repeated requests from one IP. |

Inputs written for other Kakao review Actors mostly run unchanged: `placeIds`, `placeUrls`, `urls` and `startUrls` are accepted in place of `places`. Output field names are this Actor's own.

#### How the date filter works

Kakao's "latest" order is by **last update**, not by written date: an edited review moves back to the top. In a check on 2026-11-11 over 546 reviews of 4 places, the list had 0 order inversions by `updatedAt` and 32 by `createdAt`. The Actor therefore compares your date with `updatedAt` and stops at the first older review.

Limits: there is no built-in memory of what a previous run delivered. For a schedule, pass the date of your last run yourself (see Advanced usage), and de-duplicate on `reviewId` if you keep reviews in a database, because an edited review is returned again. Deleted reviews are not reported.

### What data can you extract from Kakao Map reviews?

Rows have a `type` field. Missing values are `null`; keys are never left out.

**Review rows** (`"type": "review"`), in the sort order you chose:

| Field | Type | Description |
|---|---|---|
| `placeId`, `placeName` | string | The Kakao Map place ID and its name. |
| `placeRating`, `placeReviewCount` | number | The place's average rating and total review count, repeated on every row. |
| `reviewId` | string | Kakao's review ID. |
| `rating` | number | Star rating (1 to 5 in our runs). |
| `text` | string | Review text; `null` when the reviewer left only stars. |
| `createdAt`, `updatedAt` | string | Written time and last-edit time as UTC ISO timestamps, converted from Kakao's Korea-time values. |
| `isEdited` | boolean | `true` when `updatedAt` differs from `createdAt`. |
| `keywords`, `keywordCodes` | array of strings | Tags the reviewer picked: 맛 `taste`, 가성비 `value`, 친절 `kindness`, 분위기 `mood`, 주차 `parking`. Empty array when none. |
| `photoCount`, `photoUrls` | number / array | Review photos as `https` URLs. |
| `likeCount` | number | Likes on the review. |
| `isOwnerPick` | boolean | The business owner pinned this review. |
| `url`, `scrapedAt`, `source`, `schemaVersion` | string / number | Place review URL, timestamp, `kakao`, `1`. |

**Place summary rows** (`"type": "placeSummary"`, one per place): `placeId`, `placeName`, `status` (`completed`, `partial`, `failed`, `budgetLimited`, `notStarted`), `stopReason` (`endOfReviews`, `maxReviewsReached`, `dateReached`, `noReviews`, `placeNotFound`, `requestFailed`, `chargeLimitReached`), `errorMessage`, `reviewsSaved`, `pagesFetched`, `avgRating`, `totalReviewCount`, `keywordVotes` (`[{code, keyword, count}]`), `keywordVoterCount`, `url`, `scrapedAt`.

**Run summary** (`"type": "runSummary"`, one per run): `status`, `sort`, `reviewsNewerThan`, `onlyPhotoReviews`, `placesRequested`, `placesCompleted`, `placesPartial`, `placesFailed`, `placesBudgetLimited`, `placesNotStarted`, `reviewsSaved`, `finishedAt`. The same report with a per-place list is always stored in the run's key-value store under `RUN_SUMMARY`.

**Not returned:** reviewer nickname, profile or user ID (never read); owner replies; the place's address, phone, category or coordinates (use [Kakao Map Scraper](https://apify.com/magenta_courser/kakaomap-place-search-scraper) for those).

#### Output example: review

From run `ulWecDgOe2w9kGSq7` (2026-11-11, build 0.1.2), a samgyetang (ginseng chicken soup) restaurant. Unedited.

```json
{
  "type": "review",
  "source": "kakao",
  "schemaVersion": 1,
  "placeId": "10735673",
  "placeName": "장안삼계탕",
  "placeRating": 3.9,
  "placeReviewCount": 57,
  "reviewId": "16155163",
  "rating": 5,
  "text": "능이삼계탕 맛났어요 !! 직원분이 붐비는 시간이었지만 큰자리로 안내해주시고 여유롭게 식사했습니다\n같이 나온 인삼주도 한병이라 딱 좋았습니다\n능이삼계탕 먹고 기력이 올라오는걸 느꼈어요\n힘얻어 런닝 8키로 !! 딱좋았습니다",
  "createdAt": "2026-08-02T07:40:45.000Z",
  "updatedAt": "2026-08-02T07:40:45.000Z",
  "isEdited": false,
  "keywords": ["맛", "친절"],
  "keywordCodes": ["taste", "kindness"],
  "photoCount": 0,
  "photoUrls": [],
  "likeCount": 0,
  "isOwnerPick": false,
  "url": "https://place.map.kakao.com/10735673#review",
  "scrapedAt": "2026-11-11T07:57:47.920Z"
}
```

#### Output example: an edited review with photos

Same run. The review text and four of the six photo URLs are cut here with `…`; the real row has them in full.

```json
{
  "type": "review",
  "source": "kakao",
  "schemaVersion": 1,
  "placeId": "10735673",
  "placeName": "장안삼계탕",
  "placeRating": 3.9,
  "placeReviewCount": 57,
  "reviewId": "14910112",
  "rating": 4,
  "text": "음식맛으로만 치면 5점 드리고 싶습니다만.\n남자 넷이서 4인테이블에 앉으라고 안내해주셨는데 …",
  "createdAt": "2026-02-25T08:59:48.000Z",
  "updatedAt": "2026-02-25T09:00:27.000Z",
  "isEdited": true,
  "keywords": ["맛"],
  "keywordCodes": ["taste"],
  "photoCount": 6,
  "photoUrls": [
    "https://t1.kakaocdn.net/local/kakaomapPhoto/review/f2db3e4fdfdc7a59ac4f6cf26b2a58c654ab1b4f?original",
    "https://t1.kakaocdn.net/local/kakaomapPhoto/review/b6fb9b2e2dad5f000e391c4caa66215fa9fe623a?original",
    "…"
  ],
  "likeCount": 0,
  "isOwnerPick": false,
  "url": "https://place.map.kakao.com/10735673#review",
  "scrapedAt": "2026-11-11T07:57:47.920Z"
}
```

#### Output example: place summary

Same run. Unedited.

```json
{
  "type": "placeSummary",
  "source": "kakao",
  "schemaVersion": 1,
  "placeId": "10735673",
  "placeName": "장안삼계탕",
  "status": "completed",
  "stopReason": "endOfReviews",
  "errorMessage": null,
  "reviewsSaved": 57,
  "pagesFetched": 3,
  "avgRating": 3.9,
  "totalReviewCount": 57,
  "keywordVotes": [
    { "code": "taste", "keyword": "맛", "count": 14 },
    { "code": "kindness", "keyword": "친절", "count": 11 },
    { "code": "mood", "keyword": "분위기", "count": 3 },
    { "code": "value", "keyword": "가성비", "count": 2 }
  ],
  "keywordVoterCount": 17,
  "url": "https://place.map.kakao.com/10735673",
  "scrapedAt": "2026-11-11T07:57:53.045Z"
}
```

#### Output example: run summary

Same run. Unedited.

```json
{
  "type": "runSummary",
  "source": "kakao",
  "schemaVersion": 1,
  "status": "completed",
  "sort": "latest",
  "reviewsNewerThan": null,
  "onlyPhotoReviews": false,
  "placesRequested": 1,
  "placesCompleted": 1,
  "placesPartial": 0,
  "placesFailed": 0,
  "placesBudgetLimited": 0,
  "placesNotStarted": 0,
  "reviewsSaved": 57,
  "finishedAt": "2026-11-11T07:57:53.068Z"
}
```

### Advanced usage

#### Weekly monitoring with a moving date

The Actor does not remember earlier runs, so compute the date in your own code and pass it in. Reviews are de-duplicated on `reviewId` because an edited review comes back again.

```python
from datetime import datetime, timedelta, timezone
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
kst = timezone(timedelta(hours=9))
since = (datetime.now(kst) - timedelta(days=7)).strftime("%Y-%m-%d")

run = client.actor("magenta_courser/kakaomap-reviews-scraper").call(run_input={
    "places": ["10735673", "27259030"],
    "reviewsNewerThan": since,
    "maxReviewsPerPlace": 500,
})
seen = set()
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
    if row["type"] == "review" and row["reviewId"] not in seen:
        seen.add(row["reviewId"])
        if row["rating"] is not None and row["rating"] <= 2:
            print(row["placeName"], row["rating"], row["updatedAt"], row["text"])
```

#### Compare branches or competitors in one table

Read `avgRating`, `totalReviewCount` and `keywordVotes` from the `placeSummary` rows. A summary row is written for every place, but a run always saves at least one review per place that has reviews (`maxReviewsPerPlace` cannot be 0), so set `"maxReviewsPerPlace": 1` to keep the cost at one review row per place.

```json
{
  "places": ["27259030", "965653384", "22894118"],
  "maxReviewsPerPlace": 1
}
```

#### Same place on Kakao Map and Naver Map

[Naver Map Reviews Scraper](https://apify.com/magenta_courser/naver-place-reviews-scraper) uses the same row layout (`type`, `placeId`, `placeName`, `rating`, `text`, `createdAt`, `keywords`, `keywordCodes`, `photoUrls`, plus a `placeSummary` row), with `source` set to `naver` instead of `kakao`. You can load both datasets into one table and group by `source`. The place IDs are different on each platform.

#### One call from the command line

```bash
curl -X POST "https://api.apify.com/v2/acts/magenta_courser~kakaomap-reviews-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"places": ["10735673"], "maxReviewsPerPlace": 50}'
```

### How much does it cost to scrape Kakao Map reviews?

Pay per event, no subscription. Prices below are the Free-plan prices in effect since 2026-11-11; paid Apify plans get the discount shown. No price change is scheduled.

| Event | Price | Bronze / Silver / Gold and above | When |
|---|---|---|---|
| `review` | **$0.0005** per review row | $0.000475 / $0.00045 / $0.0004 | Every review saved to the dataset. |
| Actor start | $0.00005 | — | Once per run (one event per GB of memory, minimum one; the default is 256 MB). |

Not charged: `placeSummary` and `runSummary` rows, place IDs that do not exist, places whose first page fails, places not started because of your cost limit.

Worked examples at the Free-plan price (start fee of $0.00005 per run not shown):

| Job | Events | Cost |
|---|---|---|
| Default run: up to 100 newest reviews of 1 place | 100 reviews | **$0.05** |
| All 57 reviews of the place in the output example | 57 reviews | **$0.0285** |
| One-time export of 1,000 reviews | 1,000 reviews | **$0.50** |
| Audit of 50 places, 200 reviews each | 10,000 reviews | **$5.00** |
| Weekly check of 100 locations, 20 new or edited reviews each | 2,000 reviews | **$1.00 per week**, about $4.00 per month |

Set **Maximum cost per run** in the console to cap a run. It stops cleanly: the place being scraped gets `status: "budgetLimited"`, the remaining places `"notStarted"` (not requested, not charged), and `reviewsSaved` counts exactly the rows stored.

### Scheduling and integrations

- **Schedules.** In Apify Console, create a daily or weekly schedule. A schedule sends the same input each time, so either keep a fixed `maxReviewsPerPlace` and de-duplicate on `reviewId`, or start the run from your own code with a moving `reviewsNewerThan` date (see Advanced usage).
- **Webhooks and automation.** Send the dataset to Slack, Google Sheets, Make, Zapier or n8n with Apify integrations, or call your own endpoint with a webhook when a run finishes.
- **API clients.** Any HTTP client works; official clients exist for Python (`apify-client`) and JavaScript (`apify-client`).

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

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('magenta_courser/kakaomap-reviews-scraper').call({
    places: ['https://place.map.kakao.com/10735673'],
    maxReviewsPerPlace: 100,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
const reviews = items.filter((r) => r.type === 'review');
console.log(reviews.filter((r) => r.rating <= 2).length, 'of', reviews.length, 'reviews have 1 or 2 stars');
```

### FAQ

**Do I need a Kakao account or a Kakao API key?**
No. The Actor reads the public review tab of a place without logging in.

**Can I get the reviewer's name or profile?**
No, by design. Nickname, user ID, profile image, follower and review counts and level badge are in Kakao's response but are never read. Review text is written by users and may contain details they chose to share.

**Does it return the owner's reply?**
No. Only `isOwnerPick` (the owner pinned the review) is returned.

**How many reviews can it collect from one place?**
`maxReviewsPerPlace` accepts up to 100,000 and the Actor pages until Kakao reports no more reviews. In our runs it reached the end of the list for places with 57, 96 and 193 reviews, and the largest single-place collection so far was 200 reviews (run `QXp5uTZmN8yroeZaE`, 2026-11-11). Larger places have not been measured yet.

**How fast is it?**
Kakao returns 20 reviews per request and the Actor waits 0.25 to 0.6 seconds between requests, one place at a time. Measured: 57 reviews in 9.1 seconds including start-up (run `ulWecDgOe2w9kGSq7`).

**What happens when Kakao blocks or rejects a request?**
A failed request is tried up to 6 times in total, each time on a new proxy session, with a pause that doubles from 2 to 32 seconds. If a place's first page cannot be fetched, the place is marked `failed` with `stopReason: requestFailed`; if a later page fails you keep the reviews already saved (`status: partial`). The default datacenter proxy was enough in our runs.

**What happens with a wrong place ID?**
A place that does not exist is reported as `status: "failed"`, `stopReason: "placeNotFound"` with a message in `errorMessage`, is not retried and is not charged. The other places in the run are still scraped.

**Why did I get a review I already have?**
With `sort: "latest"` Kakao orders by last update, so a review edited after your last run comes back with the same `reviewId` and `isEdited: true`. De-duplicate on `reviewId`.

**Are short `kko.to` links supported?**
No. Open the link in a browser and use the `place.map.kakao.com/<id>` URL or the numeric ID.

**Is it legal to scrape Kakao Map reviews?**
The Actor collects only publicly visible review content and reads no reviewer personal data. It is unofficial and not affiliated with Kakao. Whether your use is allowed depends on Kakao's terms of service, your purpose and your local law; checking that is your responsibility.

**카카오맵 리뷰를 엑셀로 받을 수 있나요?**
네. 실행이 끝나면 데이터셋을 JSON·CSV·Excel로 내려받을 수 있습니다. 리뷰 행만 필요하면 `type`이 `review`인 행을 거르거나 `includePlaceSummary`를 `false`로 두면 됩니다.

### More Korean data Actors

[![Naver Map Reviews Scraper: $0.50 per 1,000 Naver Map reviews](https://raw.githubusercontent.com/experimory-crypto/naver-map-scraper-examples/main/assets/hero-naver-place-reviews-scraper.png)](https://apify.com/magenta_courser/naver-place-reviews-scraper)

[![Naver Shopping Rank Tracker: top 1,000 ranks for any keyword](https://raw.githubusercontent.com/experimory-crypto/naver-map-scraper-examples/main/assets/hero-naver-shopping-rank-tracker.png)](https://apify.com/magenta_courser/naver-shopping-rank-tracker)

| Actor | What you put in → what you get |
|---|---|
| [Kakao Map Scraper](https://apify.com/magenta_courser/kakaomap-place-search-scraper) | Keyword → Kakao Map businesses with address, phone, coordinates and rating. Use its `id` as `places` here. |
| [Naver Map Reviews Scraper](https://apify.com/magenta_courser/naver-place-reviews-scraper) | Naver Place IDs → visitor reviews, same row style, no reviewer personal data. |
| [Naver Map Scraper](https://apify.com/magenta_courser/naver-place-search-scraper) | Keyword → businesses with address, phone, coordinates, rating, review counts. |
| [Naver Place Multi-Location Review Monitor](https://apify.com/magenta_courser/multi-location-review-monitor) | Your locations → new reviews, owner replies added or edited, unanswered counts per location. |
| [Naver Place Rank Tracker](https://apify.com/magenta_courser/naver-place-rank-tracker) | Keywords + your place IDs → your rank in Naver Map search, with change since the last run. |
| [Naver Blog, Cafe & News Search Scraper](https://apify.com/magenta_courser/naver-blog-cafe-search-scraper) | Keywords → blog, cafe and news search results with title, URL, snippet and publish time. |
| [Naver AI Briefing Scraper](https://apify.com/magenta_courser/naver-ai-briefing-scraper) | Search queries → Naver's AI answer, its cited sources, and whether your domain is cited. |
| [Naver Shopping Scraper & Keyword Rank Tracker](https://apify.com/magenta_courser/naver-shopping-rank-tracker) | Shopping keywords → ranked products with price, store, rating, reviews and stock. |
| [Korea MCP Server: Naver, Kakao Map](https://apify.com/magenta_courser/korea-local-data-mcp) | An MCP server with Naver Map search, Naver Place reviews and Kakao Map search as tools. |

Code examples for these Actors: [github.com/experimory-crypto/naver-map-scraper-examples](https://github.com/experimory-crypto/naver-map-scraper-examples).

### 한국어 안내 (Korean)

카카오맵 장소 ID나 장소 URL을 넣으면 해당 장소의 방문자 리뷰가 한 건당 한 행으로 나옵니다. 별점, 리뷰 본문, 작성 시각과 마지막 수정 시각(ISO), 수정 여부, 리뷰어가 고른 키워드 태그(한국어와 영어 코드: 맛·가성비·친절·분위기·주차), 사진 URL, 좋아요 수, 사장님 추천(고정) 여부가 들어 있고, 장소별로 평균 별점·전체 리뷰 수·키워드 투표를 담은 요약 행이 무료로 붙습니다. 요금은 리뷰 행 1건당 $0.0005(1,000건 약 $0.50)이고 실행 1회당 시작 요금 $0.00005가 붙습니다. 정렬은 최신순(작성·수정 기준)과 추천순 두 가지이며, `reviewsNewerThan`에 날짜를 넣으면 그 날짜 이후에 작성되거나 수정된 리뷰만 받고 더 오래된 리뷰에서 수집을 멈춥니다. 지난 실행을 기억하는 기능은 없으므로 날짜는 직접 넘겨야 하고, 수정된 리뷰는 같은 `reviewId`로 다시 나옵니다. 사장님 답글, 장소 주소·전화번호·카테고리는 제공하지 않으며 `kko.to` 단축 링크는 지원하지 않습니다. 리뷰어 닉네임·프로필·사용자 ID 등 작성자 정보는 수집하지 않고, 로그인 없이 공개 데이터만 읽습니다.

### 中文说明 (Chinese)

输入 Kakao 地图（카카오맵）的地点 ID 或地点 URL，即可获得该地点的到店评价，每条评价一行。包含星级、评价正文、发布时间和最后修改时间（ISO）、是否修改过、评价者选择的关键词标签（韩语和英文代码：味道、性价比、亲切、氛围、停车）、照片 URL、点赞数，以及是否被商家置顶推荐。每个地点还会免费附加一行汇总：平均星级、评价总数和关键词投票。费用为每行评价 $0.0005（1,000 条约 $0.50），每次运行另收 $0.00005 启动费。排序有最新（按发布或修改时间）和推荐两种；在 `reviewsNewerThan` 中填入日期后，只返回该日期之后发布或修改的评价，并在遇到更早的评价时停止翻页。本 Actor 不会记住上一次运行，日期需要自行传入；被修改过的评价会以相同的 `reviewId` 再次返回。不提供商家回复，也不提供地点的地址、电话和分类，不支持 `kko.to` 短链接。不采集评价者昵称、头像、用户 ID 等作者信息，无需登录，只读取公开数据。

### 日本語ガイド (Japanese)

カカオマップ（카카오맵）の場所 ID または場所 URL を入力すると、その店舗の訪問者レビューが 1 件 1 行で出力されます。星評価、レビュー本文、投稿日時と最終編集日時（ISO）、編集の有無、レビュアーが選んだキーワードタグ（韓国語と英語コード：味・コスパ・親切・雰囲気・駐車）、写真 URL、いいね数、オーナーによるピン留めの有無が含まれます。店舗ごとに、平均評価、レビュー総数、キーワード投票をまとめた行が無料で付きます。料金はレビュー 1 行あたり $0.0005（1,000 件で約 $0.50）で、実行 1 回ごとに開始料金 $0.00005 がかかります。並び順は最新順（投稿・編集基準）とおすすめ順の 2 種類です。`reviewsNewerThan` に日付を指定すると、その日以降に投稿または編集されたレビューだけを取得し、それより古いレビューに達した時点でページ送りを止めます。前回の実行を記憶する機能はないため日付は自分で渡す必要があり、編集されたレビューは同じ `reviewId` で再び返されます。オーナー返信、店舗の住所・電話番号・カテゴリは提供せず、`kko.to` の短縮リンクには対応していません。レビュアーのニックネーム、プロフィール、ユーザー ID などの投稿者情報は収集せず、ログインなしで公開データのみを読み取ります。

### Notes

- `createdAt`, `updatedAt` and `scrapedAt` are UTC ISO timestamps. Kakao sends Korea time (KST) without an offset; the Actor converts it. `reviewsNewerThan` is read as 00:00 KST.
- `placeName` is taken from the first review Kakao returns, so it is `null` for a place with no reviews and for a place that was not found.
- `avgRating` and `placeRating` are `null` when a place has no reviews (Kakao shows 0 there).
- `placeRating`, `placeReviewCount` and the summary statistics are the place's totals at scrape time, not statistics over the rows saved in the run.
- A keyword tag ID the Actor does not know yet is returned as `id<number>` in `keywordCodes` rather than dropped.
- Input lines without a recognisable place ID are skipped with a log warning and listed in `RUN_SUMMARY` with `stopReason: "invalidInput"`.
- Tested on one restaurant and three cafes (5 runs on 2026-11-11). Other business categories have not been checked separately.
- This Actor is unofficial and is not affiliated with Kakao.

### Support

Missing a field, another input mode, a different output format? Tell us in the **Issues** tab with the run ID. We answer every issue.

# Actor input Schema

## `places` (type: `array`):

Kakao Map place IDs or place URLs, one per line. Accepted formats: a numeric ID such as 10735673; https://place.map.kakao.com/10735673; https://place.map.kakao.com/m/10735673; https://map.kakao.com/?itemId=10735673. The "id" field from Kakao Map Place Search Scraper works directly. Short kko.to links are not supported.

## `maxReviewsPerPlace` (type: `integer`):

Maximum number of reviews to save for each place. Integer from 1 to 100000. Default 100. Kakao Map has no depth limit, so a large value such as 100000 returns every review the place has; you pay only for reviews saved.

## `sort` (type: `string`):

"latest" (default) = most recently written or edited first (Kakao orders by last update). "recommended" = Kakao Map's own default order. When the date filter below is set, "latest" is always used.

## `reviewsNewerThan` (type: `string`):

Optional date in YYYY-MM-DD format, e.g. 2026-09-01, read as 00:00 Korea time (KST, UTC+9). Only reviews written or last edited (updatedAt) on or after this date are saved. Kakao lists reviews by last update, so paging stops at the first older review and scheduled runs stay cheap. Leave empty for no date filter.

## `onlyPhotoReviews` (type: `boolean`):

true or false. Default false. true = return only reviews that have at least one photo.

## `includePlaceSummary` (type: `boolean`):

true or false. Default true. Adds free (not charged) rows: one "placeSummary" row per place (status, stopReason, reviewsSaved, average rating, total review count, keyword votes) and one "runSummary" row per run. Filter rows by the "type" field. The same status is always saved in the run's key-value store as RUN_SUMMARY.

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

Proxy settings. Keep the default Apify Proxy (datacenter); Kakao Map may reject repeated requests from one IP.

## Actor input object example

```json
{
  "places": [
    "10735673"
  ],
  "maxReviewsPerPlace": 100,
  "sort": "latest",
  "onlyPhotoReviews": false,
  "includePlaceSummary": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `reviews` (type: `string`):

All scraped reviews and place summary rows as dataset items.

## `runSummary` (type: `string`):

Per-place status, stop reason and saved count. Not billed.

# 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 = {
    "places": [
        "10735673"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("magenta_courser/kakaomap-reviews-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 = {
    "places": ["10735673"],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("magenta_courser/kakaomap-reviews-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "places": [
    "10735673"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call magenta_courser/kakaomap-reviews-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,magenta_courser/kakaomap-reviews-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/2U7Y3bEdLw8F7IkdP/builds/xtnafbJFAWFy6GT6R/openapi.json
