Zillow 상세 정보 API
API 상태
- 24시간 상태
- 정상
- 24시간 평균 소요 시간
- —
- 양호 / 정상
- 사용 가능
- 제한적
- 대부분 작동 중단
최근 24시간
최근 30일
homedetails 링크로 Zillow 매물 하나를 조회하며, 가격 이력, Zestimate 범위, 세금, HOA 비용, 학교, 매물 담당 중개인, MLS 번호가 포함됩니다. property_status는 주택의 알려진 상태에 대한 힌트일 뿐 검색 필터가 아니며, Zestimate는 감정평가가 아닙니다.
요금은 요청 1,000개당 $1.39(호출당 $0.001389)입니다. 실패한 호출과 빈 결과에는 과금하지 않습니다. 동기 방식입니다. 오래 걸리는 작업은 요청 본문에 "mode": "async"를 추가하고 job_id를 받아 폴링하세요.
AI 프롬프트
EveryInfra Zillow 상세 정보 엔드포인트(zillow/profile)를 사용하는 데이터 수집 스크립트 작성을 도와주세요.
엔드포인트 사용 방법:
- 요청: Authorization: Bearer <API 키> 헤더와 함께 POST https://api.everyinfra.com/api/v1/social로 보냅니다. 키는 EVERYINFRA_API_KEY 환경 변수에서 읽고, 절대 하드코딩하지 마세요.
- 요청 본문에서 platform은 zillow, action은 profile로 설정하고, 파라미터는 params 안에 넣습니다.
- 필수 파라미터:
- url: profile 또는 property_detail에 사용할 Zillow homedetails 매물 URL입니다. property_detail은 이 필드에 전체 도로명 주소도 받습니다. 매물 상세 URL을 검색 결과 URL 대신 사용할 수 없습니다.
- 선택 파라미터:
- property_status: 대상 profile 매물의 알려진 상태 힌트로, for_sale, recently_sold, for_rent 중 하나입니다. 지정한 매물 하나를 읽는 데 도움을 줄 뿐, 탐색용 필터가 아닙니다. (허용 값: for_rent / for_sale / recently_sold)
- 단일 객체를 반환합니다. 주요 필드: zpid, url, home_status, home_type, price, currency, address, city, state, zipcode, county, latitude; 전체 필드 43개, 전체 목록은 https://api.everyinfra.com/api/v1/social/catalog?platform=zillow.
- 요청 본문 예시:
{
"platform": "zillow",
"action": "profile",
"params": {
"url": "https://www.zillow.com/homedetails/6105-W-Club-Ln-Richmond-VA-23226/12345678_zpid/"
}
}
- 요금: 요청 1,000개당 $1.39. 실패하거나 빈 결과에는 과금하지 않습니다.
- 대상이 수십~수백 개라면 요청 본문에 "mode": "async"를 추가하세요. job_id를 즉시 받은 뒤 GET https://api.everyinfra.com/api/v1/jobs/{job_id}를 폴링해 결과를 가져옵니다.
- 422가 반환되면 오류에 제시된 파라미터 이름과 허용 값을 참고해 요청을 수정하고, 429 또는 503이 반환되면 Retry-After만큼 기다린 뒤 다시 시도합니다.
코드를 작성하기 전에 필요한 대상과 수량, 필드, 원하는 출력 형식을 먼저 물어봐 주세요. 그런 다음 계획과 대략적인 비용을 저와 확인해 주세요.요청 파라미터
| 이름 | 위치 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|---|
Authorization | header | string | 예 | - | Bearer 뒤에 API 키를 붙여 입력합니다. API 키는 콘솔에서 생성하며, URL이나 코드 저장소에 절대 넣지 마세요. |
platform | body | string | 예 | zillow | 플랫폼 식별자이며 고정값입니다. |
action | body | string | 예 | profile | 기능 식별자이며 고정값입니다. |
url | body.params | string | 예 | - | profile 또는 property_detail에 사용할 Zillow homedetails 매물 URL입니다. property_detail은 이 필드에 전체 도로명 주소도 받습니다. 매물 상세 URL을 검색 결과 URL 대신 사용할 수 없습니다. |
property_status | body.params | string (enum) | 아니요 | - | 대상 profile 매물의 알려진 상태 힌트로, for_sale, recently_sold, for_rent 중 하나입니다. 지정한 매물 하나를 읽는 데 도움을 줄 뿐, 탐색용 필터가 아닙니다.허용 값for_rentfor_salerecently_sold |
코드 샘플
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "zillow",
"action": "profile",
"params": {
"url": "https://www.zillow.com/homedetails/6105-W-Club-Ln-Richmond-VA-23226/12345678_zpid/"
}
}'OpenAPI 정의(JSON)샘플 코드는 EVERYINFRA_API_KEY 환경 변수에서 키를 읽으므로, 복사한 코드에는 API 키가 포함되지 않습니다.
응답 예시
September 26, 2026 at 08:56(UTC)에 위 코드 샘플의 파라미터로 이 API를 호출해 수집한 응답입니다. results와 count는 해당 호출의 실제 응답이며, 개인정보(이름, 핸들, 아바타, 프로필 링크, 연락처)는 제거했습니다. id, billing, quota는 호출할 때마다 달라지므로 형태만 표시합니다.
{
"id": "req_…",
"platform": "zillow",
"action": "profile",
"results": {
"zpid": 12345678,
"home_type": "SINGLE_FAMILY",
"beds": 3,
"baths": 3.5,
"area_sqft": 3187,
"year_built": 1980,
"zestimate": 786600,
"rent_zestimate": 3646,
"property_tax_rate": 0.72,
"last_sold_price": 325000,
"last_sold_at": "2018-04-30T00:00:00+00:00",
"days_on_zillow": 3071,
"photo_count": 1,
"description": "This 3187 square foot single family home has 3 bedrooms and 3.5 bathrooms. This home is located at 6105 W Club Ln, Richmond, VA 23226.",
"platform": "zillow"
},
"billing": {
"charged": …,
"charged_usd": …,
"balance_after_usd": …,
…
},
"quota": { … }
}응답 필드
비즈니스 데이터는 results에 담깁니다. 아래 표는 레코드에 포함될 수 있는 필드를 나열하며, 플랫폼에 표시되지 않는 값을 임의로 만들어 넣지 않습니다.
| 필드 | 의미 |
|---|---|
zpid | 플랫폼 자체의 의미를 따름 |
url | 플랫폼에서 해당 레코드로 연결되는 링크입니다. |
home_status | 플랫폼 자체의 의미를 따름 |
home_type | 플랫폼 자체의 의미를 따름 |
price | 통화 기호 없이 숫자로 표시한 가격입니다. currency를 참고하세요. |
currency | 가격의 통화 코드입니다(예: CNY, USD). price는 있는데 currency가 null이면 통화를 추정하지 마세요. |
address | 전체 주소로, 그대로 전달됩니다. |
city | 플랫폼 언어로 된 도시 이름으로, 정규화되지 않습니다. |
state | 플랫폼 자체의 의미를 따름 |
zipcode | 플랫폼 자체의 의미를 따름 |
county | 플랫폼 자체의 의미를 따름 |
latitude | 플랫폼 자체의 의미를 따름 |
longitude | 플랫폼 자체의 의미를 따름 |
beds | 플랫폼 자체의 의미를 따름 |
baths | 플랫폼 자체의 의미를 따름 |
area_sqft | 플랫폼 자체의 의미를 따름 |
lot_area_value | 플랫폼 자체의 의미를 따름 |
lot_area_unit | 플랫폼 자체의 의미를 따름 |
year_built | 플랫폼 자체의 의미를 따름 |
price_per_sqft | 플랫폼 자체의 의미를 따름 |
hoa_fee | 플랫폼 자체의 의미를 따름 |
has_garage | 플랫폼 자체의 의미를 따름 |
parking_capacity | 플랫폼 자체의 의미를 따름 |
zestimate | 플랫폼 자체의 의미를 따름 |
rent_zestimate | 플랫폼 자체의 의미를 따름 |
zestimate_low_percent | 플랫폼 자체의 의미를 따름 |
zestimate_high_percent | 플랫폼 자체의 의미를 따름 |
tax_assessed_value | 플랫폼 자체의 의미를 따름 |
tax_assessed_year | 플랫폼 자체의 의미를 따름 |
property_tax_rate | 플랫폼 자체의 의미를 따름 |
last_sold_price | 플랫폼 자체의 의미를 따름 |
last_sold_at | 플랫폼 자체의 의미를 따름 |
days_on_zillow | 플랫폼 자체의 의미를 따름 |
photo_count | 플랫폼 자체의 의미를 따름 |
description | 요약 또는 설명으로, 보통 text보다 짧습니다. |
listing_agent | 플랫폼 자체의 의미를 따름 |
listing_agent_phone | 플랫폼 자체의 의미를 따름 |
listing_broker | 플랫폼 자체의 의미를 따름 |
mls_id | 플랫폼 자체의 의미를 따름 |
mls_name | 플랫폼 자체의 의미를 따름 |
platform | 출처 플랫폼 식별자로, 요청의 platform과 같습니다(예: xiaohongshu, tiktok). |
images | 플랫폼 표시 순서대로 나열된 이미지 링크 배열입니다. 이미지가 없으면 필드가 생략됩니다. |
price_history | 플랫폼 자체의 의미를 따름 |
schools | 플랫폼 자체의 의미를 따름 |
오류 및 과금
- 401
- 키가 없거나 유효하지 않습니다.
- 402
- 잔액이 부족합니다. 먼저 충전하세요.
- 422
- 파라미터 이름 또는 값이 올바르지 않습니다. 오류에 제시된 제안을 참고해 수정하세요. 과금되지 않습니다.
- 429
- 분당 요청 속도 제한에 도달했습니다. Retry-After만큼 기다린 뒤 다시 시도하세요.
- 503
- 처리를 완료하지 못했습니다. 보류된 금액은 잔액으로 반환됩니다. 결과가 불확실하면 재시도하기 전에 먼저 확인하세요.
- 200 빈 결과
- 데이터가 없습니다. 과금되지 않습니다.
공식 참고 자료
객체와 용어를 확인하는 용도로만 사용합니다. 해당 플랫폼이 EveryInfra를 승인하거나 보증한다는 의미는 아닙니다.
- Zillow: Zestimate의 정의와 한계 ↗
Zillow는 Zestimate를 주거용 부동산의 시장 가치를 모델로 추정한 값으로 정의하며, 공식 감정평가가 아니고 이를 대신할 수도 없다고 명시합니다. 신뢰할 만한 데이터가 부족하면 추정값이 제공되지 않을 수 있습니다.
2026-09-04 확인
- Zillow: 임대 참고 지표인 Rent Zestimate ↗
Zillow는 Rent Zestimate를 임대 시세 조사의 출발점으로 제시하며, 주변 임대 매물도 함께 살펴볼 것을 권장합니다. Rent Zestimate는 매매 부동산 가치를 나타내는 Zestimate와 별개의 지표입니다.
2026-09-04 확인