Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt

Use this file to discover all available pages before exploring further.

$1 / 1k results Extract Zillow real estate property listings by ZIP code, specifying if for sale, rent, or sold

​
Endpoint

POST /api/v1/agents/zillow/zip-search/run

​
Parameters

​
zipCodes
array
required
List · Zip codes to search properties in. One per line.
​
listingStatus
array
default:["agent"]
Multi-select · Which listing types to include. Pick one or more.Options: agent, owner, rent, soldLegend: agent = For sale (by agent), owner = For sale (by owner), rent = For rent, sold = Recently sold
​
priceMin
integer
Number · Minimum price of property (monthly price for rental)
​
priceMax
integer
Number · Maximum price of property (monthly price for rental)
​
daysOnZillow
string
default:""
Dropdown · Number of days a property has been listed on Zillow (if searching for Recently Sold, then this is the number of days since the property was sold)
1, 7, 14, 30, 90, 6m, 12m, 24m, 36mView all 9 as a structured list →
​
maxResults
integer
default:100
Number · Maximum total properties to return across all zip codes.

​
Response columns

FieldDisplay nameType
zipZiptext
listingUrlListing URLurl
imageImageurl
addressAddresstext
streetStreettext
cityCitytext
stateStatetext
pricePricetext
priceRawPrice (Raw)currency
currencyCurrencytext
bedsBedsnumber
bathsBathsnumber
areaSqftArea (sqft)number
statusStatustext
statusTypeStatus Typetext
marketingStatusMarketing Statustext
rawStatusRaw Statustext
homeTypeHome Typetext
homeStatusHome Statustext
daysOnZillowDays On Zillownumber
zestimateZestimatecurrency
rentZestimateRent Zestimatecurrency
taxAssessedValueTax Assessed Valuecurrency
priceChangePrice Changecurrency
priceReductionPrice Reductiontext
datePriceChangedDate Price Changedtext
livingAreaLiving Areanumber
bedroomsBedroomsnumber
bathroomsBathroomsnumber
unitUnittext
latitudeLatitudenumber
longitudeLongitudenumber
openHouseOpen Houseboolean
openHouseDescriptionOpen House Descriptiontext
openHouseStartOpen House Starttext
openHouseEndOpen House Endtext
3dModel3D Modelboolean
hasImageHas Imageboolean
hasVideoHas Videoboolean
featuredFeaturedboolean
showcaseListingShowcase Listingboolean
homeRecHome Recboolean
ownerClaimingOwner Claimingboolean
ownerConfirmedOwner Confirmedboolean
paidBuilderNewPaid Builder Newboolean
addressHiddenAddress Hiddenboolean
zillowOwnedZillow Ownedboolean
savedSavedboolean
infoLineInfo Linetext
flexTextFlex Texttext
contentTypeContent Typetext

​
Example

curl -X POST https://api.mindcase.co/api/v1/agents/zillow/zip-search/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "zipCodes": [
      "10014",
      "07306"
    ],
    "priceMax": 400000,
    "forRent": false,
    "forSaleByAgent": true,
    "sold": false,
    "forSaleByOwner": false
  }
}'

​
Example response

Response
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "zip": "07306",
      "listingUrl": "https://www.zillow.com/homedetails/108-Waldo-Ave-APT-1D-Jersey-City-NJ-07306/2079175653_zpid/",
      "image": "https://photos.zillowstatic.com/fp/e1e71ecc6edd4b8b25d35e49b92ba0fe-p_e.jpg",
      "address": "108 Waldo Ave APT 1D, Jersey City, NJ 07306",
      "street": "108 Waldo Ave APT 1D",
      "city": "Jersey City",
      "state": "NJ",
      "price": "$319,000",
      "priceRaw": 319000,
      "currency": "$",
      "beds": 2,
      "baths": 1,
      "areaSqft": 0,
      "status": "Condo for sale",
      "statusType": "FOR_SALE",
      "marketingStatus": "For Sale by Agent",
      "rawStatus": "ForSale",
      "homeType": "CONDO",
      "homeStatus": "FOR_SALE",
      "daysOnZillow": 247,
      "zestimate": 311400,
      "rentZestimate": 2655,
      "taxAssessedValue": null,
      "priceChange": null,
      "priceReduction": null,
      "datePriceChanged": null,
      "livingArea": 0,
      "bedrooms": 2,
      "bathrooms": 1,
      "unit": "Apt 1D",
      "latitude": 40.72812,
      "longitude": -74.05508,
      "openHouse": null,
      "openHouseDescription": null,
      "openHouseStart": null,
      "openHouseEnd": null,
      "3dModel": false,
      "hasImage": true,
      "hasVideo": false,
      "featured": false,
      "showcaseListing": false,
      "homeRec": false,
      "ownerClaiming": false,
      "ownerConfirmed": false,
      "paidBuilderNew": false,
      "addressHidden": false,
      "zillowOwned": false,
      "saved": false,
      "infoLine": "Listing provided by HCMLS",
      "flexText": "Hardwood floors throughout",
      "contentType": "homeInsight"
    }
  ]
}