/kakaomap/places

POST /api/kakaomap/places

Price: 5 credits

Get a Kakao Map (카카오맵) place by id or URL: category, address, coordinates, phone, opening hours, rating with review and photo counts, menu with prices, delivery menu, facilities, parking, AI summary and keywords, trend rank and nearest subway station

How to use it

Place ids come from kakaomap/places/search. Reviews, blog reviews and photos are paged by kakaomap/places/reviews, kakaomap/places/blog_reviews and kakaomap/places/photos. Money is in KRW.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• place string required — Kakao Map place id or place URL (examples: "1238400864", "https://place.map.kakao.com/1238400864"; minLength: 1)

Response

• @type string (default: "KakaomapPlace")
• id string required
• url string required
• name string nullable
• branch string nullable
• category string nullable
• category_path array (default: [])
• category_ids array (default: [])
• address string nullable
• road_address string nullable
• jibun_address string nullable
• address_detail string nullable
• zipcode string nullable
• regions array (default: [])
• latitude number nullable
• longitude number nullable
• phones array (default: [])
• homepages array (default: [])
• main_photo string nullable
• open_status string nullable
• open_status_detail string nullable
• opening_hours array (default: [])
  • @type string (default: "KakaomapOpeningDay")
  • day string nullable
  • hours string nullable
  • last_order array (default: [])
  • break_times array (default: [])
  • off_note string nullable
  • is_today boolean nullable
• rating number nullable
• review_count integer nullable
• review_photo_count integer nullable
• strengths array (default: [])
  • @type string (default: "KakaomapStrength")
  • name string nullable
  • count integer nullable
• blog_review_count integer nullable
• photo_count integer nullable
• menu array (default: [])
  • @type string (default: "KakaomapMenuItem")
  • id string nullable
  • name string nullable
  • price number nullable
  • price_text string nullable
  • discounted_price number nullable
  • description string nullable
  • image string nullable
  • is_recommended boolean nullable
  • recommend_reasons array (default: [])
  • is_sold_out boolean nullable
  • order_url string nullable
  • updated_at integer nullable
• menu_updated_at integer nullable
• delivery_menu array (default: [])
  • @type string (default: "KakaomapMenuItem")
  • id string nullable
  • name string nullable
  • price number nullable
  • price_text string nullable
  • discounted_price number nullable
  • description string nullable
  • image string nullable
  • is_recommended boolean nullable
  • recommend_reasons array (default: [])
  • is_sold_out boolean nullable
  • order_url string nullable
  • updated_at integer nullable
• delivery_url string nullable
• tags array (default: [])
• facilities array (default: [])
• parking string nullable
• has_parking boolean nullable
• allows_pets boolean nullable
• is_wheelchair_accessible boolean nullable
• payments array (default: [])
• ai_title string nullable
• ai_summary array (default: [])
• ai_keywords array (default: [])
  • @type string (default: "KakaomapKeywordGroup")
  • keywords array (default: [])
• price_level string nullable
• mentioned_channels array (default: [])
• trend_rank_label string nullable
• trend_rank integer nullable
• awards array (default: [])
• certifications array (default: [])
• nearest_station string nullable
• station_exit string nullable
• station_walk_minutes integer nullable
• station_distance_m integer nullable
• benefits array (default: [])
• opening_note string nullable
• days_off_note string nullable
• peak_visitors integer nullable
• visitors array (default: [])
  • @type string (default: "KakaomapVisitorDay")
  • day string required
  • hourly array (default: [])
• visitors_updated_at integer nullable
• fuel_prices array (default: [])
  • @type string (default: "KakaomapFuelPrice")
  • fuel string required
  • price number nullable
  • average_price number nullable
  • updated_at integer nullable
• medical object nullable
  • @type string (default: "KakaomapMedical")
  • center_type string nullable
  • emergency_type string nullable
  • specialized_field string nullable
  • has_emergency_room boolean nullable
  • departments array (default: [])
  • opening_hours array (default: [])
    • @type string (default: "KakaomapLabeledText")
    • text string nullable
  • established_at integer nullable
  • doctor_count integer nullable
  • specialist_count integer nullable
  • resident_count integer nullable
  • intern_count integer nullable
  • general_practitioner_count integer nullable
  • department_doctors array (default: [])
    • @type string (default: "KakaomapNamedCount")
    • name string nullable
    • count integer nullable
  • devices array (default: [])
    • @type string (default: "KakaomapNamedCount")
    • name string nullable
    • count integer nullable
  • good_evaluations array (default: [])
