SocialCrawl API 키 하나로 Airbnb의 가격이 계산된 숙소 검색, 숙소 상세, 게스트 리뷰, 예약 가능 캘린더를 구조화 JSON으로 가져옵니다. 호출은 크레딧으로 과금됩니다.
활성 엔드포인트는 4개입니다. 검색, 숙소, 리뷰, 예약 가능 캘린더를 지원합니다.
공개 Airbnb 데이터를 읽는 엔드포인트는 4개입니다. 장소별 가격 포함 숙소 검색, 숙소 상세, 게스트 리뷰 페이지 조회, 숙소 예약 가능 캘린더를 지원합니다.
/v1/airbnb/search장소 하나에 대한 숙소를 페이지당 최대 18개 반환합니다. 숙소마다 이름, 좌표, 5점 만점 평점, 리뷰 수, 사진, 가격이 계산된 숙박(총액, 1박 가격, 할인 전 총액, 세금과 수수료)이 포함됩니다. 날짜를 보내지 않으면 Airbnb 기본 숙박 기간으로 계산하고 사용한 날짜를 함께 알려 줍니다. 표준 티어(1 크레딧)입니다.
location, check_in, check_out, adults, children, infants, pets, cursor
/v1/airbnb/listing숙소 하나를 전체 정보로 반환합니다. 제목, 숙소 유형, 설명, 지역, 좌표, 평점과 리뷰 수, 사진, 편의시설, 체크인과 체크아웃 시간이 포함됩니다. 날짜를 보내면 해당 숙박의 가격도 계산합니다. 존재하지 않는 숙소 id는 id를 확인하라는 안내와 함께 503으로 응답하며 과금되지 않습니다. 표준 티어(1 크레딧)입니다.
id, url, check_in, check_out, adults
/v1/airbnb/listing/reviews숙소의 게스트 리뷰를 페이지당 최대 24개 반환합니다. 리뷰마다 5점 만점 평점, 게스트가 쓴 언어의 본문, 날짜, 게스트의 이름과 지역, 호스트의 답변이 포함됩니다. data.total은 숙소의 전체 리뷰 수입니다. 고급 티어(5 크레딧)입니다.
id, url, limit, cursor
/v1/airbnb/listing/availability숙소의 캘린더를 최대 12개월까지 하루 단위로 반환합니다. 날짜마다 예약 가능 여부, 해당 날짜에 체크인이나 체크아웃을 할 수 있는지, 최소 숙박일과 최대 숙박일이 포함됩니다. 날짜별 가격은 없으며 가격은 날짜를 보낸 숙소 상세 경로로 계산합니다. 고급 티어(5 크레딧)입니다.
id, url, from, months
특정 지역의 Airbnb 숙소를 이름, 좌표, 5점 만점 평점, 리뷰 수, 사진과 함께 총액, 1박 요금, 할인 전 금액, 세금 및 수수료까지 반환합니다.
지역 안의 숙소 가격을 비교할 때 사용하세요. check_in과 check_out을 넣으면 해당 날짜 기준 요금이고, 없으면 Airbnb 기본 숙박 기준입니다.
1크레딧
location · A place, for example Lisbon, Portugal.
$ curl https://www.socialcrawl.dev/v1/airbnb/search?location=Lisbon%2C+Portugal \
-H "x-api-key: sc_YOUR_API_KEY"// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다Airbnb도 다른 SocialCrawl 데이터 엔드포인트와 같습니다. API 키로 GET /v1/airbnb/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다.
x-api-key 헤더에 키를 보냅니다. 공개 읽기에 Airbnb 계정이나 개발자 앱은 필요 없습니다. SocialCrawl 전 플랫폼에 같은 키를 사용합니다.
검색은 location과 선택적인 날짜와 인원을 받습니다. 숙소 경로는 id 또는 url을 받습니다. 날짜는 YYYY-MM-DD 형식입니다. 과금 전에 형식을 검증합니다.
검색과 숙소 상세는 1 크레딧입니다. 게스트 리뷰와 예약 가능 캘린더는 5 크레딧입니다. 캐시 히트는 0입니다.
응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 페이지가 있는 목록 응답은 페이지네이션 필드를 가집니다.
대부분 제품은 대상을 먼저 찾은 뒤 필요할 때만 상세와 리뷰를 깊게 봅니다.
GET /v1/airbnb/search?location=…가격이 계산된 숙박이 있는 PlaceList
날짜와 인원을 보내면 필요한 숙박 조건의 가격을 계산합니다.
GET /v1/airbnb/listing?id=…&check_in=…&check_out=…편의시설, 좌표, 가격이 계산된 숙박이 있는 Place
숙소 id는 검색 결과 행에서 가져옵니다.
GET /v1/airbnb/listing/reviews?id=…호스트 답변이 있는 페이지당 최대 24개 ReviewList
data.total로 전체 리뷰 수를 확인하므로 일부 표본을 전체로 오해하지 않습니다.
GET /v1/airbnb/listing/availability?id=…최대 12개월 날짜별 캘린더
최소 숙박일과 체크인 규칙이 날짜마다 포함됩니다.
GET /v1/airbnb/search?location=Lisbon%2C+Portugal&check_in=2026-12-01&check_out=2026-12-05&adults=2
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
GET /v1/airbnb/listing/reviews?id=33579922{
"success": true,
"data": {
"items": [
{
"place": {
"id": "33579922",
"name": "Example listing",
"rating": {
"value": 4.9
},
"hotel": {
"prices": {
"total": 640,
"currency": "EUR"
}
}
}
}
]
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}아키타입이 맞는 범위에서 필드 이름은 SocialCrawl 나머지와 같습니다. 한 번 파싱해 여러 플랫폼에 재사용합니다.
items[]에 이름, 좌표, 평점, 리뷰 수, 사진, hotel.prices
제목, category, 설명, 편의시설, 체크인과 체크아웃 시간, hotel.prices
items[]에 평점, 본문, language, translated, 날짜, 게스트, responses[]
nights[]에 예약 가능 여부, 체크인과 체크아웃 가능 여부, 최소·최대 숙박일
다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. Airbnb은 사이드카가 아닙니다.
Next.js catch-all이 Hono 소셜 API로 라우팅합니다. request_id를 만들고 키를 인증한 뒤 분당 600회, 키당 동시 50개 한도를 적용합니다.
레지스트리에서 airbnb 경로를 찾습니다. 필수 파라미터와 형식 검사를 먼저 합니다. 잘못된 입력은 과금 없이 400입니다. 유효 호출은 읽기를 시작하기 전에 티어 비용을 원자적으로 차감합니다.
platform + resource + params로 캐시 키를 만듭니다. 히트면 credits_used = 0으로 즉시 반환합니다. 미스면 공개 페이지를 실시간으로 읽으며 5xx나 네트워크 오류는 재시도하고 소스가 불안정하면 서킷 브레이커를 사용합니다.
Airbnb 데이터를 Place, PlaceList, ReviewList 아키타입으로 매핑하거나 구조화된 캘린더 행으로 반환하고 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.
운영에서 중요한 과금 규칙
Airbnb는 공개 읽기 데이터입니다. SocialCrawl 스키마로 정규화하므로 별도 벤더 SDK를 배울 필요가 없습니다.
공개 숙소 페이지, 검색 결과, 게스트 리뷰, 예약 가능 캘린더입니다.
공개 페이지를 요청 시점에 읽어 서버에서 정규화합니다. Airbnb 로그인이나 예약 세션을 직접 운영할 필요가 없습니다.
숙소는 PlaceList와 Place, 게스트 리뷰는 ReviewList, 캘린더는 구조화된 행입니다.
예약, 메시지, 호스트 도구, 날짜별 캘린더 가격은 제공하지 않습니다.
이 API가 가장 많이 사용되는 작업입니다.
단기 숙박 시장 조사와 리뷰 분석
호출은 시장 검색에서 시작해 중요한 숙소의 리뷰와 캘린더로 깊어집니다. 가격이 계산된 숙박, 호스트 답변이 있는 게스트 리뷰, 12개월 예약 가능 캘린더를 키 하나로 공통 Place와 Review 스키마에 맞춰 받습니다.
라이브 미스는 요청 시점에 공개 페이지를 읽습니다. 반복 호출은 캐시에서 0 크레딧으로 응답합니다.
이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.
날짜를 지정한 search와 listing으로 주변 숙소와 1박 가격을 비교합니다.
listing/availability로 앞으로 몇 달의 시장 예약률을 파악합니다.
listing/reviews로 게스트가 칭찬하는 점과 불만을 수집합니다.
검색은 1 크레딧입니다. 리뷰 한 페이지는 5 크레딧입니다. 캐시 히트는 무료입니다.
curl "https://www.socialcrawl.dev/v1/airbnb/search?location=Lisbon%2C+Portugal&check_in=2026-12-01&check_out=2026-12-05&adults=2" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/airbnb/listing/reviews?id=33579922" \
-H "x-api-key: sc_your_api_key_here"모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기AI에게 SocialCrawl을 물어보세요