100 크레딧 무료, 카드 등록 없이지금 시작하기
Logo
Zillow logoZillow API

Zillow 매물과 가격 이력 데이터 API

SocialCrawl API 키로 Zillow의 매매, 임대, 최근 거래 매물과 매물별 가격 이력, 세금 이력을 구조화 JSON으로 가져옵니다. 호출은 크레딧으로 과금됩니다.

Zillow logo
/v1/zillow

활성 엔드포인트는 3개입니다. 매물 검색, 매물 상세, 지역 검색을 지원합니다.

  • GET /v1/zillow/search
  • GET /v1/zillow/property
  • GET /v1/zillow/locations

Zillow 엔드포인트

공개 Zillow 데이터를 읽는 엔드포인트는 3개입니다. 지역별 매물 검색, 가격 이력과 세금 이력이 포함된 매물 상세, Zillow가 인식하는 지역과 주소 검색을 지원합니다.

매물 검색

1 크레딧
/v1/zillow/search

도시, ZIP 코드, 동네, 주소 또는 지도 범위 안의 매매, 임대, 최근 거래 매물을 Zillow의 전체 검색 결과 수와 함께 반환합니다. 매물마다 zpid, 주소, 좌표, 사진, 가격, 침실과 욕실 수, 면적(제곱피트), 대지 면적, 주택 유형, 중개사가 포함되며 Zillow가 표시하는 경우 Zestimate도 포함됩니다. 임대 매물은 건물 단위로 반환되며 가격은 해당 건물의 최저 기본 임대료입니다. 거래 완료 행에는 거래 가격이 있고 거래일은 매물 상세에서 확인합니다. 표준 티어(1 크레딧)입니다.

location, map_bounds, status, property_type, sort, price_min, price_max, beds_min, beds_max, baths_min, sqft_min, sqft_max, cursor

/v1/zillow/property

zpid 또는 매물 링크로 매물 하나를 전체 정보로 반환합니다. 설명, 건축 연도, 월 HOA 관리비, Zillow 게시 일수, 게시일, 가격 이력, 세금 이력이 추가됩니다. 가격 이력에는 이벤트별 날짜, 가격, 내용, 출처가 포함되고 세금 이력에는 연도별 납부 세액과 평가액이 포함됩니다. 존재하지 않는 zpid는 404로 응답하며 과금되지 않습니다. 표준 티어(1 크레딧)입니다.

zpid, url

지역 검색

1 크레딧
/v1/zillow/locations

장소 이름이나 주소에 대한 Zillow의 추천 결과를 반환합니다. 지역(도시, ZIP 코드, 동네, 카운티)에는 Zillow 지역 id와 종류가 포함되고 주소에는 zpid가 포함됩니다. 검색에 넘길 정확한 location을 찾을 때 사용합니다. 기본 10개, 최대 100개를 반환합니다. 표준 티어(1 크레딧)입니다.

query, type, limit, cursor

Zillow API3개 엔드포인트 지원
문서 보기
Listings
Reference

지역이나 지도 범위 안의 매매, 임대, 거래 완료 Zillow 매물을 한 페이지에 41건씩 가격, 침실과 욕실 수, 면적, 좌표, 사진과 함께 반환합니다.

가격, 면적, 주택 유형으로 걸러 한 지역의 매물이나 최근 거래를 볼 때 사용하세요.

1크레딧

GET/v1/zillow/search?location=Austin%2C+TX
$ curl https://www.socialcrawl.dev/v1/zillow/search?location=Austin%2C+TX \
    -H "x-api-key: sc_YOUR_API_KEY"
대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다

Zillow API 동작

Zillow도 다른 SocialCrawl 데이터 엔드포인트와 같습니다. API 키로 GET /v1/zillow/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다.

호출 인증

x-api-key 헤더에 키를 보냅니다. 공개 읽기에 Zillow 계정이나 파트너 권한은 필요 없습니다. SocialCrawl 전 플랫폼에 같은 키를 사용합니다.

GET과 쿼리 파라미터

검색은 location 또는 map_bounds와 함께 status, 주택 유형, 가격, 침실, 욕실, 면적 필터를 받습니다. 매물 상세는 zpid 또는 url을 받습니다. 과금 전에 형식을 검증합니다.

크레딧 과금

Zillow의 모든 경로는 1 크레딧입니다. 캐시 히트는 0입니다.

JSON 봉투

응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 페이지가 있는 목록 응답은 페이지네이션 필드를 가집니다.

연동 순서

대부분 제품은 지역을 먼저 정한 뒤 필요한 매물만 상세로 읽습니다.

