Real estate

Each parser reads one kind of page and returns the site’s own data. Send the page’s URL to scrape with a json format that names the parser. The data comes back in data.json.

curl -X POST https://api.stophy.dev/v1/scrape \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.zillow.com/homes/San-Francisco,-CA_rb/","formats":[{"type":"json","parser":"zillow-search"}]}'

const response = await fetch("https://api.stophy.dev/v1/scrape", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.STOPHY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    url: "https://www.zillow.com/homes/San-Francisco,-CA_rb/",
    formats: [{ type: "json", parser: "zillow-search" }],
  }),
});
console.log(await response.json());

import os

import requests

response = requests.post(
    "https://api.stophy.dev/v1/scrape",
    headers={"Authorization": f"Bearer {os.environ['STOPHY_API_KEY']}"},
    json={
        "url": "https://www.zillow.com/homes/San-Francisco,-CA_rb/",
        "formats": [{"type": "json", "parser": "zillow-search"}],
    },
)
print(response.json())

Send a parser’s options in the same format, like {"type": "json", "parser": "zillow-search", "options": {...}}. See Parsers for how they work.

Parser	Reads	Price
`zillow-search`	A Zillow search page for a place, like zillow.com/homes/San-Francisco,-CA_rb/.	2 credits per call.
`zillow-property`	A Zillow home page, like zillow.com/homedetails/…/123_zpid/.	1 credit per call.
`realtor-search`	A Realtor.com search page for a place, like realtor.com/realestateandhomes-search/Austin_TX.	1 credit per call.
`realtor-property`	A Realtor.com home page, like realtor.com/realestateandhomes-detail/…	1 credit per call.

zillow-search

A Zillow search page for a place, like zillow.com/homes/San-Francisco,-CA_rb/.

Example page: https://www.zillow.com/homes/San-Francisco,-CA_rb/
Returns: A list of listings: results, cursor, page, total.
Options: status, minPrice, maxPrice, minBedrooms, maxBedrooms, minBathrooms, minSqft, maxSqft, minLotSize (Zillow’s own Lot size minimum, in square feet), maxLotSize (Zillow’s own Lot size maximum, in square feet), minYearBuilt (Zillow’s own Year built minimum), maxYearBuilt (Zillow’s own Year built maximum), maxHoa (Zillow’s own Max HOA: the highest monthly HOA fee in USD. 0 means no HOA fee), minParkingSpots (Zillow’s own Parking spots filter: at least this many (1 to 4)), daysOnZillow (Zillow’s own Days on Zillow filter: listed in the last 1, 7, 14, 30 or 90 days, or 6, 12, 24 or 36 months. For sold homes it means sold in the last N), hasPool (Zillow’s own “Must have pool” filter. Only matching homes when true), hasGarage (Zillow’s own “Must have garage” filter. Only matching homes when true), hasAirConditioning (Zillow’s own “Must have A/C” filter. Only matching homes when true), isWaterfront (Zillow’s own “Waterfront” filter. Only matching homes when true), singleStory (Zillow’s own “Single-story only” filter. Only matching homes when true), openHouse (Zillow’s own “Must have open house” filter. Only matching homes when true), priceReduced (Zillow’s own “Must have price reduction” filter. Only matching homes when true), has3dTour (Zillow’s own “Must have 3D Tour” filter. Only matching homes when true), petsAllowed (Zillow’s own “Pets Allowed” filter. Only matching homes when true. Rentals only: needs status forRent), homeTypes (Zillow’s own Home type filter. On rentals, apartment and condo are one Zillow category (apartments, condos and co-ops), so either one returns both), sort (Zillow’s own sort. priceHigh, bedrooms, bathrooms, squareFeet and lotSize put the largest first, and priceLow the smallest. A rental building sits where its highest unit rent falls), keywords (Words the listing must mention, like “pool” or “fixer upper”), page (Page number, starting at 1).
Price: 2 credits per call.

Example response

