Real Estate

Zillow Property Listings

Every Zillow for-sale, rental and sold listing across the US, state by state, optionally with the full MLS record.

zillowzillowreal-estatelistingspropertiesmlsusa

467 rows in the dataset

Download the dataset

Get every row this scraper has collected as one CSV or JSONL file. If the data is older than maxAgeHours, the scraper is re-run with its configured settings first. The key needs the datasets:export scope.

DOWNLOAD_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/datasets/zillow/downloads" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{"maxAgeHours":24,"format":"csv"}' | jq -r '.id')while true; do  STATUS=$(curl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY" | jq -r '.status')  [ "$STATUS" != "refreshing" ] && break  sleep 5donecurl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID/file" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -o dataset.csv

At its current 467 rows, this download costs 5 credits when the data is fresh enough, or 10 credits when it has to be refreshed first.

The rate is 1 credit per 100 rows cached and 2 credits live, charged on the rows in the dataset when the download becomes ready. A failed refresh is not charged. The file stays downloadable for 24 hours. See pricing.

Start a run

To choose the targets yourself, send the parameters below as input. The call returns 202 with the run; the key needs the scrapers:run scope and the account a positive credit balance.

curl -X POST "https://api.pandorlabs.com/v1/scrapers/zillow/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "states": [        "AL"      ],      "locations": [        "Austin",        "TX / 78702 / Cleveland",        "OH"      ],      "markets": [        "forSale",        "forRent",        "sold"      ],      "soldWithin": "36m"    }  }'

A run is billed at the live rate once it finishes: 2 credits per 100 rows it collected. A run that collects nothing costs nothing.

Parameters

Every parameter is optional. Anything you leave out uses the default shown here; an unknown name or an invalid value is rejected with a 400 that lists each problem.

Targeting

states
enum[]
States
Each state is swept tile by tile until every listing is reached. Leave empty, with no locations either, to sweep all 50 states and DC.
Default
none
Allowed values
AL
AK
AZ
AR
CA
CO
CT
DE
DC
FL
GA
HI
ID
IL
IN
IA
KS
KY
LA
ME
MD
MA
MI
MN
MS
MO
MT
NE
NV
NH
NJ
NM
NY
NC
ND
OH
OK
OR
PA
RI
SC
SD
TN
TX
UT
VT
VA
WA
WV
WI
WY
locations
string[]
Locations
A city, ZIP or neighbourhood, as typed into Zillow's search box. Swept the same way as a state, in addition to any states picked.
Default
none
Example
Austin, TX / 78702 / Cleveland, OH
markets
enum[]
Markets
Rental results include whole buildings, which carry a price range rather than one price.
Default
["forSale","forRent","sold"]
Allowed values
forSale
forRent
sold
soldWithin
enum
Sold within
Applies to the sold market only. 36 months is everything Zillow keeps as sold — Michigan alone holds ~430k homes over that window; a weekly refresh only needs 7 or 30 days.
Default
36m
Allowed values
7
30
90
6m
12m
24m
36m
minPrice
number
Minimum price
Default
none
Range
at least 0
maxPrice
number
Maximum price
Default
none
Range
at least 0
minBeds
number
Minimum bedrooms
Default
none
Range
0 to 20
minBaths
number
Minimum bathrooms
Default
none
Range
0 to 20

Access

cookie
string
Browser cookie
Leave empty: the run mints its own PerimeterX tokens (_px3, _pxvid, pxcts) in the Chrome service and renews them when Zillow blocks. Set it only to override that with the Cookie header of a zillow.com request from your own browser (DevTools → Network → a request → Cookie).
Default
none
Example
zguid=…; _pxvid=…; pxcts=…; _px3=…

Advanced

fetchDetails
boolean
Fetch listing details
Adds year built, MLS id, parcel id, tax figures, schools and walk scores — at one extra request per listing.
Default
false
maxDetails
number
Max detail fetches per run
Independent of the listing ceiling. Details are the expensive half of a run.
Default
200
Range
0 to 10000
maxListings
number
Max listings per run
Rows persist and re-runs upsert, so a ceiling here bounds one run, not the dataset.
Default
50000000
Range
1 to 50000000
requestDelayMs
number
Delay between requests (ms)
Zillow blocks hard and slowly. Lowering this is how a run turns into a captcha wall.
Default
2000
Range
0 to 60000

Input as JSON Schema

The same schema the API validates against. Use it as a tool input schema or to generate a typed client.

inputSchema

