Kakao Map (카카오맵) Place & Review Scraper

A Lantern Lab Actor for Korean local data. Search Kakao Map by keyword — 강남 카페, 부산 해운대 호텔 — or paste place links, and get the public place record back: place id, name, category, display / road-name / lot-number address, the business phone shown on the page, WGS84 coordinates, the Kakao Map star rating and review count, and the place page URL. With reviews on, every place also brings its public Kakao Map reviews: rating, text and publish time. No Kakao login, no cookies, no account of your own.

Price: USD 0.79 per 1,000 rows. No run-start fee. One price per row, the same for a place row and a review row. Status rows, empty results and the run summary are free.

What it does

• Searches each term separately and labels every row with the term that produced it, so one run can cover many keywords and regions.
• Takes place links as well: https://place.map.kakao.com/15376650, https://map.kakao.com/?itemId=15376650, or the bare place id. Links and keywords can be mixed in one run.
• Returns WGS84 lat / lng and the road-name address, which the Kakao Map search list does not carry — each place is read from the place page's own data.
• Collects the public Kakao Map reviews per place, newest first, paged to the limit you set.
• Deduplicates across the whole run: a place or a review reached by two of your keywords is written once and charged once.
• Keeps the source identifier (placeId, reviewId), the parent relation (placeId on every review), the platform's own time (publishedAt, plus publishedAtRaw exactly as Kakao sent it) and our collection time (collectedAt) as separate fields.
• Says what happened per keyword and per place. A keyword Kakao Map answered with nothing is recorded as an empty result; anything cut short by a limit, a refusal or a dead link is marked partial: true with the reason. The two are different records and are never confused.
• Writes null, never a guess, for a field Kakao Map did not provide. A place with no review yet has rating: null and reviewCount: null, not 0.
• Caps itself: maxUpstreamRequests is a hard ceiling on requests to Kakao Map for the whole run, derived from your input when you leave it empty, so a run is never unbounded.

What it does not do

• No login-only, private or age-restricted data; public place pages only.
• No reviewer identity: a review's nickname, profile image and account id are not collected.
• No blog reviews, photos, menus, opening hours or visitor-footfall charts — blogReviewCount is reported, the blog posts themselves are not collected.
• No Naver Map, Google Maps or other map platform.
• No scheduling or monitoring built in; use Apify schedules.

Input

Field	Default	Meaning
searchQueries	—	One Kakao Map search term per line, as you would type it on the Korean map. Korean terms return the most places.
placeUrls	—	Kakao Map place links or bare place ids, one per line. At least one of searchQueries / placeUrls is required.
maxPlacesPerQuery	20	Upper bound on places per search term. Kakao Map serves 15 per result page.
includeReviews	true	Also collect each place's public Kakao Map reviews as separate rows.
maxReviewsPerPlace	20	Upper bound on reviews per place, newest first. Kakao Map serves 20 per page. 0 collects none.
maxUpstreamRequests	derived	Hard ceiling on requests to Kakao Map for the whole run. Leave empty and the Actor works one out from your input.
proxyConfiguration	Apify Proxy	The proxy the requests go through. The datacenter default is what this Actor is measured on.

{
  "searchQueries": ["강남 카페", "부산 해운대 호텔"],
  "placeUrls": ["https://place.map.kakao.com/15376650"],
  "maxPlacesPerQuery": 20,
  "includeReviews": true,
  "maxReviewsPerPlace": 20
}

Output

Four row kinds, told apart by recordType. place and review rows are charged; query_status, place_status and the final RUN_SUMMARY are free.

A place row:

{
  "recordType": "place",
  "placeId": "15376650",
  "name": "스타벅스 본사",
  "url": "https://place.map.kakao.com/15376650",
  "category": "기업",
  "categoryGroup": "서비스,산업",
  "address": "서울 강남구 테헤란로 231 센터필드 EAST 20-22층 (역삼동)",
  "roadAddress": "서울 강남구 테헤란로 231 센터필드 EAST 20-22층",
  "jibunAddress": "역삼동 676",
  "postalCode": "06142",
  "phone": "1522-3232",
  "lat": 37.50365329924952,
  "lng": 127.04146067429498,
  "rating": 1.8,
  "reviewCount": 126,
  "blogReviewCount": 87,
  "homepageUrl": "https://www.istarbucks.co.kr",
  "source": "search",
  "query": "강남 카페",
  "rank": 1,
  "partial": false,
  "partialReason": null,
  "collectedAt": "2026-10-24T00:00:00.000Z"
}

A review row:

{
  "recordType": "review",
  "reviewId": "15680924",
  "placeId": "15376650",
  "placeName": "스타벅스 본사",
  "placeUrl": "https://place.map.kakao.com/15376650",
  "rating": 5,
  "text": "…",
  "photoCount": 0,
  "likeCount": 6,
  "publishedAt": "2026-06-08T13:17:25.000Z",
  "publishedAtRaw": "2026-06-08 22:17:25",
  "partial": false,
  "partialReason": null,
  "collectedAt": "2026-10-24T00:00:00.000Z"
}

A free status row, for a search term that Kakao Map answered with nothing:

{
  "recordType": "query_status",
  "query": "없는가게999",
  "placesReturned": 0,
  "placesAvailable": 0,
  "searchEndReached": true,
  "partial": false,
  "partialReason": null,
  "statusText": "Kakao Map returned no place for this search term. This is an empty result, not a failed one."
}

partialReason is one of upstream_request_cap, charge_limit_reached, blocked, upstream_error, place_not_found or not_collected.

Limits

• Kakao Map serves 15 places per search page and 20 reviews per page. maxPlacesPerQuery and maxReviewsPerPlace are rounded up to whole pages' worth of requests.
• A keyword's result list is as deep as Kakao Map makes it. A term whose list ends sooner than your limit returns fewer places and reports searchEndReached: true.
• Reviews are the Kakao Map reviews of the place, newest first. Blog reviews are counted but not collected.
• rating and reviewCount are null for a place with no Kakao Map review yet.
• Kakao Map times are Korean standard time (UTC+9). publishedAt is the UTC instant; publishedAtRaw is Kakao's own string.
• phone is the business number published on the place page. Places with no published number have phone: null.
• Korean-language keywords return far more places than Latin-script ones for the same business.
• A dead or removed place link is reported on a free place_status row with partialReason: place_not_found; it is never reported as a place with empty fields.