{
  "results": [
    {
      "id": "15088840",
      "url": "https://www.zillow.com/homedetails/157-28th-Ave-San-Francisco-CA-94121/15088840_zpid/",
      "title": "157 28th Ave, San Francisco, CA 94121",
      "description": null,
      "price": {
        "amount": 10000000,
        "currency": "USD"
      },
      "pricePeriod": "sale",
      "status": "forSale",
      "address": "157 28th Ave, San Francisco, CA 94121",
      "location": {
        "latitude": 37.785973,
        "longitude": -122.48865
      },
      "bedrooms": 5,
      "bathrooms": 7,
      "area": {
        "amount": 6844,
        "unit": "sqft"
      },
      "propertyType": "SINGLE_FAMILY",
      "rating": null,
      "reviewCount": null,
      "images": [
        "https://photos.zillowstatic.com/fp/562cd6643e9850b83ae5166c89acb7f6-p_e.jpg"
      ],
      "host": null,
      "statusText": "House for sale",
      "addressStreet": "157 28th Ave",
      "addressCity": "San Francisco",
      "addressRegion": "CA",
      "addressPostalCode": "94121",
      "daysOnZillow": 5,
      "lastSoldAt": null,
      "zestimate": 10400300,
      "rentZestimate": null,
      "brokerName": "Golden Gate Sotheby's Internat",
      "buildingName": null,
      "buildingMinRent": null,
      "buildingMaxRent": null,
      "buildingAvailableUnits": null,
      "units": []
    }
  ],
  "cursor": null,
  "page": 1,
  "total": 981,
  "totalPages": 20
}

zillow-property

A Zillow home page, like zillow.com/homedetails/…/123_zpid/.

Example page: https://www.zillow.com/homedetails/157-28th-Ave-San-Francisco-CA-94121/15088840_zpid/
Returns: One listing: id, url, title, description, price, pricePeriod, status, address, location, bedrooms, bathrooms, area, propertyType, rating, reviewCount, images, host.
Price: 1 credit per call.

Example response

{
  "id": "15088840",
  "url": "https://www.zillow.com/homedetails/157-28th-Ave-San-Francisco-CA-94121/15088840_zpid/",
  "title": "157 28th Ave, San Francisco, CA 94121",
  "description": "Set on an unusually wide lot in coveted Sea Cliff, 157 28th Avenue is a fully detached contemporary residence offering…",
  "price": {
    "amount": 10000000,
    "currency": "USD"
  },
  "pricePeriod": "sale",
  "status": "forSale",
  "address": "157 28th Ave, San Francisco, CA 94121",
  "location": {
    "latitude": 37.785973,
    "longitude": -122.48865
  },
  "bedrooms": 5,
  "bathrooms": 7,
  "area": {
    "amount": 6844,
    "unit": "sqft"
  },
  "propertyType": "SINGLE_FAMILY",
  "rating": null,
  "reviewCount": null,
  "images": [
    "https://photos.zillowstatic.com/fp/562cd6643e9850b83ae5166c89acb7f6-cc_ft_1536.jpg",
    "https://photos.zillowstatic.com/fp/910c2dcd749cf7fecfee767e8629024d-cc_ft_1536.jpg",
    "https://photos.zillowstatic.com/fp/eab5104a6ea4b9b8ef4cea4d2e2e2673-cc_ft_1536.jpg"
  ],
  "host": null,
  "zestimate": 10400300,
  "rentZestimate": null,
  "lastSoldPrice": 7200000,
  "lastSoldAt": "2020-09-22T00:00:00.000Z",
  "addressStreet": "157 28th Ave",
  "addressCity": "San Francisco",
  "addressRegion": "CA",
  "addressPostalCode": "94121",
  "lotSize": 5418.864,
  "lotSizeUnit": "Square Feet",
  "yearBuilt": 1923,
  "priceHistory": [
    {
      "eventDate": "2026-10-31",
      "price": 10000000,
      "event": "Listed for sale"
    }
  ],
  "daysOnZillow": 5,
  "views": null,
  "saves": null,
  "monthlyHoa": null,
  "propertyTaxRate": 1.17,
  "mlsId": "426173818",
  "mlsName": "SFAR",
  "brokerName": "Golden Gate Sotheby's Internat",
  "brokerPhone": "+1 555 0100",
  "agentName": "Susan Hewitt C.J. Nakagawa",
  "agentPhone": "+1 555 0100",
  "agentEmail": null,
  "facts": [
    {
      "name": "bedrooms",
      "value": "5"
    }
  ],
  "statusText": "FOR_SALE"
}

realtor-search

A Realtor.com search page for a place, like realtor.com/realestateandhomes-search/Austin_TX.

