건물 검색
1 크레딧/v1/apartments/searchApartments.com 검색 링크의 임대 건물을 링크의 필터를 유지한 채 페이지당 40개씩 사이트 전체 건수와 함께 반환합니다. 건물마다 매물 id, 이름, 주소, 좌표, 전화번호, 최저와 최고 임대료, 침실 수별 최저 임대료, 현재 프로모션, 편의시설이 포함됩니다. 표준 티어(1 크레딧)입니다.
url, page
공개 Apartments.com 데이터를 읽는 엔드포인트는 2개입니다. 검색 링크로 지역의 임대 건물을 검색하고 건물 하나를 전체 정보로 읽습니다.
/v1/apartments/searchApartments.com 검색 링크의 임대 건물을 링크의 필터를 유지한 채 페이지당 40개씩 사이트 전체 건수와 함께 반환합니다. 건물마다 매물 id, 이름, 주소, 좌표, 전화번호, 최저와 최고 임대료, 침실 수별 최저 임대료, 현재 프로모션, 편의시설이 포함됩니다. 표준 티어(1 크레딧)입니다.
url, page
/v1/apartments/propertyApartments.com 링크로 건물 하나를 전체 정보로 반환합니다. 전체 설명, 모든 사진, 매물에 표시되는 경우 별점과 평가 수가 추가됩니다. 표준 티어(1 크레딧)입니다.
url
Apartments.com 검색 링크의 임대 건물을 페이지당 40건 반환합니다. 최저와 최고 임대료, 침실 수별 임대료, 프로모션, 편의시설, 전화번호가 포함됩니다.
필터가 포함된 Apartments.com 검색 링크로 한 지역의 임대료와 프로모션을 비교할 때 사용하세요.
1크레딧
$ curl https://www.socialcrawl.dev/v1/apartments/search?url=https%3A%2F%2Fwww.apartments.com%2Faustin-tx%2F \
-H "x-api-key: sc_YOUR_API_KEY"// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다Apartments.com도 다른 SocialCrawl 데이터 엔드포인트와 같습니다. API 키로 GET /v1/apartments/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다.
x-api-key 헤더에 키를 보냅니다. 공개 읽기에 Apartments.com 계정이나 파트너 권한은 필요 없습니다. SocialCrawl 전 플랫폼에 같은 키를 사용합니다.
검색은 필터가 포함된 Apartments.com 검색 링크인 url과 커서를 받습니다. 건물 상세는 건물 링크인 url을 받습니다. 과금 전에 형식을 검증합니다.
Apartments.com의 두 경로는 모두 1 크레딧입니다. 캐시 히트는 0입니다.
응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 페이지가 있는 목록 응답은 페이지네이션 필드를 가집니다.
대부분 제품은 지역의 임대료를 먼저 비교한 뒤 필요한 건물만 상세로 읽습니다.
GET /v1/apartments/search?url=…페이지당 40개 건물의 PlaceList
Apartments.com 검색 링크에 가격, 침실, 편의시설 필터가 함께 담깁니다.
GET /v1/apartments/search?url=…&cursor=2침실 수별 임대료와 프로모션
place.ext.apartments에 침실 수별 최저 임대료와 현재 프로모션이 담깁니다.
GET /v1/apartments/property?url=…설명, 사진, 평점이 있는 Place
7자리 매물 id로 끝나는 건물 링크를 보냅니다.
GET /v1/apartments/search?url=https%3A%2F%2Fwww.apartments.com%2Faustin-tx%2F
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
GET /v1/apartments/property?url=https%3A%2F%2Fwww.apartments.com%2Floyola-junction-i-austin-tx%2F940ms65%2F{
"success": true,
"data": {
"place": {
"id": "940ms65",
"name": "Loyola Junction I",
"phone": "864-528-1774",
"rating": { "value": 3, "max": 5 },
"ext": {
"listing": {
"price": 1243,
"currency": "USD",
"status": "for_rent"
},
"apartments": {
"price_max": 2257,
"availability": "in_stock"
}
}
}
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}아키타입이 맞는 범위에서 필드 이름은 SocialCrawl 나머지와 같습니다. 한 번 파싱해 여러 플랫폼에 재사용합니다.
items[]에 id(매물 id), 이름, 주소, 좌표, 전화번호, ext.listing의 최저 임대료, ext.apartments의 price_max, rent_by_bedroom[], specials, amenities[]
설명, 모든 사진, rating, reviews_count 추가
rent_by_bedroom[]에 beds(스튜디오는 0), beds_text, price_from, price_text
다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. Apartments.com은 사이드카가 아닙니다.
Next.js catch-all이 Hono 소셜 API로 라우팅합니다. request_id를 만들고 키를 인증한 뒤 분당 600회, 키당 동시 50개 한도를 적용합니다.
레지스트리에서 apartments 경로를 찾습니다. 필수 파라미터와 형식 검사를 먼저 합니다. 잘못된 입력은 과금 없이 400입니다. 유효 호출은 읽기를 시작하기 전에 티어 비용을 원자적으로 차감합니다.
platform + resource + params로 캐시 키를 만듭니다. 히트면 credits_used = 0으로 즉시 반환합니다. 미스면 공개 페이지를 실시간으로 읽으며 5xx나 네트워크 오류는 재시도하고 소스가 불안정하면 서킷 브레이커를 사용합니다.
Apartments.com 데이터를 Place와 PlaceList 아키타입으로 매핑하고 매물 정보를 place.ext.listing에 담아 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.
운영에서 중요한 과금 규칙
Apartments.com은 공개 읽기 데이터입니다. SocialCrawl 스키마로 정규화하므로 별도 벤더 SDK를 배울 필요가 없습니다.
미국 임대 건물에 대한 공개 검색 결과와 건물 페이지로, 침실 수별 임대료, 프로모션, 편의시설, 전화번호, 평점이 포함됩니다.
공개 페이지를 요청 시점에 읽어 서버에서 정규화합니다. Apartments.com 로그인이나 파트너 연동을 직접 운영할 필요가 없습니다.
검색은 PlaceList, 건물 하나는 Place입니다. 최저 임대료는 Zillow와 Redfin 매물과 같은 place.ext.listing에, 나머지는 place.ext.apartments에 담깁니다.
임대 신청, 투어 요청, 메시지, 저장한 검색은 제공하지 않습니다.
이 API가 가장 많이 사용되는 작업입니다.
지역별 임대료 비교, 프로모션, 임대 공급
호출은 지역의 건물을 검색해 임대료와 프로모션을 비교한 뒤 필요한 건물을 상세로 읽는 흐름입니다. Apartments.com 검색의 모든 건물에 대한 침실 수별 임대료, 현재 프로모션, 편의시설을 같은 키로 호출하며 Zillow와 Redfin 매물과 같은 공통 Place 스키마로 받습니다.
라이브 미스는 요청 시점에 공개 페이지를 읽습니다. 반복 호출은 캐시에서 0 크레딧으로 응답합니다.
이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.
지역을 search로 검색하고 건물별 침실 수당 최저 임대료를 비교합니다.
같은 링크로 search를 주기적으로 호출해 프로모션을 새로 시작하거나 끝낸 건물을 확인합니다.
property로 건물별 설명, 편의시설, 사진, 평점을 저장합니다.
Apartments.com의 두 경로는 모두 1 크레딧입니다. 캐시 히트는 무료입니다.
curl "https://www.socialcrawl.dev/v1/apartments/search?url=https%3A%2F%2Fwww.apartments.com%2Faustin-tx%2F" \n -H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/apartments/property?url=https%3A%2F%2Fwww.apartments.com%2Floyola-junction-i-austin-tx%2F940ms65%2F" \n -H "x-api-key: sc_your_api_key_here"모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기AI에게 SocialCrawl을 물어보세요