플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Airbnb 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | keyword로 전달한 여행지의 Airbnb 숙소를 찾습니다. | 요청 1,000개당 $1.39 | 정상 |
매물 상세 정보property_detail | /rooms/ 링크나 숙소 ID로 Airbnb 숙소 하나를 읽어 옵니다. | 요청 1,000개당 $1.39 | 정상 |
리뷰reviews | Airbnb 숙소의 게스트 리뷰를 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
호스트 프로필host | 프로필 링크나 호스트 ID로 Airbnb 호스트를 조회합니다. | 요청 1,000개당 $1.39 | 정상 |
예약 가능 일정calendar | Airbnb 숙소의 날짜별 예약 가능 여부를 확인합니다. | 요청 1,000개당 $1.39 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Airbnb 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색
| keyword | currency, lang, locale, max_price, min_price | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · title · text · property_type · person_capacity · price · rating · rating_scale · review_count · lat · lng · location · host_name · amenities · image_url · check_in · check_out · platform |
property_detail매물 상세 정보 /rooms/ 링크나 숙소 ID로 Airbnb 숙소 하나를 읽어 옵니다. 객실 유형, 최대 인원, 침실·침대·욕실 수, 편의시설, 평점, 호스트 정보를 가져옵니다. 선택 파라미터인 | url | city, max_price, min_price | Sync 응답 | — | 요청 1,000개당 $1.39 | id · url · title · text · property_type · room_type · person_capacity · bedrooms · bathrooms · beds · location · lat · lng · rating · rating_scale · review_count · price · currency · host_name · is_superhost · amenities · platform |
reviews리뷰 Airbnb 숙소의 게스트 리뷰를 가져옵니다. 각 리뷰에는 텍스트, 평점, 날짜, 언어, 작성자 이름과 위치, 호스트 답변(있는 경우)이 포함됩니다. 언어, | url | lang, locale, since, sort | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · text · rating · rating_scale · posted_at · language · author_name · author_location · response · platform |
host호스트 프로필 프로필 링크나 호스트 ID로 Airbnb 호스트를 조회합니다. 이름, 소개, 사용 언어, 평점, 슈퍼호스트 여부, 가입일, 숙소 수를 가져옵니다. 숙소 ID가 아닌 /users/show/ 링크나 호스트 ID를 전달하세요. 프로필은 호스트의 신원을 검증하지 않습니다. | url | — | Sync 응답 | — | 요청 1,000개당 $1.39 | id · url · name · text · avatar_url · languages · listing_count · rating · rating_scale · review_count · is_superhost · joined_at · listing_urls · platform |
calendar예약 가능 일정 Airbnb 숙소의 날짜별 예약 가능 여부를 확인합니다. 날짜마다 체크인·체크아웃 가능 여부, 최소·최대 숙박일, 가격이 표시됩니다. 날짜를 지정하지 않으면 오늘부터 30일간을 조회합니다. 캘린더 조회만으로 숙박이 임시로 확보되거나 예약되지는 않습니다. | url | check_in, check_out, end_date, since, start_date, until | Sync 응답 | — | 요청 1,000개당 $1.39 | id · date · available · available_for_checkin · available_for_checkout · bookable · min_nights · max_nights · price · currency · platform |
Airbnb search 파라미터는 각각 무엇을 의미하나요?
keyword로 전달한 여행지의 Airbnb 숙소를 찾습니다. 통화, 언어, 가격대 필터는 선택 사항입니다. 각 행에는 화면에 표시된 숙소 유형, 최대 인원, 가격, 평점이 나오지만 특정 날짜의 예약 가능 여부는 확인하지 않습니다.
keyword필수- search 액션의 대상 위치, 도시, 지역 또는 여행지 이름(예: Tokyo)을 지정합니다. 호스트 사용자 이름이나 숙소 ID가 아니라 장소 이름을 전달하세요.
currency선택- Airbnb 검색 결과의 숙소 표시 통화를 지정합니다(기본값 USD, 허용 값 참고). 숙소 가격에 쓰이는 통화만 바뀌며, EveryInfra API 요청 과금이나 지갑 통화는 바뀌지 않습니다.허용 값:
aedaudbgnbrlcadchfclpcnycopcrcczkdkkegpeurgbpghshkdhrkhufidrilsinrjpykeskrwkztmadmxnmyrnoknzdpenphpplnqarronsarseksgdthbtrytwduahugxusduyuvndzar lang선택- enus(en-US), zhcn(zh-CN), jajp(ja-JP) 같은 축약 코드로 언어와 지역 조합을 지정합니다. en 같은 일반 두 글자 언어 코드가 아니라 나열된 허용 값 중 하나를 정확히 전달하세요.허용 값:
arxxazazbgbgbsbacaescsczdadkdeatdechdededeluelgrenaeenauencaengbengyenieeninennzensgenuses419esaresboesbzesclescoescresecesesesgteshnesmxesniespaespeespyessvesusesveeteefififrbefrcafrchfrfrfrlugaieheilhiinhrhrhuhuhyamididisisitchititjajpkagekokrltltlvlvmkmkmsmymtmtnlbenlnlnonoplplptbrptptrororuruskskslsisqalsrmesrrssvseswxxththtlphtrtrukuavivnxhzazhcnzhhkzhtwzhtwuszhuszuza locale선택- Airbnb 페이지 표시 로캘을 설정합니다(기본값 en-US). 예: en-US, zh-CN. locale을 lang과 함께 전달하지 마세요. lang이 우선하며 언어 선택을 덮어씁니다. 이 파라미터는 리뷰 작성자의 국적으로 리뷰를 필터링하지 않습니다.
max_price선택- 숙소 최고 가격 필터를 숫자로 설정합니다. min_price 이상이어야 합니다. 검색 결과를 필터링하는 용도이며, 개별 API 요청 비용이나 전체 숙박 예산을 제한하지 않습니다. 필터링은 정수로 처리되며 소수점은 올림합니다(145.98은 146이 됨).
min_price선택- max_price와 함께 사용할 때 숙소 최저 가격 필터를 숫자로 설정합니다. 숙소 검색 결과를 필터링할 뿐, API 사용량 한도를 설정하지 않습니다. 필터링은 정수로 처리되며 소수점은 내림합니다(39.81은 39가 됨).
Airbnb property_detail 파라미터는 각각 무엇을 의미하나요?
/rooms/ 링크나 숙소 ID로 Airbnb 숙소 하나를 읽어 옵니다. 객실 유형, 최대 인원, 침실·침대·욕실 수, 편의시설, 평점, 호스트 정보를 가져옵니다. 선택 파라미터인 city와 가격 필터를 지정해도 검색이나 예약 견적으로 바뀌지 않습니다.
url필수- 액션에 따라 대상 리소스를 식별합니다. property_detail, reviews, calendar에는 /rooms/<property_id> URL이나 숙소 ID를, host에는 /users/show/<host_id> URL이나 호스트 ID를 전달하세요. 숙소 식별자와 호스트 식별자는 서로 바꿔 쓸 수 없습니다.Airbnb: 숙소 리뷰와 공개 범위 제한 — Airbnb는 공개 리뷰와 종합 별점을 호스트와 플랫폼만 볼 수 있는 항목별 세부 평점과 구분합니다. 숙소 종합 점수와 여러 숙소에 걸친 호스트 점수는 따로 계산되므로 혼동하면 안 됩니다. · 확인일
city선택- 숙소 상세 조회에 쓰는 자유 텍스트 형식의 도시 이름 필터를 지정합니다. 숙소 ID나 국가 코드가 아니라 도시 이름을 입력하세요.
max_price선택- 숙소 최고 가격 필터를 숫자로 설정합니다. min_price 이상이어야 합니다. 검색 결과를 필터링하는 용도이며, 개별 API 요청 비용이나 전체 숙박 예산을 제한하지 않습니다. 필터링은 정수로 처리되며 소수점은 올림합니다(145.98은 146이 됨).
min_price선택- max_price와 함께 사용할 때 숙소 최저 가격 필터를 숫자로 설정합니다. 숙소 검색 결과를 필터링할 뿐, API 사용량 한도를 설정하지 않습니다. 필터링은 정수로 처리되며 소수점은 내림합니다(39.81은 39가 됨).
Airbnb reviews 파라미터는 각각 무엇을 의미하나요?
Airbnb 숙소의 게스트 리뷰를 가져옵니다. 각 리뷰에는 텍스트, 평점, 날짜, 언어, 작성자 이름과 위치, 호스트 답변(있는 경우)이 포함됩니다. 언어, since 날짜, 정렬 순서로 범위를 좁힐 수 있습니다. 한 번에 가져온 결과가 전체 리뷰 기록이라는 보장은 없습니다.
url필수- 액션에 따라 대상 리소스를 식별합니다. property_detail, reviews, calendar에는 /rooms/<property_id> URL이나 숙소 ID를, host에는 /users/show/<host_id> URL이나 호스트 ID를 전달하세요. 숙소 식별자와 호스트 식별자는 서로 바꿔 쓸 수 없습니다.Airbnb: 숙소 리뷰와 공개 범위 제한 — Airbnb는 공개 리뷰와 종합 별점을 호스트와 플랫폼만 볼 수 있는 항목별 세부 평점과 구분합니다. 숙소 종합 점수와 여러 숙소에 걸친 호스트 점수는 따로 계산되므로 혼동하면 안 됩니다. · 확인일
lang선택- enus(en-US), zhcn(zh-CN), jajp(ja-JP) 같은 축약 코드로 언어와 지역 조합을 지정합니다. en 같은 일반 두 글자 언어 코드가 아니라 나열된 허용 값 중 하나를 정확히 전달하세요.허용 값:
arxxazazbgbgbsbacaescsczdadkdeatdechdededeluelgrenaeenauencaengbengyenieeninennzensgenuses419esaresboesbzesclescoescresecesesesgteshnesmxesniespaespeespyessvesusesveeteefififrbefrcafrchfrfrfrlugaieheilhiinhrhrhuhuhyamididisisitchititjajpkagekokrltltlvlvmkmkmsmymtmtnlbenlnlnonoplplptbrptptrororuruskskslsisqalsrmesrrssvseswxxththtlphtrtrukuavivnxhzazhcnzhhkzhtwzhtwuszhuszuza locale선택- Airbnb 페이지 표시 로캘을 설정합니다(기본값 en-US). 예: en-US, zh-CN. locale을 lang과 함께 전달하지 마세요. lang이 우선하며 언어 선택을 덮어씁니다. 이 파라미터는 리뷰 작성자의 국적으로 리뷰를 필터링하지 않습니다.
since선택- YYYY-MM-DD 형식의 시작일을 설정하며, 적용 범위는 액션에 따라 다릅니다. reviews에서는 리뷰 시작 날짜를 설정하고, calendar에서는 날짜 범위의 시작을 설정하며 start_date와 check_in보다 우선합니다.
sort선택- 게스트 리뷰 정렬 기준을 newest(기본값), relevance 또는 top_rated로 설정합니다. 이 파라미터는 리뷰 순서에만 적용되며 숙소 가격에는 적용되지 않습니다.허용 값:
newestrelevancetop_rated
Airbnb host 파라미터는 각각 무엇을 의미하나요?
프로필 링크나 호스트 ID로 Airbnb 호스트를 조회합니다. 이름, 소개, 사용 언어, 평점, 슈퍼호스트 여부, 가입일, 숙소 수를 가져옵니다. 숙소 ID가 아닌 /users/show/ 링크나 호스트 ID를 전달하세요. 프로필은 호스트의 신원을 검증하지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- 액션에 따라 대상 리소스를 식별합니다. property_detail, reviews, calendar에는 /rooms/<property_id> URL이나 숙소 ID를, host에는 /users/show/<host_id> URL이나 호스트 ID를 전달하세요. 숙소 식별자와 호스트 식별자는 서로 바꿔 쓸 수 없습니다.Airbnb: 호스트 평점과 숙소 평점의 차이 — Airbnb는 숙소별 종합 평점을 집계해 호스트 평점을 계산합니다. 호스트 프로필 점수를 가져왔더라도 그 평점을 개별 숙소에 그대로 적용할 수는 없습니다. · 확인일
Airbnb calendar 파라미터는 각각 무엇을 의미하나요?
Airbnb 숙소의 날짜별 예약 가능 여부를 확인합니다. 날짜마다 체크인·체크아웃 가능 여부, 최소·최대 숙박일, 가격이 표시됩니다. 날짜를 지정하지 않으면 오늘부터 30일간을 조회합니다. 캘린더 조회만으로 숙박이 임시로 확보되거나 예약되지는 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- 액션에 따라 대상 리소스를 식별합니다. property_detail, reviews, calendar에는 /rooms/<property_id> URL이나 숙소 ID를, host에는 /users/show/<host_id> URL이나 호스트 ID를 전달하세요. 숙소 식별자와 호스트 식별자는 서로 바꿔 쓸 수 없습니다.
check_in선택- calendar 액션의 호환용 YYYY-MM-DD 시작일을 설정합니다. start_date도 함께 지정하면 start_date가 우선하며, since를 지정하면 둘 다 덮어씁니다. 캘린더 날짜를 조회해도 예약이 진행되지는 않습니다.
check_out선택- calendar 액션의 호환용 YYYY-MM-DD 종료일을 설정합니다. end_date도 함께 지정하면 end_date가 우선하며, until을 지정하면 둘 다 덮어씁니다. 캘린더 날짜를 조회해도 숙소 예약 가능 일정이 확보되지는 않습니다.
end_date선택- 캘린더 예약 가능 여부 조회의 YYYY-MM-DD 종료일을 설정합니다. 생략하면 check_out을 사용하고, 그것도 없으면 조회일로부터 30일 후를 사용합니다(start_date에 30일을 더한 날짜가 아님). until을 지정하면 이 파라미터를 덮어씁니다.
since선택- YYYY-MM-DD 형식의 시작일을 설정하며, 적용 범위는 액션에 따라 다릅니다. reviews에서는 리뷰 시작 날짜를 설정하고, calendar에서는 날짜 범위의 시작을 설정하며 start_date와 check_in보다 우선합니다.
start_date선택- 캘린더 예약 가능 여부 조회의 YYYY-MM-DD 시작일을 설정합니다. 생략하면 check_in을 사용하고, 그것도 없으면 현재 날짜를 사용합니다. since를 지정하면 이 파라미터를 덮어씁니다.
until선택- calendar 액션의 YYYY-MM-DD 종료일을 설정하며, end_date와 check_out보다 우선합니다. 이 파라미터는 캘린더 날짜 범위를 제어하며 리뷰 게시일을 필터링하지 않습니다.
Airbnb 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":"airbnb","action":"search","params":{"keyword":"<keyword>"}}'
Airbnb API 자주 묻는 질문
Airbnb API로 무엇을 가져올 수 있나요?
platform을 airbnb 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 매물 상세 정보, 리뷰, 호스트 프로필 및 예약 가능 일정입니다. 각 액션 이름은 서로 다른 Airbnb 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Airbnb search 요청에는 어떤 입력이 필요한가요?
search 액션의 대상 위치, 도시, 지역 또는 여행지 이름(예: Tokyo)을 지정합니다. 호스트 사용자 이름이나 숙소 ID가 아니라 장소 이름을 전달하세요. params 안의 keyword 필드로 전달하세요.
Airbnb search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 title, text, property_type 및 person_capacity입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Airbnb 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.