100 free credits. No credit card required.Start building
Logo
Zillow logoZillow API

Get Zillow listing and price history data with one API

Fetch Zillow homes for sale, for rent and recently sold, with each home's price history and tax history, as structured JSON with one SocialCrawl API key. Reads are priced in credits.

Zillow logo
/v1/zillow

3 active endpoints. Search, property and locations.

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

What Zillow endpoints does SocialCrawl ship?

Three read endpoints for public Zillow data. Search an area for homes, read one home with its price and tax history, and look up the regions and addresses Zillow knows.

Home search

1 credit
/v1/zillow/search

Homes for sale, for rent or recently sold in a city, ZIP code, neighborhood, address or map box, with Zillow's total for the search. Each home has its zpid, address, coordinates, photos, price, beds, baths, square feet, lot size, home type, the Zestimate where Zillow shows one, and the broker. Rentals come back as buildings priced at their lowest base rent. Sold rows carry the sale price, and the sale date is in the property record. Standard tier (1 credit).

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

One home in full by zpid or listing link. Adds the description, year built, monthly HOA fee, days on Zillow, the listing date, the price history (each event's date, price, what happened and its source) and the yearly tax history with tax paid and assessed value. A zpid that does not exist answers 404 and is not charged. Standard tier (1 credit).

zpid, url

Place lookup

1 credit
/v1/zillow/locations

Zillow's suggestions for a place name or address. Regions (city, ZIP code, neighborhood, county) come with their Zillow region id and kind, and street addresses with their zpid. Use it to find the exact location to search. 10 suggestions by default, up to 100. Standard tier (1 credit).

query, type, limit, cursor

Zillow API3 endpoints supported
View docs
Listings
Reference

Returns Zillow homes for sale, for rent or sold in a place or map box, 41 a page, with price, beds, baths, size, coordinates and photos.

Use it to list a market's inventory or recent sales with price, size and home type filters.

1 credit

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"
idle
// Running this live needs your own API key. Hit "Try it" to see an example response

How the Zillow API works

Zillow is a normal SocialCrawl data surface. You call GET /v1/zillow/… with an API key, spend credits on live misses, and get a single JSON envelope back.

Authenticate every call

Send your key in the x-api-key header. No Zillow account or partner access is needed for public reads. The same key works across SocialCrawl platforms.

GET with query params

Search takes location or map_bounds, plus status, property type, price, beds, baths and square feet filters. Property takes zpid or url. Formats are validated before any charge.

Pay in credits, not seats

Every Zillow route costs 1 credit. Cache hits cost 0.

Read one JSON envelope

Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached. Lists also carry pagination when the route pages.

The usual integration chain

Most products name an area first, then read only the homes that matter.

01Look up the place
GET /v1/zillow/locations?query=…

PlaceList of regions and addresses

The region or address you pick is the location Zillow means.

02Search the area
GET /v1/zillow/search?location=…&status=…

PlaceList of homes with price, beds, baths and square feet

status picks for_sale, for_rent or sold. The returned cursor fetches the next page.

03Read the home
GET /v1/zillow/property?zpid=…

Place with price history and tax history

Take the zpid from a search row. A sold home's sale date is an event in its price history.

request
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
response envelope
{
  "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
}

What lands in data

Field names match the rest of SocialCrawl where archetypes align. Parse once, reuse across platforms.

PlaceListsearch

items[] with id (zpid), name, address, coordinates, photos, ext.listing with price, status, beds, baths, sqft, home_type, estimate, broker

Placeproperty

ext.listing adds description, year_built, hoa_fee, days_on_market, listed_at, price_history[], tax_history[]

PlaceList (locations)locations

items[] with the region id or zpid in id and the region kind in category

Price and tax historyproperty

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

Inside the gateway

Same request lifecycle as every other /v1 platform endpoint. Zillow is not a sidecar.

  1. 01

    Edge receives the call

    Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit (600/min) and concurrency (50 in flight per key).

  2. 02

    Validate, then debit

    Registry lookup finds the zillow route. Required params and format checks run first. Invalid input returns 400 with no charge. Valid calls debit the tier cost atomically before the read starts.

  3. 03

    Cache or fetch

    A deterministic cache key is built from platform + resource + params. Hit: return immediately, credits_used = 0. Miss: the public page is read live, with retries on 5xx or network errors and a circuit breaker if the source is unhealthy.

  4. 04

    Normalize and return

    Zillow data is mapped to the Place and PlaceList archetypes with the listing facts in place.ext.listing, validated, then wrapped in the success envelope and logged for billing audit.

Billing rules that matter in production

  • search, property and locations: 1 credit
  • Cache hit: 0 credits
  • Empty / hard fail: auto-refund
  • Bad params: 400, never charged
  • No credits: 402, never charged
  • Unknown zpid: 404, never charged
  • Search: up to 20 pages per search
  • Money in US dollars, areas in square feet
  • No agent contact, tour or offer tools

How SocialCrawl gets Zillow data

Zillow is public read data. We normalize it into the SocialCrawl schema so your code does not learn a second vendor SDK.

What Zillow is for this API

Public listing pages and search results for homes for sale, for rent and recently sold in the United States, with each home's price and tax history.

How SocialCrawl reaches it

Public pages are read on request and normalized server-side. You never run a Zillow login or partner integration.

What leaves our edge

PlaceList for searches and place lookups, and Place for one home. The listing facts sit in place.ext.listing, the same shape Redfin homes use.

What we do not ship live

No agent contact, tour requests, offers or saved searches.

field map sketch
Zillow home→ place.*zpid, street line, full address, coordinates
listing facts→ place.ext.listingprice, status, beds, baths, square feet, Zestimate
price and tax events→ place.ext.listing.price_history / tax_historydate, price, event and source; year, tax and assessment

What this API is used for

The jobs this API is most often used for.

3active Zillow endpoints in the registry
1credit per call on every Zillow route

Price tracking, sold comparables and rental supply

Callers search an area first, then read the homes that matter for their price and tax history. Price history and tax history for one home, plus for-sale, rental and sold search, from one key in the shared Place schema that Redfin homes also use.

Live misses read the public page on request. Repeat calls hit cache and cost 0 credits.

Use case examples

Common ways teams put this data to work, and the stack each one tends to run.

Price history tracking

Python, scheduled jobs

property by zpid to follow list price changes and read each watched home's full price history.

Sold comparables

Python, notebooks

search with status=sold for recent sales in an area, then property for each home's sale date and price.

Rental supply by building

Node, warehouse loads

search with status=for_rent to count rental buildings in an area and their lowest base rents.

How to call the Zillow API

Every Zillow route is 1 credit. Cache hits are free.

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 logoZillow on SocialCrawl

Same key as the rest of the catalog

Endpoints

What data does the Zillow API return?

Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.

FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

Contact us
What does the SocialCrawl Zillow API cover?
It covers 3 endpoints: Search, Property, and Locations. They search homes for sale, for rent and recently sold, read one home with its price history and tax history, and look up the regions and addresses Zillow knows, in the same unified JSON as the other 94 platforms.
Do I need a Zillow API key or partner approval?
No. You call SocialCrawl with one SocialCrawl API key, so there is no Zillow account, partner application or Zillow key to manage.
Can I get a Zillow home's price history?
Yes. GET /v1/zillow/property returns place.ext.listing.price_history, newest first, with each event's date, price, what happened and its source, back through earlier listings and sales. tax_history carries the yearly tax paid and assessed value.
Can I pull Zillow rentals and sold homes?
Yes. Set status to for_rent or sold on GET /v1/zillow/search. Rentals come back as buildings priced at their lowest base rent, and sold rows carry the sale price, with the sale date in the property record.
How much does the Zillow API cost?
Every Zillow route costs 1 credit a call and cache hits are free. A new account gets 100 free credits with no card.
Is scraping Zillow data legal?
SocialCrawl returns publicly available Zillow data and does not access private or login-gated content. Whether scraping fits your project depends on your use case and jurisdiction. You are responsible for complying with Zillow's terms of service and applicable data-protection laws such as GDPR and CCPA. This is general information, not legal advice.
Zillow scraping API vs the official Zillow API: what's the difference?
With SocialCrawl there is no app review or approval queue. Sign up and call Zillow endpoints immediately with a single x-api-key. Responses share one unified schema with every other SocialCrawl platform, and credit-based pricing replaces per-platform quotas. Official APIs are still the right choice for posting and other write actions: SocialCrawl is read-only data.

Ask AI about SocialCrawl

Read the Zillow API reference in the docs

🤖 AI agent or LLM? Read this page as markdown