Yeogi Hotel Scraper (여기어때 호텔 스크래퍼)

Scrape detailed hotel and accommodation data from Yeogi.com (여기어때), South Korea's leading domestic accommodation booking platform.

This is the only Yeogi.com scraper on Apify Store, giving you access to Korea's domestic accommodation data not available through any other Actor.

What is Yeogi (여기어때)?

여기어때 is one of Korea's top accommodation platforms alongside Yanolja, offering hotels, motels, pensions, resorts, guesthouses, and more across the country. It holds a large share of Korea's domestic travel accommodation market.

Features

• Search by region/keyword — Search with Korean keywords (e.g. "서울", "제주", "부산 해운대")
• Multi-region search — Queue multiple regions for batch scraping
• Direct URL input — Scrape specific hotel pages by URL
• Business registration info — Extract company name, owner, license number, tax registration
• Date-specific pricing — Set check-in/check-out dates and guest count for accurate room prices
• Room-level data — Get room types with pricing, occupancy, and availability
• Full location data — Address, coordinates, nearby stations, administrative district (시/도, 시/군/구)
• Ratings & reviews — Average rating and total review count
• Clean JSON output — Export to JSON, CSV, Excel, or connect via API

How to Use

1. Search mode — Enter a Korean region keyword (e.g. "서울", "제주") in the search field
2. Multi-region mode — Add multiple regions to searchRegions for batch scraping
3. Direct URL mode — Paste Yeogi hotel URLs into hotelUrls to scrape specific properties
4. Set checkIn and checkOut dates to get room prices for specific dates (defaults to 4 weeks ahead)
5. Set personnel to match your guest count (defaults to 2)
6. Adjust maxItems to control how many hotels to scrape per region
7. Enable includeContract to get business registration details (enabled by default)
8. Click Start and wait for results in the Dataset tab

Input Parameters

Field	Type	Description
search	string	Region or keyword to search (e.g. "서울")
searchRegions	string[]	Multiple regions to search
hotelUrls	string[]	Direct Yeogi hotel URLs
checkIn	string	Check-in date via calendar picker (default: 4 weeks from today)
checkOut	string	Check-out date via calendar picker (default: day after check-in)
personnel	integer	Number of guests (default: 2, max: 10)
category	string	Accommodation type filter — All, Motel, Hotel/Resort, Pension, etc. (default: All)
sortType	string	Sort order — Recommended, Price, Rating, Reviews (default: Recommended)
maxItems	integer	Max results per region (default: 100, max: 1000)
includeContract	boolean	Fetch business registration info (default: true)
proxy	object	Proxy configuration

Example Input — Single Region with Dates

{
    "search": "서울",
    "checkIn": "2026-05-01",
    "checkOut": "2026-05-03",
    "personnel": 2,
    "category": "2",
    "sortType": "PRICE_ASC",
    "maxItems": 50,
    "includeContract": true,
    "proxy": { "useApifyProxy": true }
}

Example Input — Multi-region

{
    "searchRegions": ["서울 강남", "부산 해운대", "제주시"],
    "checkIn": "2026-06-15",
    "checkOut": "2026-06-17",
    "personnel": 3,
    "sortType": "REVIEW_RATE",
    "maxItems": 100,
    "includeContract": true,
    "proxy": { "useApifyProxy": true }
}

Example Input — Direct URLs

{
    "hotelUrls": [
        "https://www.yeogi.com/domestic-accommodations/12345",
        "https://www.yeogi.com/domestic-accommodations/67890"
    ],
    "includeContract": true,
    "proxy": { "useApifyProxy": true }
}

Output Dataset

Each record contains one Yeogi accommodation with comprehensive data:

Property Info

