플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Expedia 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | keyword에 지정한 여행지의 Expedia 호텔을 비교하며, 지역, 성급, 투숙객 평점, 1박 요금과 총액, 할인, VIP Access 여부를 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
매물 상세 정보profile | url로 Expedia 호텔의 숙소 페이지를 조회합니다. | 요청 1,000개당 $1.39 | 정상 |
리뷰reviews | Expedia 호텔 하나의 투숙객 리뷰를 수집합니다. | 요청 1,000개당 $1.39 | 정상 |
렌터카 견적car_rental | 픽업 장소의 Expedia 렌터카 견적을 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Expedia 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색
| keyword | currency, sort | Sync 응답 | 카탈로그 값: defaultLimit=24, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | hotel_id · name · url · neighborhood · region · rating · rating_scale · rating_label · review_count · star_rating · price_per_night · price_total · discount_percent · vip_access · latitude · longitude · image_url · provider · platform |
profile매물 상세 정보
| url | — | Sync 응답 | — | 요청 1,000개당 $1.39 | hotel_id · hotel_name · hotel_url · rating · rating_scale · rating_label · review_count · star_rating · property_type · address · latitude · longitude · provider · category_ratings · languages · review_summary · platform |
reviews리뷰 Expedia 호텔 하나의 투숙객 리뷰를 수집합니다. 리뷰별 평점, 작성일, 숙박일, 여행 유형, 동행 유형, 숙박 인증 여부가 포함됩니다. | url | reviews_from, since, sort | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · text · title · rating · rating_scale · rating_label · posted_at · stay_date · author_name · trip_type · stay_duration · traveled_with · verified · language · hotel_id · hotel_name · hotel_url · hotel_rating · platform · liked · disliked · image_urls · owner_response |
car_rental렌터카 견적 픽업 장소의 Expedia 렌터카 견적을 가져옵니다. 견적별 차량 등급, 렌터카 회사, 가격, 평점, 픽업 및 반납 정보가 포함됩니다. 날짜를 지정하지 않으면 30일 뒤부터 2일간 대여하는 것으로 기본 설정됩니다. 예약은 이루어지지 않으며 세금이나 추가 요금도 확정되지 않습니다. | keyword | check_in, check_out, drop_off_date, pick_up_date | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · title · vehicle_category · vendor_name · price · price_total · rating · rating_scale · rating_label · attributes · pick_up_location · drop_off_location · pick_up_date · drop_off_date · pick_up_time · drop_off_time · image_url · platform |
Expedia search 파라미터는 각각 무엇을 의미하나요?
keyword에 지정한 여행지의 Expedia 호텔을 비교하며, 지역, 성급, 투숙객 평점, 1박 요금과 총액, 할인, VIP Access 여부를 가져옵니다. 가격은 게시된 그대로이며 특정 숙박에 대한 견적이 아니고, 예약 가능 여부도 확인되지 않습니다.
keyword필수- search 액션에서는 호텔 목적지를, car_rental에서는 픽업 장소 또는 Expedia carsearch 전체 URL을 지정합니다. car_rental에 전체 URL을 지정하면 URL에 포함된 파라미터가 별도로 입력한 날짜보다 우선합니다. 항공편 예약 가능 여부는 조회하지 않습니다.Expedia: 검색 결과에 표시되는 호텔 등급 — Expedia는 호텔 성급 분류를 일부 지역에서 사용하는 별도의 국가 등급과 구분하며, 성급 분류만으로 나열된 모든 편의시설이 제공된다고 보장할 수는 없습니다. 검색 결과의 `star_rating`은 투숙객 평균 점수나 전 세계 공통의 시설 인증이 아닙니다. · 확인일
currency선택- 호텔 검색 가격의 표시 통화를 설정하며, 기본값은 USD이고 API 과금 통화는 바뀌지 않습니다. car_rental 결과의 통화는 변경하지 않습니다.
sort선택search의 호텔 결과 정렬 순서로,distance,price_asc,price_desc,top_rated중 하나입니다. 지정하지 않으면 Expedia의 추천 순서를 따릅니다.허용 값:distanceprice_ascprice_desctop_rated
Expedia profile 파라미터는 각각 무엇을 의미하나요?
url로 Expedia 호텔의 숙소 페이지를 조회합니다. 성급, 투숙객 평점, 항목별 평점, 숙소 유형, 주소, 좌표, 사용 언어, 리뷰 요약을 가져옵니다. 검색 결과 페이지가 아닌 개별 호텔 페이지를 전달하세요.
url필수- 숙소 프로필이나 리뷰를 가져오기 위해 Expedia의 단일 호텔 페이지 URL 또는 호환되는 Hotels.com 링크를 받습니다. 검색 결과 페이지는 받지 않습니다. 렌터카 조회는 대신 keyword 파라미터로 전체 검색 URL을 전달해야 합니다.Expedia: 숙소 페이지에 표시되는 호텔 등급 — Expedia는 호텔 성급 분류를 일부 지역에서 사용하는 별도의 국가 등급과 구분하며, 성급 분류만으로 나열된 모든 편의시설이 제공된다고 보장할 수는 없습니다. 숙소 레코드의 `star_rating`은 투숙객 평균 점수나 전 세계 공통의 시설 인증이 아닙니다. · 확인일
Expedia reviews 파라미터는 각각 무엇을 의미하나요?
Expedia 호텔 하나의 투숙객 리뷰를 수집합니다. 리뷰별 평점, 작성일, 숙박일, 여행 유형, 동행 유형, 숙박 인증 여부가 포함됩니다. since로 날짜 범위를 좁히고 sort로 정렬 순서를 지정하세요. 모든 리뷰가 빠짐없이 수집된다는 보장은 없습니다.
url필수- 숙소 프로필이나 리뷰를 가져오기 위해 Expedia의 단일 호텔 페이지 URL 또는 호환되는 Hotels.com 링크를 받습니다. 검색 결과 페이지는 받지 않습니다. 렌터카 조회는 대신 keyword 파라미터로 전체 검색 URL을 전달해야 합니다.
reviews_from선택- 리뷰 시작일의 호환용 입력으로, YYYY-MM-DD 형식을 받습니다. since를 함께 지정하면 since가 우선합니다. 호텔 숙박 날짜는 필터링하지 않습니다.
since선택- YYYY-MM-DD 형식으로 호텔 리뷰 조회의 날짜 하한을 설정하며, reviews_from보다 우선합니다. 호텔 개업일이나 렌터카 픽업 기간은 필터링하지 않습니다.Expedia: 리뷰 점수, 작성 자격, 기존 답변 — Expedia 공식 가이드라인은 개별 리뷰 점수, 표시되는 숙소 종합 점수, 렌터카 평가 방식을 구분하며, 체크인을 시도했으나 숙박을 마치지 못한 일부 여행객의 리뷰도 허용합니다. 이 액션은 평점과 작성 자격 관련 용어만 제공하며, 반환된 값이 동일한 척도를 따르거나 숙박을 모두 마친 경우만 반영한다고 보장하지 않습니다. · 확인일
sort선택reviews의 리뷰 정렬:newest,relevance,top_rated또는most_helpful입니다.허용 값:most_helpfulnewestrelevancetop_rated
Expedia car_rental 파라미터는 각각 무엇을 의미하나요?
픽업 장소의 Expedia 렌터카 견적을 가져옵니다. 견적별 차량 등급, 렌터카 회사, 가격, 평점, 픽업 및 반납 정보가 포함됩니다. 날짜를 지정하지 않으면 30일 뒤부터 2일간 대여하는 것으로 기본 설정됩니다. 예약은 이루어지지 않으며 세금이나 추가 요금도 확정되지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태keyword필수- search 액션에서는 호텔 목적지를, car_rental에서는 픽업 장소 또는 Expedia carsearch 전체 URL을 지정합니다. car_rental에 전체 URL을 지정하면 URL에 포함된 파라미터가 별도로 입력한 날짜보다 우선합니다. 항공편 예약 가능 여부는 조회하지 않습니다.
check_in선택- car_rental 픽업 날짜의 호환용 별칭으로, pick_up_date를 생략한 경우에만 평가됩니다. 이 엔드포인트에서 호텔 체크인 날짜는 필터링하지 않습니다.
check_out선택- car_rental 반납 날짜의 호환용 별칭으로, drop_off_date를 생략한 경우에만 평가됩니다. 이 엔드포인트에서 호텔 체크아웃 날짜는 필터링하지 않습니다.
drop_off_date선택- YYYY-MM-DD 형식으로 렌터카 반납 날짜를 지정합니다. 픽업 날짜만 지정하고 반납 날짜를 지정하지 않으면 같은 날로 기본 설정되므로, 그보다 늦은 날짜를 명시해야 합니다. 픽업 날짜를 생략하면 기본 날짜 쌍이 단독으로 지정한 반납 날짜보다 우선 적용됩니다.
pick_up_date선택- YYYY-MM-DD 형식으로 렌터카 픽업 날짜를 지정하며, check_in보다 우선합니다. 생략하면 픽업일은 오늘로부터 30일 후, 대여 기간은 2일로 기본 설정됩니다. 렌터카 조회에서는 픽업 및 반납 시간이 오전 10:30으로 고정되므로 임의 시간대의 예약 가능 여부를 가정할 수 없습니다.
Expedia 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":"expedia","action":"search","params":{"keyword":"<keyword>"}}'
Expedia API 자주 묻는 질문
Expedia API로 무엇을 가져올 수 있나요?
platform을 expedia 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 매물 상세 정보, 리뷰 및 렌터카 견적입니다. 각 액션 이름은 서로 다른 Expedia 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Expedia search 요청에는 어떤 입력이 필요한가요?
search 액션에서는 호텔 목적지를, car_rental에서는 픽업 장소 또는 Expedia carsearch 전체 URL을 지정합니다. car_rental에 전체 URL을 지정하면 URL에 포함된 파라미터가 별도로 입력한 날짜보다 우선합니다. 항공편 예약 가능 여부는 조회하지 않습니다. params 안의 keyword 필드로 전달하세요.
Expedia search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 hotel_id, name, neighborhood 및 region입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Expedia 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.