Zillow property API

Get a home's details, price and Zestimate

curl --request POST \
  --url https://api.stophy.dev/v1/zillow/property \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "propertyUrl": "<string>",
  "propertyId": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({propertyUrl: '<string>', propertyId: '<string>'})
};

fetch('https://api.stophy.dev/v1/zillow/property', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.stophy.dev/v1/zillow/property"

payload = {
    "propertyUrl": "<string>",
    "propertyId": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "success": true,
  "data": {
    "propertyUrl": "<string>",
    "imageUrls": [
      "<string>"
    ],
    "priceHistory": [
      {
        "eventDate": "2023-12-25",
        "price": 123,
        "event": "<string>"
      }
    ],
    "facts": [
      {
        "name": "<string>",
        "value": "<string>"
      }
    ],
    "propertyId": "<string>",
    "status": "<string>",
    "homeType": "<string>",
    "price": 1,
    "priceCurrency": "USD",
    "zestimate": 123,
    "rentZestimate": 123,
    "lastSoldPrice": 123,
    "lastSoldAt": "2023-11-07T05:31:56Z",
    "addressFull": "<string>",
    "addressStreet": "<string>",
    "addressCity": "<string>",
    "addressRegion": "<string>",
    "addressPostalCode": "<string>",
    "latitude": 0,
    "longitude": 0,
    "bedrooms": 123,
    "bathrooms": 123,
    "sqft": 123,
    "lotSize": 123,
    "lotSizeUnit": "<string>",
    "yearBuilt": 0,
    "description": "<string>",
    "daysOnZillow": 0,
    "views": 0,
    "saves": 0,
    "monthlyHoa": 123,
    "propertyTaxRate": 123,
    "mlsId": "<string>",
    "mlsName": "<string>",
    "brokerName": "<string>",
    "brokerPhone": "<string>",
    "agentName": "<string>",
    "agentPhone": "<string>",
    "agentEmail": "<string>"
  },
  "creditsUsed": 123,
  "requestId": "<string>"
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

POST

zillow

property

Get a home's details, price and Zestimate

curl --request POST \
  --url https://api.stophy.dev/v1/zillow/property \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "propertyUrl": "<string>",
  "propertyId": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({propertyUrl: '<string>', propertyId: '<string>'})
};

fetch('https://api.stophy.dev/v1/zillow/property', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.stophy.dev/v1/zillow/property"

payload = {
    "propertyUrl": "<string>",
    "propertyId": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "success": true,
  "data": {
    "propertyUrl": "<string>",
    "imageUrls": [
      "<string>"
    ],
    "priceHistory": [
      {
        "eventDate": "2023-12-25",
        "price": 123,
        "event": "<string>"
      }
    ],
    "facts": [
      {
        "name": "<string>",
        "value": "<string>"
      }
    ],
    "propertyId": "<string>",
    "status": "<string>",
    "homeType": "<string>",
    "price": 1,
    "priceCurrency": "USD",
    "zestimate": 123,
    "rentZestimate": 123,
    "lastSoldPrice": 123,
    "lastSoldAt": "2023-11-07T05:31:56Z",
    "addressFull": "<string>",
    "addressStreet": "<string>",
    "addressCity": "<string>",
    "addressRegion": "<string>",
    "addressPostalCode": "<string>",
    "latitude": 0,
    "longitude": 0,
    "bedrooms": 123,
    "bathrooms": 123,
    "sqft": 123,
    "lotSize": 123,
    "lotSizeUnit": "<string>",
    "yearBuilt": 0,
    "description": "<string>",
    "daysOnZillow": 0,
    "views": 0,
    "saves": 0,
    "monthlyHoa": 123,
    "propertyTaxRate": 123,
    "mlsId": "<string>",
    "mlsName": "<string>",
    "brokerName": "<string>",
    "brokerPhone": "<string>",
    "agentName": "<string>",
    "agentPhone": "<string>",
    "agentEmail": "<string>"
  },
  "creditsUsed": 123,
  "requestId": "<string>"
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

Returns a home’s details, price and Zestimate. The property is identified by its URL or ID.

Request

Exactly one of propertyUrl or propertyId is required. A request that sets both, or none, fails with invalidRequest.

import { Stophy } from "stophy";

const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
const result = await stophy.zillow.property({ propertyUrl: "https://www.zillow.com/homedetails/123-Main-St-Austin-TX-78701/29383449_zpid/" });
console.log(result.data);

from stophy import Stophy

stophy = Stophy()  # reads STOPHY_API_KEY
result = stophy.zillow.property(property_url="https://www.zillow.com/homedetails/123-Main-St-Austin-TX-78701/29383449_zpid/")
print(result["data"])

curl -X POST https://api.stophy.dev/v1/zillow/property \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"propertyUrl":"https://www.zillow.com/homedetails/123-Main-St-Austin-TX-78701/29383449_zpid/"}'

stophy zillow property --propertyUrl https://www.zillow.com/homedetails/123-Main-St-Austin-TX-78701/29383449_zpid/

Response

If successful, the response body contains the standard envelope. data contains the home’s price, address, size, description, photos and facts. The following example is a real response, truncated: each list shows one item and long strings are cut.

{
  "success": true,
  "data": {
    "propertyId": "29399286",
    "propertyUrl": "https://www.zillow.com/homedetails/106-W-32nd-St-Austin-TX-78705/29399286_zpid/",
    "status": "FOR_SALE",
    "homeType": "SINGLE_FAMILY",
    "price": 2200000,
    "priceCurrency": "USD",
    "addressFull": "106 W 32nd St, Austin, TX 78705",
    "addressStreet": "106 W 32nd St",
    "addressCity": "Austin",
    "addressRegion": "TX",
    "addressPostalCode": "78705",
    "latitude": 30.297354,
    "longitude": -97.736565,
    "bedrooms": 4,
    "bathrooms": 3,
    "sqft": 2911,
    "lotSize": 9801,
    "lotSizeUnit": "Square Feet",
    "yearBuilt": 1925,
    "description": "The Spurgeon Bell House is a designated City of Austin historic landmark located in the Aldridge Place Historic…",
    "imageUrls": ["https://photos.zillowstatic.com/fp/53de2e39052ef79395ed54f9e73dfded-uncropped_scaled_within_1536_1152.jpg"],
    "daysOnZillow": 2,
    "views": 772,
    "saves": 77,
    "propertyTaxRate": 1.46,
    "mlsId": "7637220",
    "mlsName": "Unlock MLS",
    "brokerName": "Kuper Sotheby's Int'l Realty",
    "brokerPhone": "+1 555 0100",
    "facts": [
      {
        "name": "bathrooms",
        "value": "3"
      }
    ]
  },
  "creditsUsed": 2,
  "requestId": "2fe9dbad-fc48-4890-9751-0b24b596035b"
}

Field	Type	Description
`price`	number	Asking price, monthly rent, or the sale price of a sold home. Omitted when Zillow shows none, such as for sold homes in states that keep sale prices private.
`daysOnZillow`	integer	The number of days since the home was listed.

For every field, see the response schema on this page.

Billing

Each successful request consumes 2 credits, regardless of the number of items returned. Requests that fail, or that return no items, are not billed.

Pagination

This method is not paginated. A single request returns the complete result.

Zillow search: Accepts the home’s addressCity and addressRegion as location. Searches homes for sale, for rent or sold.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

propertyUrl

string

Link to the Zillow property, like https://www.zillow.com/homedetails/123-Main-St-Austin-TX-78701/29383449_zpid/. Send this or propertyId.

propertyId

string

Zillow property id, like 29383449. Send this or propertyUrl.

Response

The data, and the credits this call used.

success

any

required

data

object

required

Show child attributes

creditsUsed

integer

required

requestId

string

required

Using the API

Catalog

Account

Search and AI answers

Video

Social

Places and travel

Jobs

Shopping

Apps

Real estate

Ads

Zillow property API

Request

Response

Billing

Authorizations

Body

Response

​Request

​Response

​Billing

​Pagination

​Related methods

Authorizations

Body

Response

Request

Response

Billing

Pagination

Related methods