Zillow property lookup

GEThttps://api.propertiesapi.com/v1/zillow/property

One property by Zillow URL or address: listing price and status, Zestimate, rent Zestimate, beds, baths, living area, lot, year built, home type, photo URLs, days on Zillow, price history, tax history, schools, broker and agent.

At a glance

• Billing: 1 credit per successful live lookup, by Zillow link or address. Repeat lookups of the same home within 24 hours come from cache and are free. Errors aren't billed.
• Auth: x-api-key header.
• Latency: typically 8 seconds, up to about 20 for a live lookup; repeat lookups within 24 hours come from the cache, with no live lookup.
• Replaces: the old GetSearchResults, GetDeepSearchResults, GetZestimate and GetUpdatedPropertyDetails calls from the retired Zillow API.

Parameters

Send exactly one of url or address.

Other parameters

Response fields

The body is { data, meta }. Fields of data (any can be null; lists can be empty):

Example

curl -G "https://api.propertiesapi.com/v1/zillow/property" \
  -H "x-api-key: $PROPERTIESAPI_KEY" \
  --data-urlencode "url=https://www.zillow.com/homedetails/1600-Main-St-Austin-TX-78701/0000000_zpid/"

{
  "data": {
    "zpid": "0000000",
    "detailUrl": "https://www.zillow.com/homedetails/1600-Main-St-Austin-TX-78701/0000000_zpid/",
    "address": "1600 Main St, Austin, TX 78701",
    "streetAddress": "1600 Main St",
    "unit": null,
    "city": "Austin",
    "state": "TX",
    "zipcode": "78701",
    "county": "Travis County",
    "neighborhood": null,
    "latitude": 30.27,
    "longitude": -97.74,
    "price": 525000,
    "currency": "USD",
    "homeStatus": "FOR_SALE",
    "statusText": "For sale",
    "homeType": "SINGLE_FAMILY",
    "beds": 3,
    "baths": 2,
    "livingArea": 1840,
    "lotSize": 6970,
    "yearBuilt": 1998,
    "pricePerSquareFoot": 285,
    "zestimate": 512000,
    "rentZestimate": 2650,
    "daysOnZillow": 12,
    "datePosted": "2026-10-07",
    "dateSold": null,
    "lastSoldPrice": null,
    "monthlyHoaFee": null,
    "taxAnnualAmount": 9840,
    "taxAssessedValue": 498000,
    "propertyTaxRate": 1.98,
    "pageViewCount": null,
    "favoriteCount": null,
    "parcelId": null,
    "description": "Three-bedroom home near downtown.",
    "imgSrc": "https://photos.example.com/0000000-1.jpg",
    "photos": [
      "https://photos.example.com/0000000-1.jpg",
      "https://photos.example.com/0000000-2.jpg"
    ],
    "photoCount": 2,
    "brokerName": "Example Realty",
    "brokerPhone": null,
    "agentName": null,
    "agentPhone": null,
    "agentLicenseNumber": null,
    "mlsId": null,
    "mlsName": null,
    "priceHistory": [
      {
        "date": "2026-10-07",
        "event": "Listed for sale",
        "price": 525000,
        "pricePerSquareFoot": 285,
        "priceChangeRate": null,
        "source": "Example MLS"
      }
    ],
    "taxHistory": [
      {
        "year": 2025,
        "taxPaid": 9840,
        "value": 498000,
        "taxIncreaseRate": null,
        "valueIncreaseRate": null
      }
    ],
    "schools": [],
    "virtualTourUrl": null,
    "scrapedAt": "2026-10-19T14:02:11.000Z"
  },
  "meta": {
    "credits": 1,
    "cached": false,
    "cache_key": "zpid:0000000",
    "fetched_at": "2026-10-19T14:02:11.000Z",
    "source": {
      "provider": "self_hosted",
      "collector": "propertiesapi/zillow-page-v1",
      "note": "Read from the public Zillow page by our collector. Field availability varies by listing. PropertiesAPI is not affiliated with Zillow."
    },
    "release": "v1",
    "took_ms": 14230
  }
}

Example values are illustrative, not a real record. Fields Zillow doesn't show for a property come back as null. Data is provided as-is.

Notes

• Send exactly one of url, zpid or address. Sending none returns 400 missing_param; sending several returns 400 bad_param.
• The body is { data, meta }. data is the property; meta has credits, cached, cache_key, fetched_at, source, release and took_ms.
• meta.source says who read the page: provider self_hosted (our collector, reading the public Zillow page) or apify (an Apify actor, used as a fallback when our collector can't read the page; then source.fallback_from is self_hosted). You're billed once either way.
• The x-cache response header is HIT when the result came from the 24-hour cache (free, no live lookup) and MISS when it was fetched live.
• A live lookup typically takes 8 seconds, up to about 20. Set a client timeout of at least 120 seconds: an occasional lookup takes longer.
• Fields Zillow doesn't show for a property come back as null. Don't treat null as zero.
• price is the listing price (monthly rent for rentals). zestimate and rentZestimate are Zillow's own estimates, returned only when Zillow shows them. PropertiesAPI doesn't make estimates of its own.
• An apartment-building link (zillow.com/apartments/...) returns the building: zpid, address, photos and schools are the building listing's, and price, beds, baths, livingArea and unit come from its lowest-priced unit available now (no move-in date, or one on or before the lookup date; if none is available yet, its lowest-priced unit). The other units aren't returned yet.
• photos is a list of image URLs. priceHistory, taxHistory and schools are lists and can be empty.
• Data is provided as-is, as shown on the public Zillow page at the time of the lookup. It isn't official and isn't guaranteed to be accurate or complete.

Errors

Errors are { error: { code, message, details? }, meta: { took_ms } } with status 400, 401, 404, 422, 500, 502, 503 or 504. Errors aren't billed. See errors.

Zillow is a trademark of Zillow, Inc. PropertiesAPI is an independent service and is not affiliated with, endorsed by or sponsored by Zillow.