Kakao Map Place Autocomplete

Get the live keyword suggestions shown by the Kakao Map web search box.

What does this Actor do?

Enter a Korean place or local-search phrase. The Actor calls Kakao Map's dedicated web autocomplete service and returns up to 20 ranked suggestions. It does not run a place-results search and does not duplicate the paginated Kakao Map Search Actor.

What data does it return?

• Suggested keyword and rank
• Kakao suggestion category and relevance score
• Highlight ranges used by the Kakao Map interface
• Kakao's normalized query
• Explicit source and fallback markers

Autocomplete suggestions are keywords, not resolved places. They do not include place IDs, addresses, coordinates, ratings, or review counts. Use Kakao Map Search or Place Detail when those fields are required.

Input

{
  "query": "강남역 "
}

Field	Required	Default	Description
query	Yes	-	Autocomplete query, up to 100 characters.
failOnError	No	true	Fail the run when Kakao Map returns an HTTP, JSON, or schema error. Set false only to store an error row.

Output example

{
  "rank": 2,
  "keyword": "강남역 맛집",
  "category": "place",
  "score": 198.2493,
  "highlighted": [[0.0, 3.0]],
  "rawItem": "강남역 맛집|place",
  "query": "강남역",
  "responseQuery": "강남역",
  "normalizedQuery": "강남역",
  "count": 20,
  "source": "kakaomap_suggest_hub",
  "fallbackApplied": false,
  "success": true,
  "httpStatus": 200
}

Reliability and network

• Source: the single autocomplete endpoint used by the Kakao Map web search box
• Proxy: Apify Residential proxy fixed to South Korea
• Retry: one bounded retry only for network errors, HTTP 429, or HTTP 5xx
• Fallback: none; invalid JSON or an unexpected response schema fails the run

Pricing and limits

• Price: $0.0015 per query
• Billing event: one successful autocomplete query
• Maximum: up to 20 suggestions returned by Kakao Map
• Actor compute and the KR Residential proxy are included in the event price.

Troubleshooting

• No suggestions can be a valid result for a query Kakao Map does not recognize.
• An HTTP or schema error fails by default instead of returning a fabricated empty result.

Disclaimer

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