Kakao Map Scraper — Korea Businesses & Reviews

Free plan limit: Free-plan users can receive up to 5 result records per run. Paid-plan and local/unknown runs retain the Actor's existing limits.

Scrape publicly visible Korean local businesses and Kakao Map visit reviews into structured records for lead research, market mapping, venue analysis, and location intelligence.

What the Kakao Map Scraper extracts

Each default-dataset item represents one canonical Kakao Map place. Redirected legacy place URLs are resolved to the current place ID, and duplicate canonical places are delivered only once.

Field	Description
placeId	Canonical Kakao Map place identifier after redirects
name, category	Public business name and Kakao category
address, phone, website	Public contact and location details when listed
rating	Public Kakao visit-review rating when available
reviewCount, blogReviewCount	Public visit-review and blog-review totals
openingHoursText	Current visible opening-status text
placeUrl	Canonical place.map.kakao.com URL
searchQuery	Discovery query that produced the business, or null for a direct URL
reviews	Bounded list of public visit reviews, optionally empty
scrapedAt	ISO timestamp for the extraction

Each review contains the public author display name, rating, date, text, like count, and a hasPhotos flag. Nullable fields remain present as null, giving API and agent consumers a stable output shape.

When to use it

Use keyword discovery to find venues by service and location, such as 서울 카페, 부산 피부과, or Jeju hotel. Use direct URLs when you already have exact Kakao place pages and need normalized business details or reviews. Typical uses include building Korean local-business lead lists, comparing venue reputation, monitoring public ratings, and enriching a place database with Kakao contact data.

This Actor does not access Kakao accounts, login-only content, reviewer profiles, private data, menu catalogs, photos, or full historical review pagination. maxReviewsPerBusiness limits the reviews currently rendered by Kakao; it is not a promise that every historical review will be returned.

Input

Input	Type	Default	Purpose
searchQueries	string array	["서울 카페"]	Discover places by Korean or English keyword
startUrls	request list	empty	Scrape exact https://place.map.kakao.com/PLACE_ID pages
maxResults	integer, 1–100	10	Cap businesses across all inputs
includeReviews	boolean	true	Include public visit reviews
maxReviewsPerBusiness	integer, 0–30	10	Cap visible reviews per business
proxyConfiguration	object	no proxy	Enable Apify Proxy if Kakao blocks the normal route

If startUrls is non-empty, direct-place mode takes precedence over the default search query. Invalid direct URLs are rejected with an actionable SUMMARY instead of silently falling back to a different search.

Keyword example:

{
  "searchQueries": ["서울 카페"],
  "maxResults": 3,
  "includeReviews": true,
  "maxReviewsPerBusiness": 5,
  "proxyConfiguration": { "useApifyProxy": false }
}

Direct URL example:

{
  "searchQueries": [],
  "startUrls": [{ "url": "https://place.map.kakao.com/1594748709" }],
  "maxResults": 1,
  "includeReviews": false
}

Run it through the API with POST /v2/acts/muhammadafzal~kakao-map-scraper/runs and the same JSON body. Results are available from the run’s default dataset; diagnostics are available from the SUMMARY record in its default key-value store.

Example output

{
  "placeId": "1594748709",
  "name": "쎈느",
  "category": "카페",
  "address": "서울 성동구 연무장5길 20 1층 (우)04782",
  "phone": "02-468-2122",
  "website": "https://sceneseoul.com",
  "rating": 3.8,
  "reviewCount": 132,
  "blogReviewCount": 160,
  "openingHoursText": "영업 중 22:00 까지",
  "placeUrl": "https://place.map.kakao.com/1594748709",
  "searchQuery": null,
  "reviews": [
    {
      "author": "J☆",
      "rating": 5,
      "date": "2024.05.27",
      "text": "즐겁게 즐기도록 잘 만들어놨어요",
      "likes": 0,
      "hasPhotos": true
    }
  ],
  "scrapedAt": "2026-09-03T08:48:49.286Z"
}

Public values can change between runs. Missing optional data is returned as null; reviews are [] when disabled or unavailable.

Pricing

This Actor uses pay-per-event pricing. These are the current Apify Store event prices:

Event	Price (USD)	When it is charged
apify-actor-start	$0.001	Actor Start — Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event). — Charged once per run.
apify-default-dataset-item	$0.01	Business record — One schema-valid Kakao Map business record written to the default dataset.

Apify platform usage for this Actor run is included alongside the event prices above; no separate per-run platform-usage fee is passed to users.

This covers Apify platform usage for this Actor run. Other Apify products or usage outside this Actor run may still follow your account plan.

Reliability and diagnostics

The Actor uses a real browser, Korean language headers, conservative concurrency, and a low request rate. It first captures the home-page business details, then opens the review section only when needed. This prevents review navigation from discarding address, phone, website, rating, or count fields. Images, media, and fonts are blocked to reduce bandwidth without removing textual data.

Every completed crawl writes SUMMARY with one of these outcomes:

• DATA: one or more businesses were delivered.
• EMPTY: the valid search returned no public places.
• BLOCKED_OR_FAILED: Kakao blocked or failed every requested place; warnings identify affected URLs.
• REJECTED: the input contained neither a usable query nor a valid Kakao place URL.

Kakao can change its rendered UI, redirect old place IDs, rate-limit traffic, or present a challenge page. Enable an Apify Proxy configuration if the normal route is blocked. The Actor preserves truthful partial results and never fabricates business records.

Responsible use

Collect only information Kakao exposes publicly. Follow Kakao’s terms, robots and access policies, applicable Korean privacy law, and your use case’s notice, consent, retention, and deletion obligations. Public reviewer display names may still be personal data: minimize collection, avoid sensitive profiling, and do not use this Actor to collect private, login-only, or sensitive information.

For reproducible support, include the failed run ID, non-secret input, build number, and SUMMARY warnings when reporting an issue.