01지역 확인
GET /v1/zillow/locations?query=…

지역과 주소가 담긴 PlaceList

선택한 지역이나 주소가 Zillow가 인식하는 location이 됩니다.

02지역 매물 검색
GET /v1/zillow/search?location=…&status=…

가격, 침실, 욕실, 면적이 있는 매물 PlaceList

status로 for_sale, for_rent, sold 중 하나를 고릅니다. 다음 페이지는 반환된 cursor로 받습니다.

03매물 읽기
GET /v1/zillow/property?zpid=…

가격 이력과 세금 이력이 있는 Place

zpid는 검색 결과 행에서 가져옵니다. 거래 완료 매물의 거래일은 가격 이력의 이벤트로 확인합니다.

요청
GET /v1/zillow/search?location=Austin%2C+TX&status=sold
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here

GET /v1/zillow/property?zpid=70344560
응답 봉투
{
  "success": true,
  "data": {
    "place": {
      "id": "70344560",
      "name": "5810 Vasey Blvd",
      "address": "5810 Vasey Blvd, Austin, TX 78724",
      "ext": {
        "listing": {
          "price": 250000,
          "currency": "USD",
          "status": "for_sale",
          "beds": 4,
          "baths": 3,
          "sqft": 1952,
          "year_built": 2006,
          "price_history": [
            {
              "date": "2026-11-05",
              "price": 250000,
              "event": "priceChange",
              "source": "Unlock MLS"
            }
          ]
        }
      }
    }
  },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

data 형태

아키타입이 맞는 범위에서 필드 이름은 SocialCrawl 나머지와 같습니다. 한 번 파싱해 여러 플랫폼에 재사용합니다.

PlaceListsearch

items[]에 id(zpid), 이름, 주소, 좌표, 사진, ext.listing의 가격, status, 침실, 욕실, sqft, home_type, estimate, 중개사

Placeproperty

ext.listing에 설명, year_built, hoa_fee, days_on_market, listed_at, price_history[], tax_history[] 추가

PlaceList (지역 검색)locations

items[]의 id에 지역 id 또는 zpid, category에 지역 종류

가격 이력과 세금 이력property

price_history[]에 date, price, event, source, tax_history[]에 year, tax, assessment

게이트웨이 내부

다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. Zillow는 사이드카가 아닙니다.

  1. 01

    엣지가 호출을 받음

    Next.js catch-all이 Hono 소셜 API로 라우팅합니다. request_id를 만들고 키를 인증한 뒤 분당 600회, 키당 동시 50개 한도를 적용합니다.

  2. 02

    검증 후 차감

    레지스트리에서 zillow 경로를 찾습니다. 필수 파라미터와 형식 검사를 먼저 합니다. 잘못된 입력은 과금 없이 400입니다. 유효 호출은 읽기를 시작하기 전에 티어 비용을 원자적으로 차감합니다.

  3. 03

    캐시 또는 수집

    platform + resource + params로 캐시 키를 만듭니다. 히트면 credits_used = 0으로 즉시 반환합니다. 미스면 공개 페이지를 실시간으로 읽으며 5xx나 네트워크 오류는 재시도하고 소스가 불안정하면 서킷 브레이커를 사용합니다.

  4. 04

    정규화 후 반환

    Zillow 데이터를 Place와 PlaceList 아키타입으로 매핑하고 매물 정보를 place.ext.listing에 담아 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.

운영에서 중요한 과금 규칙

  • search, property, locations: 1 크레딧
  • 캐시 히트: 0 크레딧
  • 빈 응답 / 하드 실패: 자동 환불
  • 잘못된 파라미터: 400, 과금 없음
  • 크레딧 부족: 402, 과금 없음
  • 없는 zpid: 404, 과금 없음
  • 검색은 검색당 최대 20페이지
  • 금액은 미국 달러, 면적은 제곱피트
  • 중개사 연락·투어·오퍼 도구 없음

Zillow 데이터 수집 방식

Zillow는 공개 읽기 데이터입니다. SocialCrawl 스키마로 정규화하므로 별도 벤더 SDK를 배울 필요가 없습니다.

이 API에서 Zillow의 의미

미국의 매매, 임대, 최근 거래 매물에 대한 공개 매물 페이지와 검색 결과, 매물별 가격 이력과 세금 이력입니다.

SocialCrawl 수집 경로

공개 페이지를 요청 시점에 읽어 서버에서 정규화합니다. Zillow 로그인이나 파트너 연동을 직접 운영할 필요가 없습니다.

엣지에서 나가는 형태

검색과 지역 검색은 PlaceList, 매물 하나는 Place입니다. 매물 정보는 place.ext.listing에 담기며 Redfin 매물과 같은 형태입니다.

라이브로 제공하지 않는 것

중개사 연락, 투어 요청, 오퍼, 저장한 검색은 제공하지 않습니다.

필드 매핑
Zillow home→ place.*zpid, 도로명 주소, 전체 주소, 좌표
listing facts→ place.ext.listing가격, status, 침실, 욕실, 면적, Zestimate
price and tax events→ place.ext.listing.price_history / tax_history날짜, 가격, 이벤트, 출처와 연도, 세액, 평가액

이 API의 활용 분야

이 API가 가장 많이 사용되는 작업입니다.

3active Zillow endpoints in the registry
1Zillow 전 경로의 호출당 크레딧

가격 추적, 거래 사례 비교, 임대 공급 분석

호출은 지역 검색에서 시작해 중요한 매물의 가격 이력과 세금 이력으로 이어집니다. 매물별 가격 이력과 세금 이력, 매매·임대·거래 완료 검색을 같은 키로 호출하며 Redfin 매물과 같은 공통 Place 스키마로 받습니다.

라이브 미스는 요청 시점에 공개 페이지를 읽습니다. 반복 호출은 캐시에서 0 크레딧으로 응답합니다.

활용 사례

이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.

가격 이력 추적

Python, 예약 작업

zpid로 property를 호출해 관심 매물의 호가 변동과 전체 가격 이력을 확인합니다.

거래 사례 비교

Python, notebooks

status=sold로 search를 호출해 지역의 최근 거래를 찾고 property로 매물별 거래일과 거래 가격을 확인합니다.

건물별 임대 공급

Node, 웨어하우스 적재

status=for_rent로 search를 호출해 지역의 임대 건물 수와 건물별 최저 기본 임대료를 집계합니다.

Zillow API 호출 방법

Zillow의 모든 경로는 1 크레딧입니다. 캐시 히트는 무료입니다.

curl "https://www.socialcrawl.dev/v1/zillow/search?location=Austin%2C+TX&status=for_sale&price_max=600000&beds_min=3" \
  -H "x-api-key: sc_your_api_key_here"
curl "https://www.socialcrawl.dev/v1/zillow/property?zpid=70344560" \
  -H "x-api-key: sc_your_api_key_here"
Zillow logoSocialCrawl의 Zillow

카탈로그 전 구간과 같은 키

엔드포인트

Zillow API는 어떤 데이터를 돌려주나요

모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.

자주 묻는 질문

자주 묻는 질문

API, 요금제, 기능에 대한 질문과 답변입니다.

문의하기
SocialCrawl 질로우 API는 무엇을 제공하나요?
엔드포인트 3종(Search, Property, and Locations)으로 매매, 임대, 최근 거래 매물 검색과 매물별 가격 이력, 세금 이력, 지역과 주소 검색을 받아요. 다른 94개 플랫폼과 같은 통합 JSON으로 와요.
질로우 API 키나 파트너 승인이 필요한가요?
아니요. SocialCrawl API 키 하나로 호출하니 질로우 계정이나 파트너 신청, 질로우 키 관리가 필요 없어요.
질로우 매물의 가격 이력을 받을 수 있나요?
네, GET /v1/zillow/property가 place.ext.listing.price_history에 이벤트별 날짜, 가격, 내용, 출처를 최신순으로 담아 보내요. 이전 매물 등록과 거래까지 이어지고, tax_history에는 연도별 납부 세액과 평가액이 들어 있어요.
임대 매물과 거래 완료 매물도 볼 수 있나요?
네, GET /v1/zillow/search에 status=for_rent나 status=sold를 넣으면 돼요. 임대 매물은 건물 단위로 최저 기본 임대료와 함께 오고, 거래 완료 매물은 거래 가격이 오며 거래일은 매물 상세에서 확인해요.
질로우 API는 크레딧이 얼마나 드나요?
질로우의 모든 경로가 호출당 1 크레딧이고 캐시 히트는 무료예요. 새 계정은 카드 없이 무료 100 크레딧을 받아요.
Zillow 데이터 스크래핑, 법적으로 괜찮을까요?
SocialCrawl은 누구나 볼 수 있는 공개 Zillow 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. Zillow 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.
Zillow 스크래핑 API와 공식 Zillow API는 뭐가 다른가요?
SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 Zillow 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧으로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요. SocialCrawl은 읽기 전용 데이터만 다뤄요.

AI에게 SocialCrawl을 물어보세요

Zillow API 레퍼런스 문서 보기

🤖 AI 에이전트나 LLM이신가요? 이 페이지를 markdown으로 읽어보세요