---
title: "GET /zillow/search"
method: GET
path: "/zillow/search"
tags: ["Zillow"]
---

# GET /zillow/search

`GET /zillow/search`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/zillow/search`
- Auth: API key in header `X-API-KEY`

## Query parameters

- `latitude` number, nullable
- `longitude` number, nullable
- `radius_mi` number, nullable
- `north_latitude` number, nullable
- `south_latitude` number, nullable
- `east_longitude` number, nullable
- `west_longitude` number, nullable
- `region_ids[]` integer[]
- `region_id_type` integer, nullable
- `polygon` string, nullable
- `listing_category` 'all' | 'category1' | 'category2' | 'null', nullable
- `sort_order` 'baths' | 'yearBuilt' | 'price' | 'relevance' | 'beds' | 'daysOn' | 'featured' | 'livingArea' | 'lotArea' | 'nearby' | 'recentlyChanged' | 'rentalDays' | 'rentalPriorityScore' | 'null', nullable
- `sort_ascending` boolean, nullable
- `min_price` integer, nullable
- `max_price` integer, nullable
- `min_beds` integer, nullable
- `max_beds` integer, nullable
- `min_baths` integer, nullable
- `max_baths` integer, nullable
- `living_area_min` integer, nullable
- `lot_size_min` integer, nullable
- `year_built_min` integer, nullable
- `home_statuses[]` string[]
- `keywords` string, nullable
- `zoom_level` integer, nullable
- `include_off_market` boolean, nullable
- `allow_empty` boolean, nullable
- `page` integer, nullable
- `page_size` integer, nullable

## Response `200`

- object
  - `data` object, required
    - `listings` unknown[], required
      - unknown
    - `count` integer, required
    - `total_matching_count` integer, required
    - `freshness` string[], required

## Other responses

- `400`: A query parameter is missing, malformed, or outside its documented range. This is the only Zillow response that carries no error code: the body has a message and a field list and nothing else, so match it on the 400 status.
- `401`: Unauthorized - API key is missing or invalid
- `422`: The requested research file does not exist for the combination given. The family, geography and variant given do not identify a single research file.
- `503`: The request reached the source, but what came back was a challenge or rate-limit page rather than the data. The request was served and answered with a 5xx.

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/2f4af6143d10?raw)