Example page: https://www.realtor.com/realestateandhomes-search/Austin_TX
Returns: A list of listings: results, cursor, page, total.
Options: status, minPrice (Lowest price in US dollars), maxPrice (Highest price in US dollars), minBedrooms, maxBedrooms, minBathrooms, minSqft, maxSqft, homeTypes, sort (Realtor.com’s own order by default. priceLow and priceHigh also order each page by price. On sold homes, newest, price filters and price sorts use the sale), page (Page number, starting at 1).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "8395932351",
      "url": "https://www.realtor.com/realestateandhomes-detail/6700-Tulloch-Way_Austin_TX_78754_M83959-32351",
      "title": "6700 Tulloch Way, Austin, TX 78754",
      "description": null,
      "price": {
        "amount": 439999,
        "currency": "USD"
      },
      "pricePeriod": "sale",
      "status": "forSale",
      "address": "6700 Tulloch Way, Austin, TX 78754",
      "location": {
        "latitude": 30.354294,
        "longitude": -97.61154
      },
      "bedrooms": 4,
      "bathrooms": 4,
      "area": {
        "amount": 3840,
        "unit": "sqft"
      },
      "propertyType": "single_family",
      "rating": null,
      "reviewCount": null,
      "images": [
        "https://ap.rdcpix.com/e8cfb6fa65df9ca9d347ebd47586e33fl-m3060197626s.jpg"
      ],
      "host": null,
      "isPending": true,
      "priceMax": null,
      "addressStreet": "6700 Tulloch Way",
      "addressCity": "Austin",
      "addressRegion": "TX",
      "addressPostalCode": "78754",
      "bedroomsMax": null,
      "lotSqft": 8350,
      "yearBuilt": 2005,
      "monthlyHoa": 41,
      "lastSoldPrice": null,
      "publishedAt": "2026-10-02T00:00:00.000Z",
      "lastSoldAt": "2005-08-30T00:00:00.000Z"
    }
  ],
  "cursor": null,
  "page": null,
  "total": 6453
}

realtor-property

A Realtor.com home page, like realtor.com/realestateandhomes-detail/…

Example page: https://www.realtor.com/realestateandhomes-detail/581-Leaning-Rock-Rdg_Austin_TX_78737_M99162-05223
Returns: One listing: id, url, title, description, price, pricePeriod, status, address, location, bedrooms, bathrooms, area, propertyType, rating, reviewCount, images, host.
Price: 1 credit per call.

Example response

{
  "id": "9916205223",
  "url": "https://www.realtor.com/realestateandhomes-detail/581-Leaning-Rock-Rdg_Austin_TX_78737_M99162-05223",
  "title": "581 Leaning Rock Rdg, Austin, TX 78737",
  "description": "Step off the front porch into the extended entryway with a 12-foot rotunda ceiling. Off of the main hallway are two…",
  "price": {
    "amount": 1099900,
    "currency": "USD"
  },
  "pricePeriod": "sale",
  "status": "forSale",
  "address": "581 Leaning Rock Rdg, Austin, TX 78737",
  "location": {
    "latitude": 30.161156,
    "longitude": -97.98212
  },
  "bedrooms": 4,
  "bathrooms": 5,
  "area": {
    "amount": 3080,
    "unit": "sqft"
  },
  "propertyType": "single_family",
  "rating": null,
  "reviewCount": null,
  "images": [
    "https://nh.rdcpix.com/2337494e09a52d8226512341c4506aebl-f2640517s.jpg",
    "https://nh.rdcpix.com/2337494e09a52d8226512341c4506aebf-f3605729761s.jpg"
  ],
  "host": null,
  "isPending": false,
  "priceMax": null,
  "addressStreet": "581 Leaning Rock Rdg",
  "addressCity": "Austin",
  "addressRegion": "TX",
  "addressPostalCode": "78737",
  "bedroomsMax": null,
  "lotSqft": null,
  "yearBuilt": null,
  "monthlyHoa": null,
  "lastSoldPrice": null,
  "garageSpaces": 3,
  "stories": 1,
  "agentName": null,
  "agentEmail": null,
  "agentPhone": null,
  "brokerName": null,
  "priceHistory": [
    {
      "date": "2026-10-30",
      "event": "Price Changed",
      "price": 1099900
    }
  ],
  "taxHistory": [],
  "schools": [
    {
      "name": "Sycamore Springs Elementary School",
      "rating": 8,
      "levels": [
        "elementary"
      ],
      "fundingType": "public",
      "distanceMiles": 1.6
    }
  ],
  "publishedAt": "2026-10-26T00:00:00.000Z",
  "lastSoldAt": null
}

Get started

Parsers

Guides

Plans and billing

zillow-search

zillow-property

realtor-search

realtor-property

​zillow-search

​zillow-property

​realtor-search

​realtor-property

zillow-search

zillow-property

realtor-search

realtor-property