플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Booking 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Booking 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 여행지의 Booking.com 호텔, 아파트 등 숙소를 찾습니다. 공식 성급, 투숙객 점수, 가격, 조식 조건, 체인, 위치를 가져옵니다. 날짜는 | keyword | check_in, check_out, currency, lang, min_price, property_type, sort, star_rating | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=30. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · name · type · url · text · stars · rating · rating_scale · rating_label · review_count · price · currency · breakfast · hotel_chain · check_in_date · check_out_date · address · city · country · latitude · longitude · image_url · platform · category_ratings · image_urls · facilities |
profile상세 정보 /hotel/ 페이지 링크로 Booking.com 숙소 하나를 가져옵니다. 설명, 유형, 공식 성급, 항목별 평점이 포함된 투숙객 점수, 시설, 주소, 제시 가격이 포함됩니다. 공식 | url | check_in, check_out, currency, lang | Sync 응답 | — | 요청 1,000개당 $1.39 | id · name · type · url · text · stars · rating · rating_scale · rating_label · review_count · price · currency · breakfast · hotel_chain · check_in_date · check_out_date · address · city · country · latitude · longitude · image_url · platform · category_ratings · image_urls · facilities |
reviews리뷰 Booking.com 숙소의 투숙객 리뷰를 수집합니다. 좋았던 점과 아쉬웠던 점이 따로 나뉘어 있으며, 점수, 숙박 월, 여행자 유형, 객실, 호텔 답변(있는 경우)이 포함됩니다. 두 항목 중 하나가 비어 있을 수 있으며, 결과에 모든 리뷰가 포함되지 않을 수 있습니다. | url | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · title · text_positive · text_negative · rating · rating_scale · posted_at · stay_date · author_name · author_country · traveler_type · room_name · nights · language · owner_response · platform |
prices가격 Booking.com 숙소의 객실 요금을 날짜별로 비교합니다. 객실 유형, 원래 가격과 현재 가격, 세금, 환불 가능 여부, 식사 옵션, 남은 객실 수를 가져옵니다. | url | adults, check_in, currency, days, rooms, start_date | Sync 응답 | — | 요청 1,000개당 $1.39 | id · url · hotel_name · room_name · check_in · check_out · price · original_price · discount_percent · currency · taxes_included · is_sold_out · availability_status · min_stay · bed_type · max_guests · room_size_sqm · meal_plan · is_breakfast_included · is_refundable · rate_options_count · platform · rooms_left · room_view |
Booking search 파라미터는 각각 무엇을 의미하나요?
여행지의 Booking.com 호텔, 아파트 등 숙소를 찾습니다. 공식 성급, 투숙객 점수, 가격, 조식 조건, 체인, 위치를 가져옵니다. 날짜는 check_in과 check_out을 한 쌍으로 보내세요. 가격은 화면에 표시된 그대로이며 예약 전까지 확보되지 않습니다.
keyword필수- 숙소 여행지 이름을 지정합니다(예: Amsterdam). search 액션이 호텔, 아파트 등의 숙소를 찾을 때 사용하며, 항공편, 관광지, 리뷰 키워드에는 사용하지 않습니다.
check_in선택- 체크인 날짜를 YYYY-MM-DD 형식으로 지정합니다. search와 profile 액션에서 숙박 날짜를 보내려면 check_in과 check_out이 모두 필요합니다. prices에서는 start_date를 생략하면 이 값이 시작일로 쓰입니다. 예약을 생성하지 않습니다.
check_out선택- 체크아웃 날짜를 YYYY-MM-DD 형식으로 지정합니다. check_in보다 나중 날짜여야 하며 check_in과 함께 지정해야 합니다. check_out만 설정하면 search나 profile 액션에 숙박 기간이 전달되지 않습니다.
currency선택- 숙소 가격 표시 통화를 지정하며, 기본값은 USD입니다. search와 profile 액션에서는 나열된 소문자 코드를, prices에서는 대문자 세 글자 코드를 사용합니다. 이 파라미터는 EveryInfra API 과금을 바꾸지 않습니다.허용 값:
aedarsaudaznbgnbhdbrlcadchfclpcnycopczkdkkegpeurfjdgbpgelhkdhufidrilsinrjodjpykrwkwdkztmdlmxnmyrnadnoknzdomrplnqarronrubsarseksgdthbtrytwduahusdxofzar lang선택- 숙소 페이지 표시 언어를 지정하며, 기본값은 영국 영어입니다. 영국 영어는 engb, 미국 영어는 enus, 간체 중국어는 zhcn, 번체 중국어는 zhtw를 사용하세요(일반 en이나 zh는 전달하지 마세요). 이 파라미터는 리뷰 본문을 번역하지 않습니다.허용 값:
arbgcacsdadeelengbenusesesaretfifrhehrhuidisitjakoltlvmsnlnoplptbrptptroruskslsrsvthtltrukvizhcnzhtw min_price선택- 단일 최솟값이 아니라 1박 가격 범위 문자열로 숙소를 필터링합니다(예: 범위는 100-150, 100 이상은 100+). 통화는 currency 파라미터로 정하며, 총 숙박 가격은 지원하지 않습니다.
property_type선택- 숙소 카테고리로 검색 결과를 필터링하며, 대소문자와 공백을 그대로 유지해야 합니다(예: Hotels, Apartments, Hostels, Guest houses, Homestays, Bed and breakfasts, Holiday homes, Boats, Villas, Motels, Resorts, Holiday parks, Campsites, Luxury tents, 제한 없음은 none). 이 파라미터는 특정 객실 유형이 아니라 숙소 카테고리를 필터링합니다.
sort선택- 숙소 결과를 distance(위치 기준 거리), popular(리뷰 종합 순위), top_rated(게스트 리뷰 점수가 아닌 숙소 성급)로 정렬합니다. search의 기본값은 popular이며, profile 조회는 정렬을 무시합니다.허용 값:
distancepopulartop_rated star_rating선택- 숙소를 성급으로 필터링하며, 1_star부터 5_stars까지 사용할 수 있고, 등급이 없는 숙소는 unrated, 제한을 없애려면 any를 사용합니다. 숙소 성급은 게스트 리뷰 점수와 별개입니다.허용 값:
1_star2_stars3_stars4_stars5_starsanyunratedBooking: 성급, 리뷰 점수, 품질 등급 — Booking은 숙소 성급, 투숙객 리뷰 점수, 품질 등급을 각각 따로 정의합니다. 1–5성 등급은 1–10점 투숙객 리뷰 점수와 다르며, 노란색 블록으로 표시되는 품질 등급과 혼동하면 안 됩니다. · 확인일
Booking profile 파라미터는 각각 무엇을 의미하나요?
/hotel/ 페이지 링크로 Booking.com 숙소 하나를 가져옵니다. 설명, 유형, 공식 성급, 항목별 평점이 포함된 투숙객 점수, 시설, 주소, 제시 가격이 포함됩니다. 공식 stars와 투숙객 rating은 별개의 지표입니다. 날짜를 추가해도 가격이 확정되지 않습니다.
url필수- 숙소 페이지 하나의 전체 URL을 지정하며, /hotel/ 경로 형식을 권장합니다. profile 액션에서는 상세 정보를, reviews 액션에서는 숙소 리뷰를, prices 액션에서는 객실 요금을 가져오는 데 사용합니다. 여행지 검색 URL은 지원하지 않습니다.Booking: 숙소 페이지의 성급과 리뷰 점수 — Booking은 숙소 성급, 투숙객 리뷰 점수, 품질 등급을 구분합니다. profile 액션은 URL로 공개 숙소 페이지 하나를 읽습니다. 이 자료는 반환되는 평점 관련 용어를 설명할 뿐, 평점을 요청 필터로 사용할 수 있게 하거나 예약을 보장하지는 않습니다. · 확인일
check_in선택- 체크인 날짜를 YYYY-MM-DD 형식으로 지정합니다. search와 profile 액션에서 숙박 날짜를 보내려면 check_in과 check_out이 모두 필요합니다. prices에서는 start_date를 생략하면 이 값이 시작일로 쓰입니다. 예약을 생성하지 않습니다.
check_out선택- 체크아웃 날짜를 YYYY-MM-DD 형식으로 지정합니다. check_in보다 나중 날짜여야 하며 check_in과 함께 지정해야 합니다. check_out만 설정하면 search나 profile 액션에 숙박 기간이 전달되지 않습니다.
currency선택- 숙소 가격 표시 통화를 지정하며, 기본값은 USD입니다. search와 profile 액션에서는 나열된 소문자 코드를, prices에서는 대문자 세 글자 코드를 사용합니다. 이 파라미터는 EveryInfra API 과금을 바꾸지 않습니다.허용 값:
aedarsaudaznbgnbhdbrlcadchfclpcnycopczkdkkegpeurfjdgbpgelhkdhufidrilsinrjodjpykrwkwdkztmdlmxnmyrnadnoknzdomrplnqarronrubsarseksgdthbtrytwduahusdxofzar lang선택- 숙소 페이지 표시 언어를 지정하며, 기본값은 영국 영어입니다. 영국 영어는 engb, 미국 영어는 enus, 간체 중국어는 zhcn, 번체 중국어는 zhtw를 사용하세요(일반 en이나 zh는 전달하지 마세요). 이 파라미터는 리뷰 본문을 번역하지 않습니다.허용 값:
arbgcacsdadeelengbenusesesaretfifrhehrhuidisitjakoltlvmsnlnoplptbrptptroruskslsrsvthtltrukvizhcnzhtw
Booking reviews 파라미터는 각각 무엇을 의미하나요?
Booking.com 숙소의 투숙객 리뷰를 수집합니다. 좋았던 점과 아쉬웠던 점이 따로 나뉘어 있으며, 점수, 숙박 월, 여행자 유형, 객실, 호텔 답변(있는 경우)이 포함됩니다. 두 항목 중 하나가 비어 있을 수 있으며, 결과에 모든 리뷰가 포함되지 않을 수 있습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- 숙소 페이지 하나의 전체 URL을 지정하며, /hotel/ 경로 형식을 권장합니다. profile 액션에서는 상세 정보를, reviews 액션에서는 숙소 리뷰를, prices 액션에서는 객실 요금을 가져오는 데 사용합니다. 여행지 검색 URL은 지원하지 않습니다.Booking: 투숙객 리뷰와 항목별 평점 — Booking 문서에 따르면 종합 리뷰 점수와 항목별 점수는 각각 따로 제출됩니다. 이는 공식 웹사이트의 설명을 참고한 것입니다. 이 API 액션에 사용되는 리뷰 척도의 각 차원은 입력 형식별로 확인해야 하며, 이 링크를 인용했다고 해서 정규화가 검증되었다는 뜻은 아닙니다. · 확인일
Booking prices 파라미터는 각각 무엇을 의미하나요?
Booking.com 숙소의 객실 요금을 날짜별로 비교합니다. 객실 유형, 원래 가격과 현재 가격, 세금, 환불 가능 여부, 식사 옵션, 남은 객실 수를 가져옵니다. days 기간은 기본 7일, 최대 30일입니다. 각 행의 check_in과 check_out은 사용자가 지정한 날짜가 아니라 호텔의 일일 체크인·체크아웃 시간입니다.
url필수- 숙소 페이지 하나의 전체 URL을 지정하며, /hotel/ 경로 형식을 권장합니다. profile 액션에서는 상세 정보를, reviews 액션에서는 숙소 리뷰를, prices 액션에서는 객실 요금을 가져오는 데 사용합니다. 여행지 검색 URL은 지원하지 않습니다.
adults선택- 가격 조회의 성인 투숙객 수를 정수로 지정하며, 기본값은 2입니다. 가격 조회 파라미터로만 쓰이며, 반환되는 객실 옵션 수를 제한하거나 예약을 시작하지 않습니다. search는 성인 2명으로 고정해 동작합니다.
check_in선택- 체크인 날짜를 YYYY-MM-DD 형식으로 지정합니다. search와 profile 액션에서 숙박 날짜를 보내려면 check_in과 check_out이 모두 필요합니다. prices에서는 start_date를 생략하면 이 값이 시작일로 쓰입니다. 예약을 생성하지 않습니다.
currency선택- 숙소 가격 표시 통화를 지정하며, 기본값은 USD입니다. search와 profile 액션에서는 나열된 소문자 코드를, prices에서는 대문자 세 글자 코드를 사용합니다. 이 파라미터는 EveryInfra API 과금을 바꾸지 않습니다.
days선택- 가격을 며칠 앞까지 조회할지 달력 기준 일수로 지정합니다. 기본값은 7이며, 범위는 1~30입니다. 범위를 벗어난 값은 허용 범위의 최솟값 또는 최댓값으로 조정됩니다. 개별 객실 요금의 숙박 기간이 아니라 조회 날짜 범위를 정합니다.Booking: 요금과 세금 조건 — Booking에 따르면 요금은 숙박업체가 정하며, 세금과 부가 요금은 위치, 객실 유형, 투숙 인원에 따라 달라집니다. 포함 항목은 요금 설명마다 확인해야 합니다. 이 액션은 조회용이며 예약이나 가격을 보장하지 않습니다. · 확인일
rooms선택- 가격 조회의 객실 수를 정수로 지정하며, 기본값은 1입니다. 반환되는 객실 옵션 수가 아니라 요청하는 객실 수를 정합니다. search는 객실 1개로 고정해 동작합니다.
start_date선택- prices에서 일별 가격 조회의 시작일을 YYYY-MM-DD 형식으로 지정합니다. check_in과 함께 지정하면 check_in보다 우선합니다. 리뷰 게시일이나 숙소 개업일을 의미하지 않습니다.
Booking API 사용 방법
- 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
- 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
- 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
- 04애플리케이션에 필요한 응답 필드를 저장합니다.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"booking","action":"search","params":{"keyword":"<keyword>"}}'
Booking API 자주 묻는 질문
Booking API로 무엇을 가져올 수 있나요?
platform을 booking 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 상세 정보, 리뷰 및 가격입니다. 각 액션 이름은 서로 다른 Booking 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Booking search 요청에는 어떤 입력이 필요한가요?
숙소 여행지 이름을 지정합니다(예: Amsterdam). search 액션이 호텔, 아파트 등의 숙소를 찾을 때 사용하며, 항공편, 관광지, 리뷰 키워드에는 사용하지 않습니다. params 안의 keyword 필드로 전달하세요.
Booking search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 name, type, text 및 stars입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Booking 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.