> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stophy.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Real estate

> Search homes for sale, for rent, and sold on Zillow with more than 20 filters. Get the price, photos, and details for any listing as JSON.

Search homes for sale, for rent, and sold on Zillow with more than 20 filters. Get the price, photos, and details for any listing as JSON. See every field in the [Real estate reference](/api-reference/endpoint/zillow-search), or try it in the [playground](https://stophy.dev/playground).

## Search homes for sale, for rent or sold

<CodeGroup>
  ```typescript TypeScript icon="https://mintcdn.com/sirathic/7E4w9-IC4ysabjfc/images/icons/typescript.svg?fit=max&auto=format&n=7E4w9-IC4ysabjfc&q=85&s=d8272a85e64145620f1fbbfcf7932986" theme={null}
  import { Stophy } from "stophy";

  const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
  const result = await stophy.zillow.search({ location: "Austin, TX", daysOnZillow: "30Days", hasPool: true });
  console.log(result.data.results);
  ```

  ```python Python icon="python" theme={null}
  from stophy import Stophy

  stophy = Stophy()  # reads STOPHY_API_KEY
  result = stophy.zillow.search(location="Austin, TX", days_on_zillow="30Days", has_pool=True)
  print(result["data"]["results"])
  ```

  ```bash cURL icon="terminal" theme={null}
  curl -X POST https://api.stophy.dev/v1/zillow/search \
    -H "Authorization: Bearer $STOPHY_API_KEY" \
    -H "content-type: application/json" \
    -d '{"location":"Austin, TX","daysOnZillow":"30Days","hasPool":true}'
  ```

  ```bash CLI icon="square-terminal" theme={null}
  stophy zillow search "Austin, TX" --daysOnZillow 30Days --hasPool
  ```
</CodeGroup>

The response:

```json theme={null}
{
  "success": true,
  "data": {
    "total": 1234,
    "results": [
      {
        "propertyId": "abc123",
        "propertyUrl": "https://example.com/",
        "status": "forSale",
        "statusText": "example",
        "price": 19.99,
        "priceCurrency": "USD",
        "addressFull": "example",
        "addressStreet": "example",
        "addressCity": "example",
        "addressRegion": "example",
        "addressPostalCode": "example",
        "latitude": 1,
        "longitude": 1,
        "bedrooms": 1,
        "bathrooms": 1,
        "sqft": 1,
        "homeType": "example",
        "daysOnZillow": 1,
        "lastSoldAt": "2026-09-28T12:00:00.000Z",
        "zestimate": 1,
        "rentZestimate": 1,
        "brokerName": "example",
        "imageUrl": "https://example.com/image.jpg",
        "buildingName": "example",
        "buildingMinRent": 1,
        "buildingMaxRent": 1,
        "buildingAvailableUnits": 1,
        "units": [
          {
            "bedrooms": 1,
            "price": 19.99
          }
        ]
      }
    ],
    "page": 1,
    "totalPages": 1234
  },
  "creditsUsed": 2,
  "requestId": "b0128a30-e624-4c2d-a36d-71cfccc624e3"
}
```

## Endpoints

| Endpoint | Cost |
| - | - |
| [Search homes for sale, for rent or sold](/api-reference/endpoint/zillow-search) | 2 credits |
| [Get a home's details, price and Zestimate](/api-reference/endpoint/zillow-property) | 2 credits |

## More ways to call it

### Get a home's details, price and Zestimate

<CodeGroup>
  ```typescript TypeScript icon="https://mintcdn.com/sirathic/7E4w9-IC4ysabjfc/images/icons/typescript.svg?fit=max&auto=format&n=7E4w9-IC4ysabjfc&q=85&s=d8272a85e64145620f1fbbfcf7932986" theme={null}
  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);
  ```

  ```python Python icon="python" theme={null}
  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"])
  ```

  ```bash cURL icon="terminal" theme={null}
  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/"}'
  ```

  ```bash CLI icon="square-terminal" theme={null}
  stophy zillow property --propertyUrl https://www.zillow.com/homedetails/123-Main-St-Austin-TX-78701/29383449_zpid/
  ```
</CodeGroup>

<Tip>Zillow search and Zillow property cost 2 credits. Pass the property link from a search result into `zillow.property` for the full listing.</Tip>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.