해외호텔 검색 API

Request

[Request Headers]

$ curl 'https://search-tour-api.wonders.app/globalhotel/hotels?keyword=grand&page=1&limit=10&offset=0&innerSearch=hotel&latitude=&longitude=&distance=2&starRating=&hotelRatingMin=&hotelRatingMax=&wid=&id=&serviceChannelCode=&type=&city=&facility=&minPrice=&maxPrice=&sortType=WEIGHT' -i -X GET

[Request Parameter]

Parameter Type Description Default Value Allowed value Required

city

String

도시명

distance

Number

최대 위치검색 범위

2

거리값(km)

facility

String

편의시설

,로 구분된 문자열

hotelRatingMax

Number

평점(최대값)

hotelRatingMin

Number

평점(최소값)

id

String

투어 내부 호텔 ID

,로 구분된 문자열

innerSearch

String

검색결과내 재검색

latitude

Number

위도

위도 값(경도와 함께 입력 필수)

longitude

Number

경도

경도 값(위도와 함께 입력 필수)

maxPrice

Number

최대 가격

minPrice

Number

최소 가격

serviceChannelCode

String

서비스 채널 코드

,로 구분된 문자열

sortType

String

정렬 방식

WEIGHT, STAR_ASC, STAR_DESC, PRICE_ASC, PRICE_DESC 중 하나

starRating

String

성급

,로 구분된 1~5의 숫자

type

String

시설 타입

,로 구분된 문자열

wid

Number

위메프 ID

keyword

String

검색어

page

Number

페이지

1

limit

Number

페이지 당 노출 갯수

10

offset

Number

offset

0

[Request HTTP Example]

GET /globalhotel/hotels?keyword=grand&page=1&limit=10&offset=0&innerSearch=hotel&latitude=&longitude=&distance=2&starRating=&hotelRatingMin=&hotelRatingMax=&wid=&id=&serviceChannelCode=&type=&city=&facility=&minPrice=&maxPrice=&sortType=WEIGHT HTTP/1.1
Host: search-tour-api.wonders.app

Response

[Response Example]

{
  "took" : 1,
  "total" : 1,
  "data" : [ {
    "score" : 0.0,
    "id" : 8005076009,
    "wid" : 8005076009,
    "type" : "HOTEL",
    "heading" : "[말머리]",
    "nameKo" : "",
    "nameEn" : "Grand Hotel Bellevue - Grand Place",
    "country" : "FR",
    "cityKo" : "릴",
    "cityEn" : "Lille",
    "minPrice" : 0,
    "phone" : "+33320574564",
    "email" : "",
    "zipcode" : "59000",
    "addressKo" : "",
    "addressEn" : "5, rue Jean Roisin",
    "starRating" : 4.0,
    "hotelRating" : 0.0,
    "latitude" : 50.63654708862305,
    "longitude" : 3.062342405319214,
    "checkinTo" : "",
    "checkoutTo" : "12:00",
    "checkinFrom" : "14:00",
    "checkoutFrom" : "",
    "keyword" : [ ],
    "weight" : 0,
    "imageUrl" : "https://assets.hprotravel.com/65/dd56ab7d2abcab59bccd8c96e3bc83fc/CAR621800.jpg",
    "serviceChannelCode" : [ "SC001", "SC002" ],
    "facilityKo" : [ "헤어드라이어", "컨시어지 데스크", "차/커피 메이커 시설", "금연 호텔", "전화기", "룸서비스", "드라이클리닝/세탁 서비스", "바", "다중 언어 구사 가능한 직원", "책상", "무료 무선 인터넷 접속", "셀프 세탁", "바/라운지", "수하물 보관소", "객실 내 금고", "미니바", "디지털 TV 서비스", "미팅룸", "무료 신문", "욕조/샤워 결합", "프리미엄 침구", "엘리베이터", "세탁 서비스", "비즈니스 센터", "개인 욕실", "안전 금고", "24시간 프런트 데스크", "금연 객실", "객실 내 에어컨", "컴퓨터 스테이션", "콘퍼런스 시설", "신문 가판대", "다리미 & 다리미판", "객실 내 조식 서비스" ],
    "facilityEn" : [ "Hairdryer", "Concierge Desk", "Tea/Coffee Making Facilities", "Non-Smoking Hotel", "Telephone", "Room Service", "Dry cleaning / laundry service", "Bar", "Multilingual Staff", "Writing Desk", "Free Wireless Internet access", "Self Laundry", "Bar / Lounge", "Luggage Storage", "In room safe", "Minibar", "Digital TV service", "Meeting Rooms", "Free Newspaper", "Bathtub/Shower Combination", "Premium bedding", "Elevator / Lift", "Laundry Service", "Business Centre", "Private bathrooms", "Safety Deposit Box", "24 Hour Front Desk", "Non-Smoking Rooms", "Air Condition in rooms", "Computer station", "Conference Facilites", "Newsstand", "Iron & Board", "Breakfast Room" ],
    "total_search" : {
      "price" : 0,
      "keyword1" : "",
      "keyword2" : "Grand Hotel Bellevue",
      "keyword3" : "Vysoké Tatry null null",
      "keyword4" : "",
      "keyword5" : "",
      "product_type" : "GLOBAL_HOTEL"
    }
  } ]
}