{  "type": "object",  "additionalProperties": false,  "properties": {    "states": {      "type": "array",      "items": {        "type": "string",        "enum": [          "AL",          "AK",          "AZ",          "AR",          "CA",          "CO",          "CT",          "DE",          "DC",          "FL",          "GA",          "HI",          "ID",          "IL",          "IN",          "IA",          "KS",          "KY",          "LA",          "ME",          "MD",          "MA",          "MI",          "MN",          "MS",          "MO",          "MT",          "NE",          "NV",          "NH",          "NJ",          "NM",          "NY",          "NC",          "ND",          "OH",          "OK",          "OR",          "PA",          "RI",          "SC",          "SD",          "TN",          "TX",          "UT",          "VT",          "VA",          "WA",          "WV",          "WI",          "WY"        ]      },      "uniqueItems": true,      "title": "States",      "description": "Each state is swept tile by tile until every listing is reached. Leave empty, with no locations either, to sweep all 50 states and DC.",      "default": []    },    "locations": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Locations",      "description": "A city, ZIP or neighbourhood, as typed into Zillow's search box. Swept the same way as a state, in addition to any states picked.",      "default": [],      "examples": [        "Austin, TX / 78702 / Cleveland, OH"      ]    },    "markets": {      "type": "array",      "items": {        "type": "string",        "enum": [          "forSale",          "forRent",          "sold"        ]      },      "uniqueItems": true,      "title": "Markets",      "description": "Rental results include whole buildings, which carry a price range rather than one price.",      "default": [        "forSale",        "forRent",        "sold"      ]    },    "soldWithin": {      "type": "string",      "enum": [        "7",        "30",        "90",        "6m",        "12m",        "24m",        "36m"      ],      "title": "Sold within",      "description": "Applies to the sold market only. 36 months is everything Zillow keeps as sold — Michigan alone holds ~430k homes over that window; a weekly refresh only needs 7 or 30 days.",      "default": "36m"    },    "minPrice": {      "type": "number",      "minimum": 0,      "title": "Minimum price"    },    "maxPrice": {      "type": "number",      "minimum": 0,      "title": "Maximum price"    },    "minBeds": {      "type": "number",      "minimum": 0,      "maximum": 20,      "title": "Minimum bedrooms"    },    "minBaths": {      "type": "number",      "minimum": 0,      "maximum": 20,      "title": "Minimum bathrooms"    },    "cookie": {      "type": "string",      "maxLength": 2000,      "title": "Browser cookie",      "description": "Leave empty: the run mints its own PerimeterX tokens (_px3, _pxvid, pxcts) in the Chrome service and renews them when Zillow blocks. Set it only to override that with the Cookie header of a zillow.com request from your own browser (DevTools → Network → a request → Cookie).",      "examples": [        "zguid=…; _pxvid=…; pxcts=…; _px3=…"      ]    },    "fetchDetails": {      "type": "boolean",      "title": "Fetch listing details",      "description": "Adds year built, MLS id, parcel id, tax figures, schools and walk scores — at one extra request per listing.",      "default": false    },    "maxDetails": {      "type": "number",      "minimum": 0,      "maximum": 10000,      "title": "Max detail fetches per run",      "description": "Independent of the listing ceiling. Details are the expensive half of a run.",      "default": 200    },    "maxListings": {      "type": "number",      "minimum": 1,      "maximum": 50000000,      "title": "Max listings per run",      "description": "Rows persist and re-runs upsert, so a ceiling here bounds one run, not the dataset.",      "default": 50000000    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 60000,      "title": "Delay between requests (ms)",      "description": "Zillow blocks hard and slowly. Lowering this is how a run turns into a captcha wall.",      "default": 2000    }  }}

Run, poll, read rows

The run is asynchronous. Poll it until it reaches a terminal status and its billing is paid, then page through its rows. Until then the rows endpoint answers 409 (still queued or running) or 402 (payment required).

RUN_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/scrapers/zillow/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "states": [        "AL"      ],      "locations": [        "Austin",        "TX / 78702 / Cleveland",        "OH"      ],      "markets": [        "forSale",        "forRent",        "sold"      ],      "soldWithin": "36m"    }  }' | jq -r '.id')while true; do  RUN=$(curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY")  STATUS=$(echo "$RUN" | jq -r '.status')  BILLING=$(echo "$RUN" | jq -r '.billing.status')  case "$STATUS" in queued|running) ;; *) [ "$BILLING" != "pending" ] && break ;; esac  sleep 5doneecho "$RUN" | jq '{status, rowCount, billing}'curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID/rows?page=1&limit=100" \  -H "Authorization: Bearer $PANDORLABS_KEY"

See the API reference for pagination, cancelling and listing runs.

Output fields

Rows have no fixed schema; these are the fields observed in the rows collected so far. Coverage is the share of rows where the field is present.

Field	Type	Coverage
address	string	100%
bathrooms	number	79%
bedrooms	number	78%
broker_name	string	92%
city	string	97%
currency	string	97%
has_3d_model	boolean	100%
home_type	string	97%
image_url	string	100%
is_preforeclosure_auction	boolean	97%
latitude	number	100%
listing_status	string	100%
living_area	number	75%
longitude	number	100%
lot_area_unit	string	93%
lot_area_value	number	93%
price	number	97%
price_text	string	100%
rent_min	number	3%
rent_zestimate	number	29%
search_location	string	100%
state	string	100%
status_text	string	100%
street_address	string	97%
tax_assessed_value	number	58%
unit	string	32%
unit_count	number	3%
zestimate	number	25%
zipcode	string	97%
zpid	string	100%
created_at	date	100%
first_seen_at	date	100%
last_seen_at	date	100%
updated_at	date	100%
_id	string	100%