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

# GET /zillow/market-data

`GET /zillow/market-data`

## Request

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

## Query parameters

- `family` string, required
- `geography` 'City' | 'County' | 'Metro' | 'National' | 'Neighborhood' | 'State' | 'Zip', required
- `segment` string, nullable
- `stat` string, nullable
- `variant` string, nullable
- `region_name` string, nullable
- `state` string, nullable
- `metro` string, nullable
- `county` string, nullable
- `limit` integer, nullable
- `offset` integer, nullable

## Response `200`

- object
  - `data` object, required
    - `places` unknown[], required
      - unknown
    - `places_available` integer, required
    - `total_rows_matched` integer, required
    - `offset` integer, required
    - `limit` integer, 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/1e1aa78ff103?raw)