• parking_lot object nullable
  • @type string (default: "KakaomapParkingLot")
  • spots integer nullable
  • operation_types array (default: [])
  • pay_types array (default: [])
  • business_hours array (default: [])
    • @type string (default: "KakaomapParkingHours")
    • days array (default: [])
    • start_time string nullable
    • end_time string nullable
  • prices array (default: [])
    • @type string (default: "KakaomapParkingPrice")
    • days array (default: [])
    • base_price number nullable
    • base_minutes integer nullable
    • unit_price number nullable
    • unit_minutes integer nullable
    • max_day_price number nullable
    • max_day_type string nullable
    • is_today boolean nullable
• rooms array (default: [])
  • @type string (default: "KakaomapRoom")
  • id string nullable
  • name string nullable
  • description string nullable
  • area_m2 integer nullable
  • area_pyeong integer nullable
  • room_types array (default: [])
  • views array (default: [])
  • amenities array (default: [])
  • standard_occupancy integer nullable
  • max_occupancy integer nullable
  • room_count integer nullable
  • bedroom_count integer nullable
  • living_room_count integer nullable
  • kitchen_count integer nullable
  • bathroom_count integer nullable
  • beds array (default: [])
    • @type string (default: "KakaomapNamedCount")
    • name string nullable
    • count integer nullable
  • images array (default: [])
  • plan_name string nullable
  • plan_description string nullable
  • price number nullable
  • sale_status string nullable
  • checkin_time string nullable
  • checkout_time string nullable
  • is_cancellable boolean nullable
  • cancellation_rules array (default: [])
    • @type string (default: "KakaomapCancelRule")
    • days_before integer nullable
    • penalty_percent integer nullable
  • included_meals array (default: [])
  • booking_url string nullable
• tickets array (default: [])
  • @type string (default: "KakaomapTicket")
  • id string nullable
  • name string nullable
  • price number nullable
  • original_price number nullable
  • discount_rate integer nullable
  • usable_age integer nullable
  • image string nullable
  • sale_status string nullable
  • booking_url string nullable
• booking_url string nullable
• notices array (default: [])
  • @type string (default: "KakaomapNotice")
  • text string nullable
  • source_name string nullable
  • source_url string nullable
• convenience_store_brand string nullable
• store_services array (default: [])
• kakao_channel object nullable
  • @type string (default: "KakaomapChannel")
  • id string nullable
  • name string nullable
  • url string nullable
  • image string nullable
  • friend_count integer nullable
  • status_message string nullable
• ev_station object nullable
  • @type string (default: "KakaomapEvStation")
  • operator string nullable
  • business_hours string nullable
  • is_paid boolean nullable
  • access string nullable
  • site_type string nullable
  • address_detail string nullable
  • has_free_parking boolean nullable
  • charger_count integer nullable
  • available_charger_count integer nullable
  • chargers array (default: [])
    • @type string (default: "KakaomapEvCharger")
    • id string nullable
    • type_code string nullable
    • speed string nullable
    • power_kw number nullable
    • status string nullable
    • status_type string nullable
    • status_updated_at integer nullable
    • last_used_at integer nullable
  • updated_at integer nullable
• course object nullable
  • @type string (default: "KakaomapCourse")
  • length string nullable
  • duration string nullable
  • difficulty string nullable
  • start string nullable
  • end string nullable
  • source_name string nullable
  • source_url string nullable
  • stops array (default: [])
    • @type string (default: "KakaomapCourseStop")
    • place_id string nullable
    • name string nullable
    • distance_m number nullable
• owner_intro string nullable
• owner_notices array (default: [])
  • @type string (default: "KakaomapOwnerNotice")
  • id string nullable
  • news_type string nullable
  • text string nullable
  • images array (default: [])
• schedule_notes array (default: [])
• holiday_closures string nullable
• holiday_hours string nullable
• current_off_day string nullable
• upcoming_off_days string nullable
• indoor_floor string nullable
• has_kids_zone boolean nullable
• has_smoking_room boolean nullable
• updated_at integer nullable

Errors

• 422 — The request body did not validate Check the fields against this schema. A URN with the wrong prefix is the most common cause.
• 408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.
• 412 — Kakao Map has no place under that id Retrying will not help: either the entity does not exist, or the input points at a different one.
• 429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.
• 500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.
• 529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.

Response headers

• X-Error — Error message text (present only on error)
• X-Request-ID — Unique request identifier
• X-Execution-Time — Execution time in seconds
• X-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.
• X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.
• X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.
• X-Retry-After — Seconds to wait before retrying. Present only on 429.