Zillow 우편번호 검색 API

EveryInfra Zillow 우편번호 검색 엔드포인트(zillow/zip_search)를 사용하는 데이터 수집 스크립트 작성을 도와주세요.

엔드포인트 사용 방법:
- 요청: Authorization: Bearer <API 키> 헤더와 함께 POST https://api.everyinfra.com/api/v1/social로 보냅니다. 키는 EVERYINFRA_API_KEY 환경 변수에서 읽고, 절대 하드코딩하지 마세요.
- 요청 본문에서 platform은 zillow, action은 zip_search로 설정하고, 파라미터는 params 안에 넣습니다.
- 필수 파라미터:
  - zip: zip_search에 사용할 미국 ZIP 코드로, 앞자리 0이 유지되도록 5자리 문자열을 권장합니다. 쉼표나 공백으로 구분한 문자열과 ZIP 코드 배열도 받습니다. ZIP 코드를 여러 개 지정해도 실제 요청 과금 규칙이 그대로 적용되며 무료 일괄 처리가 아닙니다. ZIP 코드가 여러 개이면 limit은 ZIP 코드별 개수가 아니라 호출이 반환하는 전체 매물 수의 상한입니다.
- 선택 파라미터:
  - days_on_zillow: zip_search의 기간 프리셋입니다. 비워 두면 제한이 없고, 1, 7, 14, 30, 90은 일 단위, 6m, 12m, 24m, 36m은 월 단위입니다. 일반적으로 매물 등록 후 경과 기간을 뜻하지만, 거래 완료된 주택은 거래 후 경과 기간을 뜻합니다. 임의의 일수나 품질 판단이 아닙니다. (허용 값: 1 / 12m / 14 / 24m / 30 / 36m / 6m / 7)
  - for_rent: zip_search에 임대 매물을 포함하는 JSON 불리언입니다. 배타적이지 않으며 다른 상태 필터와 함께 사용할 수 있습니다. 문자열 "false"를 보내지 마세요.
  - for_sale_by_agent: zip_search에 중개인 등록 매물을 포함하는 JSON 불리언입니다. 소유자 직접 판매, 임대, 거래 완료 상태를 하나도 선택하지 않았을 때만 기본값이 true이며, 다른 상태를 선택하면 이 암묵적 기본값이 해제됩니다.
  - for_sale_by_owner: zip_search에 소유자 직접 등록 매물을 포함하는 JSON 불리언입니다. 거래에 수수료나 중개 비용이 없다는 것을 보장하지 않습니다.
  - max_price: search와 zip_search의 최대 매물 가격 필터입니다. zip_search에서는 price_max보다 우선합니다. Zillow 주택 가치 추정치의 상한이 아닙니다. 필터링은 정수 단위로 이루어지며 소수점은 올림 처리됩니다(145.98은 146).
  - min_price: search와 zip_search의 표준 최소 가격 필드입니다. zip_search에서는 price_min보다 우선합니다. 중개 수수료가 아닙니다. 필터링은 정수 단위로 이루어지며 소수점은 내림 처리됩니다(39.81은 39).
  - sold: zip_search에 거래 완료 주택을 포함하는 JSON 불리언입니다. 선택해도 모든 지역에서 공개 거래 금액이 제공된다고 보장하지 않습니다.
  - limit: 이 호출에서 반환할 최대 행 수로, 1~200 사이의 정수입니다. 생략하면 기본값이 적용되며, 실제 반환되는 행은 이보다 적을 수 있습니다. 더 큰 값을 지정하면 과금 전에 422를 반환합니다. (기본값: 20)
- 레코드 목록을 반환합니다. 각 레코드의 주요 필드: zpid, url, status, status_type, price, currency, address, street, city, state, zipcode, latitude; 전체 필드 29개, 전체 목록은 https://api.everyinfra.com/api/v1/social/catalog?platform=zillow.
- 요청 본문 예시:
{
  "platform": "zillow",
  "action": "zip_search",
  "params": {
    "zip": "78701"
  }
}
- 요금: 요청 1,000개당 $1.39. 실패하거나 빈 결과에는 과금하지 않습니다.
- 대상이 수십~수백 개라면 요청 본문에 "mode": "async"를 추가하세요. job_id를 즉시 받은 뒤 GET https://api.everyinfra.com/api/v1/jobs/{job_id}를 폴링해 결과를 가져옵니다.
- 422가 반환되면 오류에 제시된 파라미터 이름과 허용 값을 참고해 요청을 수정하고, 429 또는 503이 반환되면 Retry-After만큼 기다린 뒤 다시 시도합니다.

코드를 작성하기 전에 필요한 대상과 수량, 필드, 원하는 출력 형식을 먼저 물어봐 주세요. 그런 다음 계획과 대략적인 비용을 저와 확인해 주세요.