Field	Type	Description
itemId	string	Unique property ID
name	string	Property name
url	string	Direct Yeogi URL
searchCheckIn	string	Check-in date used for this search
searchCheckOut	string	Check-out date used for this search
searchPersonnel	integer	Number of guests used for this search
category	string	Property type (호텔, 모텔, 펜션, etc.)
gradeCode	string	Grade classification code
categoryCode	integer	Category number
address	string	Full address
latitude	number	Latitude
longitude	number	Longitude
rating	number	Average review score
reviewCount	number	Total number of reviews
nearbyStation	string	Nearby transit stations
siDo	string	Province/City (시/도)
siGunGu	string	District (시/군/구)
tel	string	Property phone number
description	string	Property description
isBlack	boolean	Yeogi Black premium property
lowestPrice	number	Lowest room price (KRW)
badges	string[]	Property badges
keywords	string[]	Property keywords
regionCode	number	Administrative region code

Facilities & Services

Field	Type	Description
facilities	string[]	Facility/service names (WiFi, 주차, 피트니스, 바베큐, etc.)
managerComment	string	Host/manager description

Usage Information

Field	Type	Description
usageInfo	array	Structured usage info sections
usageInfo[].title	string	Section title (기본정보, 부대시설, 취소규정, etc.)
usageInfo[].contents	string[]	Section contents

Images

Field	Type	Description
images	array	Property photo list
images[].title	string	Image caption
images[].url	string	Image URL

Room Details

Field	Type	Description
rooms	array	Room types with full pricing and availability

Each item in the rooms array contains:

Field	Type	Description
name	string	Room name
type	string	Room type code
roomId	number	Room ID
standardPersonnel	integer	Base guest count
maxPersonnel	integer	Maximum guest count
imageCount	number	Number of room images
imageUrls	string[]	Room image URLs
stayPrice	number	Regular stay price (KRW)
stayDiscountPrice	number	Discounted stay price (KRW)
stayOriginalPrice	number	Original price before discount
stayTotalPrice	number	Total price
discountRate	number	Discount percentage
checkInTime	string	Check-in time
checkOutTime	string	Check-out time
cancelPolicy	string	Cancellation policy text
cancelType	string	Cancellation type (FREE, etc.)
isSoldOut	boolean	Whether room is sold out
rentAvailable	boolean	Whether hourly rental is available
rentDuration	string	Rental duration info
rentPrice	number	Rental price
rentDiscountPrice	number	Rental discounted price
isPersonCharging	boolean	Extra guest fee applies
additionalInfo	string	Extra room info
promotionTexts	string[]	Room promotion descriptions

Business Registration

Field	Type	Description
companyName	string	Business entity name
ownerName	string	Business owner name
licenseNumber	string	Business license number
roadAddress	string	Road-name address
email	string	Business contact email
contractTel	string	Business contract phone
mailOrderRegNo	string	Mail-order business registration number

Example Output

