# Zillow API: Search homes for sale > Searches Zillow homes for sale in a city and state, neighborhood or ZIP code, with optional price, bedroom, bathroom and property type filters and sort order, from Zillow's public search pages (up to 100 listings). Unofficial. Not affiliated with or endorsed by Zillow. - Page: https://fous.com/methods/zillow.com/search-homes - Method: `zillow.com/search_homes`, version 1 - Website: zillow.com - Returns: address, price, beds, baths, square feet, home type, days on Zillow, Zestimate, price cut, brokerage, photo, link, zpid, coordinates - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `sort` | string | no | `"newest"` | Listing order, for example newest. One of "homes_for_you", "newest", "price_low_to_high", "price_high_to_low". Default "homes_for_you". | | `location` | string | yes | `"78704"` | City and state, neighborhood, or ZIP code, for example Austin, TX. | | `min_beds` | number | no | | Minimum number of bedrooms, for example 3. | | `home_type` | string | no | `"condo"` | Property type to include, for example condo. One of "any", "house", "condo", "townhouse", "multi_family", "land", "manufactured". Default "any". | | `max_price` | number | no | | Maximum listing price in USD, for example 750000. | | `min_baths` | number | no | | Minimum number of bathrooms, for example 2. | | `min_price` | number | no | | Minimum listing price in USD, for example 300000. | | `max_results` | integer | no | `45` | Maximum number of listings to return, for example 20. Default 20. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "sort": "newest", "location": "78704", "home_type": "condo", "max_results": 45 } ``` Its output: ```json { "homes": [ { "beds": 2, "zpid": "94643019", "baths": 3, "price": 699000, "address": "2316 Thornton Rd #B, Austin, TX 78704", "currency": "USD", "latitude": 30.244944, "home_type": "Condo", "longitude": -97.772575, "price_cut": null, "zestimate": null, "photo_link": "https://photos.zillowstatic.com/fp/1f6981aa9adcd504cae6a48681255b66-p_e.jpg", "square_feet": 1985, "listing_link": "https://www.zillow.com/homedetails/2316-Thornton-Rd-B-Austin-TX-78704/94643019_zpid/", "days_on_zillow": 0, "listing_brokerage": "Christies Intl Real Estate Lone Star" }, { "beds": 3, "zpid": "345024237", "baths": 4, "price": 1395000, "address": "2706 Stacy Ln #1, Austin, TX 78704", "currency": "USD", "latitude": 30.237383, "home_type": "Condo", "longitude": -97.76179, "price_cut": null, "zestimate": null, "photo_link": "https://photos.zillowstatic.com/fp/4c47fa7becdd8b53e64739c5b724b71e-p_e.jpg", "square_feet": 2484, "listing_link": "https://www.zillow.com/homedetails/2706-Stacy-Ln-1-Austin-TX-78704/345024237_zpid/", "days_on_zillow": 3, "listing_brokerage": "Gottesman Residential R.E." }, { "beds": 2, "zpid": "110539637", "baths": 2, "price": 299900, "address": "2303 E Side Dr APT 109, Austin, TX 78704", "currency": "USD", "latitude": 30.240852, "home_type": "Condo", "longitude": -97.74654, "price_cut": null, "zestimate": null, "photo_link": "https://photos.zillowstatic.com/fp/c6b3508affd0631eb44b835f8c989664-p_e.jpg", "square_feet": 1105, "listing_link": "https://www.zillow.com/homedetails/2303-E-Side-Dr-APT-109-Austin-TX-78704/110539637_zpid/", "days_on_zillow": 3, "listing_brokerage": "JBGoodwin REALTORS NW" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"zillow.com/search_homes","input":{"sort":"newest","location":"78704","home_type":"condo","max_results":45}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find 3+ bedroom houses for sale in Raleigh, NC under $550,000, newest listings first - What condos are listed on Zillow in ZIP 33139 between $400k and $900k? Show me up to 40 with their Zestimates and any price cuts - I'm relocating to Boise, Idaho — pull the cheapest townhouses for sale with at least 2 baths - Show homes for sale in the Ballard neighborhood of Seattle, sorted by price high to low, with square footage and days on market - Search Zillow for multi-family properties for sale in Columbus, OH, minimum 4 beds, max price 700000, return 50 results ## Input schema ```json { "type": "object", "required": [ "location" ], "properties": { "sort": { "enum": [ "homes_for_you", "newest", "price_low_to_high", "price_high_to_low" ], "type": "string", "default": "homes_for_you", "description": "Listing order, for example newest." }, "location": { "type": "string", "minLength": 2, "description": "City and state, neighborhood, or ZIP code, for example Austin, TX." }, "min_beds": { "type": "number", "minimum": 0, "description": "Minimum number of bedrooms, for example 3." }, "home_type": { "enum": [ "any", "house", "condo", "townhouse", "multi_family", "land", "manufactured" ], "type": "string", "default": "any", "description": "Property type to include, for example condo." }, "max_price": { "type": "number", "minimum": 0, "description": "Maximum listing price in USD, for example 750000." }, "min_baths": { "type": "number", "minimum": 0, "description": "Minimum number of bathrooms, for example 2." }, "min_price": { "type": "number", "minimum": 0, "description": "Minimum listing price in USD, for example 300000." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Maximum number of listings to return, for example 20." } } } ``` ## Output schema ```json { "type": "object", "required": [ "homes" ], "properties": { "homes": { "type": "array", "items": { "type": "object", "required": [ "address", "price", "currency", "beds", "baths", "square_feet", "home_type", "days_on_zillow", "zestimate", "price_cut", "listing_brokerage", "photo_link", "listing_link", "zpid", "latitude", "longitude" ], "properties": { "beds": { "type": [ "number", "null" ], "description": "Bedrooms." }, "zpid": { "type": [ "string", "null" ], "description": "Zillow property ID." }, "baths": { "type": [ "number", "null" ], "description": "Bathrooms." }, "price": { "type": [ "number", "null" ], "description": "Asking price." }, "address": { "type": [ "string", "null" ], "description": "Full street address." }, "currency": { "type": "string", "description": "Price currency (USD)." }, "latitude": { "type": [ "number", "null" ], "description": "Property latitude." }, "home_type": { "type": [ "string", "null" ], "description": "Property type." }, "longitude": { "type": [ "number", "null" ], "description": "Property longitude." }, "price_cut": { "type": [ "string", "null" ], "description": "Displayed price reduction and date." }, "zestimate": { "type": [ "number", "null" ], "description": "Zillow estimated value in USD." }, "photo_link": { "type": [ "string", "null" ], "description": "First listing photo URL." }, "square_feet": { "type": [ "number", "null" ], "description": "Interior area in square feet." }, "listing_link": { "type": "string", "description": "Zillow property page URL." }, "days_on_zillow": { "type": [ "integer", "null" ], "description": "Days listed on Zillow." }, "listing_brokerage": { "type": [ "string", "null" ], "description": "Listing brokerage." } } }, "description": "Homes for sale in the selected order." } } } ``` ## See more - [Zillow API: Search rentals](https://fous.com/methods/zillow.com/search-rentals.md): Searches Zillow rentals in a city, neighborhood, or ZIP code, with optional rent, bedroom, pet, and home-type filters. Listing details that Zillow does not show are null. - [Zillow API: Get housing market](https://fous.com/methods/zillow.com/get-housing-market.md): Looks up Zillow housing market figures for a city and state or five-digit ZIP code: typical home value, one-year change, list and sale prices, inventory and listing activity. - [Homes.com API: Search homes for sale](https://fous.com/methods/homes.com/search-homes.md): Searches Homes.com homes for sale in a US city, neighborhood, or ZIP code, with optional price, bedroom, bathroom and home type filters. Returns listings in site order; days on market is null when not shown. - [Realtor.com API: Search homes](https://fous.com/methods/realtor.com/search-homes.md): Searches Realtor.com homes for sale, for rent, or recently sold in a city, neighborhood or ZIP code, with optional price, bedroom, bathroom and home type filters and sort order. Rentals with price ranges use the lowest advertised rent; withheld sold prices are blank. - [Redfin API: Search homes for sale](https://fous.com/methods/redfin.com/search-homes.md): Searches Redfin homes for sale in a city, neighborhood or ZIP code, with price, home type, bed and bath filters and a sort order, returning each listing's price, size, status, photo and links. - [Zoopla API: Search properties](https://fous.com/methods/zoopla.co.uk/search-properties.md): Searches Zoopla homes for sale or to rent in a UK town, area or postcode, with price, bedroom, property type and sort options. Prices are in GBP; rents are monthly. - [Rightmove API: Search properties](https://fous.com/methods/rightmove.co.uk/search-properties.md): Searches Rightmove homes for sale or to rent around a town, area or postcode, with price, bedroom, property type, radius and under-offer filters, sorted by newest or price. - [Realtor.com API: Get home details](https://fous.com/methods/realtor.com/get-home.md): Gets a home's details from Realtor.com by street address or Realtor.com property link: status, list price, value estimate, beds, baths, size, year built, HOA fee, property and tax history, nearby schools, flood risk and photos. - [All Zillow methods](https://fous.com/methods/zillow.com.md)