Kakao Map Search Scraper

Fetch a selected Kakao Map result page by keyword, optionally anchored to a WGS84 map center.

What does this Actor do?

The Actor searches Kakao Map for a Korean keyword and returns the selected result page. When both x and y are provided, the center is applied to that page so generic queries return results ordered around that location.

The center anchors result ordering; it is not a radius or strict geographic boundary.

What data does it return?

• Rank, Kakao place ID, name, and category
• Lot and road addresses, phone, and coordinates
• Thumbnail, review count, rating count, and average rating
• Franchise, delivery, takeout, parking, reservation, Wi-Fi, and pet signals when present
• Applied WGS84 center and the WCONGNAMUL coordinates sent to Kakao Map

Input

{
  "query": "스타벅스",
  "x": 126.978,
  "y": 37.5665,
  "page": 2,
  "limit": 15,
  "sort": 0
}

Field	Required	Default	Description
query	Yes	-	Korean local-search query.
x	No	-	WGS84 longitude, from -180 to 180. Must be supplied together with y. Numeric strings remain accepted by the HTTP runtime for compatibility.
y	No	-	WGS84 latitude, from -90 to 90. Must be supplied together with x. Numeric strings remain accepted by the HTTP runtime for compatibility.
page	No	1	Kakao Map source page to fetch, from 1 to 10.
limit	No	15	Results returned from the selected source page, from 1 to 15.
sort	No	0	Kakao sort mode accepted by the search endpoint.
failOnError	No	true	Fail the run on an HTTP, JSON, response-schema, or coordinate error. Set false only to store an error row.

Center-coordinate contract

Kakao Map's public web client sends map centers to the search endpoint as center=<WCONGNAMUL x>,<WCONGNAMUL y>. This Actor accepts x/y as WGS84 longitude and latitude and reproduces the public web client's LatLng.toCoords() conversion locally.

• No Kakao REST API key or official DAPI request is used.
• Supplying only one coordinate fails instead of silently running an unanchored search.
• The converted center parameter is sent on the selected page.
• There is no coordinate-source or search-source fallback.

Output example

{
  "rank": 1,
  "placeId": "27557389",
  "name": "스타벅스 한국프레스센터점",
  "roadAddress": "서울 중구 세종대로 124",
  "reviewCount": 320,
  "ratingAverage": 4.1,
  "total": 30,
  "query": "스타벅스",
  "centerApplied": true,
  "inputX": 126.978,
  "inputY": 37.5665,
  "centerX": 495141,
  "centerY": 1129713,
  "inputCoordinateSystem": "WGS84",
  "centerCoordinateSystem": "WCONGNAMUL",
  "success": true,
  "httpStatus": 200
}

Reliability and network

• Source: Kakao Map's internal mapsearch/map.daum web endpoint
• Proxy: Apify Residential proxy fixed to South Korea
• Fallback: none; malformed JSON or a missing place array fails the run

Pricing and limits

• Price: $0.002 per fetched source page ($2 per 1,000 pages)
• Billing event: one successfully fetched Kakao Map result page
• Maximum: one selected page and 15 places per run
• Actor compute and the KR Residential proxy are included in the event price.
• A page can contain fewer than 15 places.

Troubleshooting

• No results: make the query more specific.
• Unexpected region: supply both WGS84 x (longitude) and y (latitude).
• Need one place's reviews and hours: use Kakao Map Place Detail.

Disclaimer

This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Kakao.