Kakao Map Scraper

Extract place details, reviews, photos, and contact information from Kakao Map — South Korea's most popular mapping service alongside Naver Map.

Search by keywords or provide direct place URLs to collect structured JSON data from Kakao Map listings.

Need Naver Map data too? Use both scrapers together for complete coverage of South Korean local business data.

---

Features

• Keyword Search — Bulk-collect places by keywords like "강남 맛집" (Gangnam restaurants) or "홍대 카페" (Hongdae cafés)
• Direct URL Input — Provide https://place.map.kakao.com/{placeId} URLs for targeted scraping
• Place Details — Name, category, address (legacy & road), phone, website, coordinates
• Ratings & Review Stats — Average rating, total review count, blog review count
• Review Collection (optional) — Review text, rating, author, date, photo URLs
• Photo Collection (optional) — Featured photo URLs from the place listing
• Keyword & Facility Tags — Extracted from search metadata (parking, WiFi, delivery, etc.)
• Anti-blocking — User-Agent rotation, request jitter, Apify Proxy support

---

Input Parameters

Parameter	Type	Default	Description
searchKeywords	string[]	["강남 맛집"]	List of search keywords
startUrls	object[]	—	Direct Kakao Map place URLs
maxResultsPerKeyword	integer	5	Max places to collect per keyword (1–10,000)
includeReviews	boolean	false	Whether to collect reviews (adds $0.001/page)
maxReviewPages	integer	50	Max review pages per place (~10–20 reviews/page, 0 = unlimited)
includePhotos	boolean	false	Include featured photo URLs
searchLocation	object	—	Search center coordinates { latitude, longitude } (with API key only)
searchRadius	integer	5000	Search radius in meters (100–20,000)
kakaoRestApiKey	string	—	Kakao REST API key (optional, falls back to web search)
proxyConfiguration	object	{useApifyProxy: true}	Proxy settings

At least one of searchKeywords or startUrls is required.

---

Output Data

Successful result

{
    "placeId": "26338954",
    "placeName": "Starbucks Gangnam-daero",
    "category": "Restaurant > Cafe > Coffee Shop",
    "address": "1305-7 Seocho-dong, Seocho-gu, Seoul",
    "roadAddress": "399 Gangnam-daero, Seocho-gu, Seoul",
    "phone": "1522-3232",
    "website": "https://www.starbucks.co.kr",
    "latitude": 37.4967,
    "longitude": 127.0276,
    "placeUrl": "https://place.map.kakao.com/26338954",
    "rating": 3.8,
    "reviewCount": 152,
    "blogReviewCount": 87,
    "openingHours": null,
    "openNow": null,
    "facilities": ["Parking", "WiFi"],
    "keywords": ["Coffee", "Dessert"],
    "menu": null,
    "photos": ["https://img1.kakaocdn.net/..."],
    "reviews": [
        {
            "reviewText": "Great coffee!",
            "rating": 5,
            "reviewerName": "KakaoUser",
            "reviewDate": "2025-03-15",
            "photos": []
        }
    ],
    "scrapedAt": "2025-06-01T12:00:00.000Z"
}

Failed result

{
    "placeId": "12345678",
    "error": "Failed to fetch detail"
}

---

Pricing

This Actor uses a Pay-Per-Event (PPE) pricing model. No subscriptions — you only pay for what you use.

Event	Price	Per 1,000
place-scraped	$0.003	$3.00
review-page	$0.001	$1.00

Cost Examples

Scenario	Estimated Cost
100 places (no reviews)	~$0.30
1,000 places (no reviews)	~$3.00
100 places + reviews (avg 5 pages/place)	~$0.80
1,000 places + reviews (avg 5 pages/place)	~$8.00

With Apify's free tier ($5/month credit), you can scrape approximately 1,600 places.

---

Usage Tips

Kakao REST API Key (Optional)

For better keyword search quality and speed, get a REST API key from Kakao Developers and enter it in the input. The scraper works without a key by falling back to the web search endpoint.

Proxy Settings

Apify Proxy (useApifyProxy: true) is enabled by default. Using a proxy is strongly recommended, especially for review collection.

Review Collection

Reviews are collected using a real Chromium browser (Playwright). The Actor navigates to the Kakao Map place page, clicks the review tab, and extracts review data directly from the rendered DOM. This bypasses the anti-bot protections on place-api.map.kakao.com that block all HTTP-based approaches.

When includeReviews is enabled, the Actor:

1. Launches a headless Chromium browser for each place
2. Navigates to the place page and waits for full render
3. Clicks the review tab and loads additional pages via "more" button
4. Extracts review text, rating, author, date, and photos from the DOM

Note: Review collection uses more memory and compute time than place-only scraping. Apify allocates sufficient memory automatically.

---

Local Development

cd kakao-map-scraper
npm install
echo '{"searchKeywords":["강남 맛집"],"maxResultsPerKeyword":3}' > INPUT.json
APIFY_TOKEN=your_token npm run start:dev

---

Limitations

• Business hours — Not available from the public API; returned as null
• Menu — Not available from the public API; returned as null (planned for future update)
• Reviews — Requires headless browser (Playwright); slower than HTTP-only scraping but reliable

---

Changelog

v1.0

• Initial public release
• PPE pricing model (place-scraped, review-page)
• Keyword search (Kakao Local API / web mapsearch fallback)
• Place details, reviews, and photo collection
• Spending limit / review charge limit support
• Error rows on individual place failures (no full run abort)