Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.hasdata.com/llms.txt

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

The Redfin Listing API allows you to retrieve real estate listings from Redfin based on various search parameters.

​
Get Your API Key

Sign in at hasdata.com, go to your account settings, and copy your API key. All requests must include your key in the x-api-key header.

​
Request Cost and API Credits

Each request to the Redfin Listing API consumes API Credits from your account balance.
  • Cost per request: 5 API Credits
  • Credits are deducted only for successful requests.
  • Your total available credits depend on your active plan.
You can use your credits across all HasData APIs. The same credit balance is shared platform-wide.
Unused credits do not roll over. Any remaining credits expire at the end of the current billing period.
To monitor your credit usage and remaining balance, sign in to your account dashboard at app.hasdata.com.

​
Make Your First Request

curl --request GET -G \
  --url 'https://api.hasdata.com/scrape/redfin/listing' \
  --data-urlencode 'keyword=33321' \
  --data-urlencode 'type=forSale' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <your-api-key>'

​
API Parameters

ParameterDefault ValueRequiredDescription
keyword33321YesThe zipcode used to search for listings.
typeforSaleYesThe type of listing.
sort-NoThe sorting option for the search results.
price[min]-NoThe minimum price of the listing.
price[max]-NoThe maximum price of the listing.
monthlyPayment[min]-NoThe minimum monthly payment.
monthlyPayment[max]-NoThe maximum monthly payment.
monthlyPayment[interestRate]-NoThe mortgage interest rate (percent) used to calculate the monthly payment.
monthlyPayment[insuranceRate]-NoThe home insurance rate (percent) used to calculate the monthly payment.
monthlyPayment[downPaymentPercent]-NoThe down payment as a percentage of the home price.
monthlyPayment[downPaymentAmount]-NoThe down payment as an absolute amount.
monthlyPayment[mortgageTerm]-NoThe mortgage term used to calculate the monthly payment.
cost[hoa]-NoThe maximum monthly Homeowners Association (HOA) fee.
cost[pricePerSqft][min]-NoThe minimum price per square foot.
cost[pricePerSqft][max]-NoThe maximum price per square foot.
cost[excludeLandLeases]-NoIf set to true, listings with land leases will be excluded.
cost[maxPropertyTaxPerYear]-NoThe maximum property tax per year.
cost[acceptedFinancing]-NoThe accepted financing type.
cost[priceReduced]-NoFilter listings by when the price was reduced.
homeTypes[]-NoAn array of home types to filter the listings. Allowed values depend on the listing type.
beds[min]-NoThe minimum number of bedrooms.
beds[max]-NoThe maximum number of bedrooms.
baths-NoThe minimum number of bathrooms.
forSaleSquareFeet[min]-NoThe minimum square footage for for-sale listings.
forSaleSquareFeet[max]-NoThe maximum square footage for for-sale listings.
forRentSquareFootage[min]-NoThe minimum square footage for for-rent listings.
forRentSquareFootage[max]-NoThe maximum square footage for for-rent listings.
lotSize[min]-NoThe minimum lot size.
lotSize[max]-NoThe maximum lot size.
yearBuilt[min]-NoThe minimum year the property was built.
yearBuilt[max]-NoThe maximum year the property was built.
stories[min]-NoThe minimum number of stories.
stories[max]-NoThe maximum number of stories.
listingType[category][]-NoAn array of listing categories.
listingType[excludeShortSales]-NoIf set to true, short sales will be excluded.
listingType[redfinListingsOnly]-NoIf set to true, only Redfin-listed properties will be included.
statusOptions[]-NoAn array of listing statuses.
onlyWithDealOrPromotion-NoIf set to true, only listings with a deal or promotion will be included.
exclude55PlusCommunities-NoIf set to true, 55+ communities will be excluded.
timeOnRedfin-NoHow long the listing has been on Redfin.
soldWithinOption-NoFilter sold listings by how recently they were sold.
moveInDate-NoThe desired move-in date in MM/DD/YYYY format.
openHouseAndTour[openHouse]-NoFilter listings with an open house.
openHouseAndTour[videoTour]-NoIf set to true, only listings with a video tour will be included.
homeFeatures[options][]-NoAn array of home feature flags to filter the listings.
homeFeatures[garageSpotsMin]-NoThe minimum number of garage spots.
homeFeatures[poolType]-NoThe type of pool.
homeFeatures[basement]-NoThe basement type.
homeFeatures[keywordSearch]-NoA free-text keyword search applied to listing descriptions.
rentalAmenities[]-NoAn array of rental amenities to filter the listings.
rentalOtherTerms[]-NoAn array of additional rental terms.
pets[]-NoAn array of pet types allowed.
schools[greatSchoolRating]-NoThe minimum GreatSchools rating (1-10).
schools[schoolType][]-NoAn array of school types.
schools[includeUnratedSchools]-NoIf set to true, unrated schools will be included.
transportScores[walkScore]-NoThe minimum walk score (1-100).
transportScores[transitScore]-NoThe minimum transit score (1-100).
transportScores[bikeScore]-NoThe minimum bike score (1-100).
page-NoThe page number of the results to retrieve.