[Response Fields]

Path Type Description

took

Number

검색수행시간

total

Number

검색결과수

data[].score

Number

score

data[].id

Number

투어 호텔 ID

data[].wid

Number

위메프 ID

data[].type

String

타입

data[].heading

String

말머리

data[].nameKo

String

시설명(한국어)

data[].nameEn

String

시설명(영어)

data[].country

String

국가코드

data[].cityKo

String

도시명(한국어)

data[].cityEn

String

도시명(영어)

data[].minPrice

Number

가격

data[].phone

String

전화번호

data[].email

String

이메일 주소

data[].zipcode

String

우편번호

data[].addressKo

String

주소(한국어)

data[].addressEn

String

주소(영어)

data[].starRating

Number

호텔 성급

data[].hotelRating

Number

평점

data[].longitude

Number

경도

data[].latitude

Number

위도

data[].checkinTo

String

체크인 시간(~까지)

data[].checkoutTo

String

체크아웃 시간(~까지)

data[].checkinFrom

String

체크인 시간(~부터)

data[].checkoutFrom

String

체크아웃 시간(~부터)

data[].keyword

Array

키워드

data[].weight

Number

가중치

data[].imageUrl

String

이미지 url

data[].serviceChannelCode

Array

채널

data[].facilityKo

Array

편의시설(한국어)

data[].facilityEn

Array

편의시설(영어)

data[].total_search.price

Number

통합 검색 정보-가격

data[].total_search.product_type

String

통합 검색 정보-상품 타입

data[].total_search.keyword1

String

통합 검색 정보-통합검색 키워드-검색가중치2.0

data[].total_search.keyword2

String

통합 검색 정보-통합검색 키워드-검색가중치2.0

data[].total_search.keyword3

String

통합 검색 정보-통합검색 키워드-검색가중치0.5

data[].total_search.keyword4

String

통합 검색 정보-통합검색 키워드-사용안함

data[].total_search.keyword5

String

통합 검색 정보-통합검색 키워드-사용안함

[Response HTTP Example]

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 2587

{
  "took" : 1,
  "total" : 1,
  "data" : [ {
    "score" : 0.0,
    "id" : 8005076009,
    "wid" : 8005076009,
    "type" : "HOTEL",
    "heading" : "[말머리]",
    "nameKo" : "",
    "nameEn" : "Grand Hotel Bellevue - Grand Place",
    "country" : "FR",
    "cityKo" : "릴",
    "cityEn" : "Lille",
    "minPrice" : 0,
    "phone" : "+33320574564",
    "email" : "",
    "zipcode" : "59000",
    "addressKo" : "",
    "addressEn" : "5, rue Jean Roisin",
    "starRating" : 4.0,
    "hotelRating" : 0.0,
    "latitude" : 50.63654708862305,
    "longitude" : 3.062342405319214,
    "checkinTo" : "",
    "checkoutTo" : "12:00",
    "checkinFrom" : "14:00",
    "checkoutFrom" : "",
    "keyword" : [ ],
    "weight" : 0,
    "imageUrl" : "https://assets.hprotravel.com/65/dd56ab7d2abcab59bccd8c96e3bc83fc/CAR621800.jpg",
    "serviceChannelCode" : [ "SC001", "SC002" ],
    "facilityKo" : [ "헤어드라이어", "컨시어지 데스크", "차/커피 메이커 시설", "금연 호텔", "전화기", "룸서비스", "드라이클리닝/세탁 서비스", "바", "다중 언어 구사 가능한 직원", "책상", "무료 무선 인터넷 접속", "셀프 세탁", "바/라운지", "수하물 보관소", "객실 내 금고", "미니바", "디지털 TV 서비스", "미팅룸", "무료 신문", "욕조/샤워 결합", "프리미엄 침구", "엘리베이터", "세탁 서비스", "비즈니스 센터", "개인 욕실", "안전 금고", "24시간 프런트 데스크", "금연 객실", "객실 내 에어컨", "컴퓨터 스테이션", "콘퍼런스 시설", "신문 가판대", "다리미 & 다리미판", "객실 내 조식 서비스" ],
    "facilityEn" : [ "Hairdryer", "Concierge Desk", "Tea/Coffee Making Facilities", "Non-Smoking Hotel", "Telephone", "Room Service", "Dry cleaning / laundry service", "Bar", "Multilingual Staff", "Writing Desk", "Free Wireless Internet access", "Self Laundry", "Bar / Lounge", "Luggage Storage", "In room safe", "Minibar", "Digital TV service", "Meeting Rooms", "Free Newspaper", "Bathtub/Shower Combination", "Premium bedding", "Elevator / Lift", "Laundry Service", "Business Centre", "Private bathrooms", "Safety Deposit Box", "24 Hour Front Desk", "Non-Smoking Rooms", "Air Condition in rooms", "Computer station", "Conference Facilites", "Newsstand", "Iron & Board", "Breakfast Room" ],
    "total_search" : {
      "price" : 0,
      "keyword1" : "",
      "keyword2" : "Grand Hotel Bellevue",
      "keyword3" : "Vysoké Tatry null null",
      "keyword4" : "",
      "keyword5" : "",
      "product_type" : "GLOBAL_HOTEL"
    }
  } ]
}