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 6 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):

Calculated fields

Calculated by PropertiesAPI from the returned fields; not Zillow estimates. They are plain arithmetic on the fields in the same response, never other data. Any figure whose inputs are missing, zero or don't apply to the home's status is null. Money is in USD rounded to cents, percentages to 2 decimals and ratios to 4 decimals. Fields of data.calculated:

Example

curl -G "https://api.propertiesapi.com/v1/zillow/property" \
  -H "x-api-key: $PROPERTIESAPI_KEY" \
  --data-urlencode "url=https://www.zillow.com/homedetails/2640-Steiner-St-San-Francisco-CA-94115/15073305_zpid/"

{
  "data": {
    "zpid": "15073305",
    "detailUrl": "https://www.zillow.com/homedetails/2640-Steiner-St-San-Francisco-CA-94115/15073305_zpid/",
    "address": "2640 Steiner St, San Francisco, CA 94115",
    "streetAddress": "2640 Steiner St",
    "unit": null,
    "city": "San Francisco",
    "state": "CA",
    "zipcode": "94115",
    "county": "San Francisco County",
    "neighborhood": null,
    "latitude": 37.79,
    "longitude": -122.44,
    "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/15073305-1.jpg",
    "photos": [
      "https://photos.example.com/15073305-1.jpg",
      "https://photos.example.com/15073305-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",
    "calculated": {
      "price_per_sqft": 285.33,
      "zestimate_per_sqft": 278.26,
      "rent_to_price_ratio": 0.0606,
      "rent_to_price_basis": "price",
      "gross_yield_pct": 6.06,
      "price_vs_zestimate_pct": 2.54,
      "last_sale_price": null,
      "last_sale_date": null,
      "change_since_last_sale_pct": null,
      "change_since_last_sale_basis": null,
      "days_on_market": 12,
      "price_drops_count": 0,
      "last_price_change": null
    }
  },
  "meta": {
    "credits": 1,
    "cached": false,
    "cache_key": "zpid:15073305",
    "fetched_at": "2026-10-19T14:02:11.000Z",
    "source": {
      "note": "Read from the public Zillow page. Field availability varies by listing. PropertiesAPI is not affiliated with Zillow."
    },
    "release": "v1",
    "took_ms": 14230,
    "completeness": {
      "fields": {
        "lotSize": {
          "availability": "supplied"
        },
        "propertyTaxRate": {
          "availability": "supplied"
        },
        "pageViewCount": {
          "availability": "not_returned"
        },
        "favoriteCount": {
          "availability": "not_returned"
        },
        "photos": {
          "availability": "supplied",
          "count": 2
        },
        "priceHistory": {
          "availability": "supplied",
          "count": 1
        },
        "taxHistory": {
          "availability": "supplied",
          "count": 1
        },
        "schools": {
          "availability": "empty_array",
          "count": 0
        },
        "virtualTourUrl": {
          "availability": "not_returned"
        },
        "dateSold": {
          "availability": "not_returned"
        }
      },
      "required": [],
      "missing": [],
      "requirements_satisfied": true
    }
  }
}

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, took_ms, completeness and, when there is something to check, warning. For some answers meta.source_age is "approximate": the source served a copy it may have collected earlier, so fetched_at (when we received it) can be a few hours later than when the data was collected; those answers stay in our cache for a shorter time.
• meta.source.note says where the data comes from: the property's public Zillow page. You're billed once per successful live lookup.
• 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 6 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.
• A page with no listing data at all (no price, beds, baths, size, available units or Zestimate; for example a building with no units listed) returns 404 not_found, not billed.
• Which fields are filled can depend on how the home was first looked up (by link, zpid or address), and the 24-hour cache keeps that first answer: for example the tax amounts, the tax rate and the view and favorite counts. When PropertiesAPI has collected the same home both ways within 24 hours, the result carries both sets (each value for at most a day after it was collected). meta.completeness says, for this response, which of the commonly missing fields were supplied, came back null or came back as an empty list.
• daysOnZillow is Zillow's own day count and is usually set for sold and off-market homes too. For days on market use calculated.days_on_market, which is null unless the home is listed.
• With raw=true, data.raw is the unmapped source record, untouched: values PropertiesAPI corrects in data (for example priceHistory[].priceChangeRate from some sources) are left as the source sent them there. It is unstable: its keys and casing depend on which source served the lookup, so they differ between lookups of the same home and change without notice. Don't parse it.
• Every response carries x-api-version and cache-control; authenticated requests also get the rate-limit headers, and account keys the credit headers (see Headers). Errors carry the same headers, plus retry-after when there is a wait to honor.
• 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.
• data.calculated has figures calculated by PropertiesAPI from the returned fields; not Zillow estimates: price and Zestimate per square foot, the rent-to-price ratio and gross yield, price vs Zestimate, the last sale and the change since it, days on market, and price drops. Each is null when its inputs are missing. The formulas are under Calculated fields.
• A building link (zillow.com/apartments/... or zillow.com/b/...) returns the building: address, photos and schools are the building listing's, zpid is null (use detailUrl as the building's id), 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.