{
    "itemId": "64392",
    "name": "신라스테이 삼성",
    "url": "https://www.yeogi.com/domestic-accommodations/64392",
    "searchCheckIn": "2026-05-01",
    "searchCheckOut": "2026-05-02",
    "searchPersonnel": 2,
    "category": "호텔",
    "gradeCode": "HOTEL",
    "categoryCode": 2,
    "address": "서울특별시 강남구 영동대로 506",
    "latitude": 37.5088,
    "longitude": 127.0601,
    "rating": 9.4,
    "reviewCount": 1842,
    "nearbyStation": "삼성역 7번 출구 도보 3분",
    "siDo": "서울",
    "siGunGu": "강남구",
    "tel": "02-2230-0100",
    "description": "삼성역 인근 프리미엄 비즈니스 호텔",
    "isBlack": false,
    "lowestPrice": 315210,
    "facilities": ["피트니스", "무선인터넷", "욕실용품", "금연", "TV", "에어컨", "카페", "주차장"],
    "managerComment": "합리적인 가격으로 편안하고 즐거운 경험을 희망하는 분들께 최상의 가치를 선사하는 호텔입니다",
    "usageInfo": [
        {
            "title": "기본정보",
            "contents": [
                "체크인 : 15:00 | 체크아웃 : 12:00",
                "무료 Wi-Fi",
                "전 객실 금연",
                "유료 주차 (객실당 1대 / 1일 10,000원)"
            ]
        },
        {
            "title": "부대시설 정보",
            "contents": [
                "카페 / 20층 / 조식, 중식, 석식 뷔페 운영",
                "피트니스 센터 / 2층 / 06:00~23:00",
                "루프탑 테라스 / 21층 / 12:00~23:00"
            ]
        },
        {
            "title": "취소 및 환불 규정",
            "contents": [
                "체크인일 기준 3일 전까지 : 100% 환불",
                "체크인일 기준 2일 전~당일 및 No-show : 환불불가"
            ]
        }
    ],
    "images": [
        {"title": "대표 사진", "url": "https://image.withstatic.com/..."},
        {"title": "루프탑", "url": "https://image.withstatic.com/..."}
    ],
    "rooms": [
        {
            "name": "스탠다드 더블",
            "type": "NON_MOTEL",
            "roomId": 412345,
            "standardPersonnel": 2,
            "maxPersonnel": 2,
            "imageCount": 5,
            "stayPrice": 320210,
            "stayDiscountPrice": 315210,
            "stayOriginalPrice": 320210,
            "checkInTime": "15:00",
            "checkOutTime": "12:00",
            "cancelPolicy": "무료취소 - 4월 28일 23:59까지",
            "cancelType": "FREE",
            "isSoldOut": false,
            "rentAvailable": false,
            "isPersonCharging": false,
            "promotionTexts": ["기준2인 · 최대2인"]
        }
    ],
    "companyName": "(주)호텔신라",
    "ownerName": "이부진",
    "licenseNumber": "123-45-67890",
    "roadAddress": "서울특별시 강남구 영동대로 506",
    "email": "info@shillastay.com",
    "contractTel": "02-2230-0100",
    "mailOrderRegNo": "2024-서울강남-12345"
}

Cost Estimation

This scraper uses Yeogi's public API endpoints, which is very efficient. Typical costs on Apify platform:

Scenario	Hotels	Estimated Time	Estimated Cost
Single region, 50 hotels	50	~2-3 min	~$0.01-0.02
Single region, 100 hotels	100	~4-6 min	~$0.02-0.04
3 regions, 100 each	300	~12-18 min	~$0.05-0.10
10 regions, 100 each	1,000	~40-60 min	~$0.15-0.30

Costs depend on Apify platform pricing and proxy usage. The scraper uses minimal memory (256 MB is sufficient).

Use Cases

• Travel tech — Build accommodation search or comparison services for Korea
• Market research — Analyze Korean accommodation market by region, type, and pricing
• Competitor analysis — Monitor hotel availability and ratings across Korea
• Location intelligence — Map accommodation density and pricing by district
• Business intelligence — Extract verified business registration info

Limitations

• Only Korean domestic accommodations on Yeogi.com are supported
• Search keywords work best in Korean (한국어)
• Room pricing reflects availability for the specified check-in/check-out dates (defaults to 4 weeks ahead)
• Rate limiting is built-in to avoid overloading the source; very large scrapes may take longer
• Business registration data (includeContract) adds one extra API call per hotel

Tips

• Use Apify's datacenter proxies — they work reliably with Yeogi
• For large-scale scrapes, use searchRegions with specific sub-regions instead of broad keywords for better coverage
• If you only need basic hotel info without business details, set includeContract to false for faster scraping
• Results are deduplicated by itemId, so overlapping regions won't produce duplicates

FAQ

Q: Do I need a Korean IP or residential proxy? A: No. Datacenter proxies (including Apify's built-in proxies) work well with Yeogi.com.

Q: Can I search in English? A: Yeogi is a Korean platform. Search keywords in Korean (e.g. "서울", "부산") produce the best results.

Q: How often can I run this scraper? A: As often as you need. Built-in rate limiting ensures responsible usage.

Q: Is the output data in Korean? A: Yes, hotel names, addresses, and descriptions are in Korean as they appear on Yeogi.com.

Q: Why are some room prices missing? A: Rooms that are sold out or unavailable for the search dates won't have pricing data.