> ## 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 and rent on Zillow, Redfin, Realtor.com, Rightmove, and ImmoScout24. Get price, photos, and details for any listing.

Search homes for sale and rent on Zillow, Redfin, Realtor.com, Rightmove, and ImmoScout24. Get price, photos, and details for any listing. 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" });
  console.log(result.data.listings);
  ```

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

  stophy = Stophy()  # reads STOPHY_API_KEY
  result = stophy.zillow.search(location="Austin, TX")
  print(result["data"]["listings"])
  ```

  ```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"}'
  ```

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

The response:

```json theme={null}
{
  "success": true,
  "data": {
    "listings": [
      {
        "id": "abc123",
        "url": "https://example.com/",
        "status": "forSale",
        "statusText": "example",
        "price": 19.99,
        "currency": "USD",
        "address": {
          "full": "example",
          "street": "example",
          "city": "example",
          "state": "example",
          "postalCode": "example",
          "country": "us"
        },
        "location": {
          "lat": 1,
          "lng": 1
        },
        "bedrooms": 1,
        "bathrooms": 1,
        "sqft": 1,
        "homeType": "example",
        "daysOnZillow": 1,
        "lastSoldAt": "2026-09-28T12:00:00.000Z",
        "zestimate": 1,
        "rentZestimate": 1,
        "broker": {
          "name": "Example title"
        },
        "image": "https://example.com/image.jpg",
        "building": {
          "name": "Example title",
          "minRent": 1,
          "maxRent": 1,
          "availableUnits": 1,
          "units": [
            {
              "bedrooms": 1,
              "price": 19.99
            }
          ]
        }
      }
    ],
    "total": 1234
  },
  "creditsUsed": 3,
  "requestId": "0765738f-a71b-4e84-be71-84fcfbf2a56c"
}
```

## Endpoints

| Endpoint | Cost |
| - | - |
| [Search homes for sale, for rent or sold](/api-reference/endpoint/zillow-search) | 3 credits per 41 items, at least 3 credits |
| [Get a home's details, price and Zestimate](/api-reference/endpoint/zillow-property) | 3 credits |
| [Search Redfin homes for sale or sold](/api-reference/endpoint/redfin-search) | 1 credit per 20 items, at least 1 credit |
| [Get a home's details and estimate](/api-reference/endpoint/redfin-property) | 1 credit |
| [Search Realtor.com homes for sale or sold](/api-reference/endpoint/realtor-search) | 1 credit per 20 items, at least 1 credit |
| [Get a home's details and price](/api-reference/endpoint/realtor-property) | 1 credit |
| [Search UK homes for sale or rent](/api-reference/endpoint/rightmove-search) | 1 credit per 24 items, at least 1 credit |
| [Get a Rightmove property's details](/api-reference/endpoint/rightmove-property) | 1 credit |
| [Search German homes for rent or sale](/api-reference/endpoint/immoscout-search) | 1 credit per 25 items, at least 1 credit |
| [Get an ImmoScout listing's details](/api-reference/endpoint/immoscout-listing) | 1 credit |

## More ways to call it

### Search Redfin homes for sale 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.redfin.search({ location: "Seattle, WA" });
  console.log(result.data.listings);
  ```

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

  stophy = Stophy()  # reads STOPHY_API_KEY
  result = stophy.redfin.search(location="Seattle, WA")
  print(result["data"]["listings"])
  ```

  ```bash cURL icon="terminal" theme={null}
  curl -X POST https://api.stophy.dev/v1/redfin/search \
    -H "Authorization: Bearer $STOPHY_API_KEY" \
    -H "content-type: application/json" \
    -d '{"location":"Seattle, WA"}'
  ```

  ```bash CLI icon="square-terminal" theme={null}
  stophy redfin search "Seattle, WA"
  ```
</CodeGroup>

### Search Realtor.com homes for sale 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.realtor.search({ location: "Denver, CO" });
  console.log(result.data.listings);
  ```

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

  stophy = Stophy()  # reads STOPHY_API_KEY
  result = stophy.realtor.search(location="Denver, CO")
  print(result["data"]["listings"])
  ```

  ```bash cURL icon="terminal" theme={null}
  curl -X POST https://api.stophy.dev/v1/realtor/search \
    -H "Authorization: Bearer $STOPHY_API_KEY" \
    -H "content-type: application/json" \
    -d '{"location":"Denver, CO"}'
  ```

  ```bash CLI icon="square-terminal" theme={null}
  stophy realtor search "Denver, CO"
  ```
</CodeGroup>

<Tip>Pass the listing URL from a search result into that site's property endpoint for the full listing.</Tip>