Daily Updated Property Data
HelloData helps you add real-time rent, availability, and property data to your rent surveys and real estate tech products. Collect data on fees, concessions, utilities, and over 300 unique property attributes using only an address.
The Flow
Our endpoints center around a single PropertyDetails object, which contains all the information we have on a property. Here’s how to use our API:
1. Search for a property
This endpoint is free! Refine your search as much as needed.
Search by address, city, state, zip code, property name, or a combination of these.
This returns a simple list of properties that match your search. You can then use the id
to get more details on a specific property.
Enforcing a specific market
For automated searches, constrain results by zip code or state:
2. Get property details
Use the id from the search results to get in-depth property information.
This returns an extremely detailed payload containing the entirety of the information we have on the property.
This payload contains the following information:
- Property Location: Address, City, State, Zip Code, Latitude, Longitude, MSA.
- Property Details: Number of units, year built, management company, etc.
- Property Amenities: This is a list of all the amenities that are present in the property. We use a Natural Language Processing algorithm to extract this information from the text present on property’s websites.
- Unit Amenities: This is a list of all the amenities that are present in the unit. We use a Natural Language Processing algorithm to extract this information from the text present on property’s websites.
- Specials History: This is a list of all the specials that is being or have been offered by the property. It includes the special, the date range, the conditions, and the discounts. We use a Natural Language Processing algorithm to extract this information from the text present on property’s websites.
- Pricing Strategy: This is an analysis of the pricing strategy of the property. It includes the average duration of a lease, the average price change, the average time on the market, the day of the week distribution, and the count of prices.
- Building Quality: This is a score that we have calculated based on the pictures and the description of the property. It is a score between 0 and 1. Broken down by room.
- Unit Availabilities: This is a list of all the availabilities that are present in the property. It includes the floorplan, the unit name, the floor, the availability, the price, the square footage, the days on the market, and the history of the availability.
For the full object details, check the Endpoint Documentation
3. Find Comparable Properties
Locate similar properties in the same market.
This will return a list of properties that are similar to the subject property. The list is sorted by similarity score, with the most similar properties at the top.
Each response object is rather simple, such that you can decide whether they are interesting to you or not before making a more detailed request like you did in the second step above. Here is an example with a single comparable property:
Add constraints to the comparables
Refine comparables:
- Set distance limits (
maxDistance
) - Filter by units (
minNumberUnits
,maxNumberUnits
) - Filter by year built (
minYearBuilt
, maxYearBuilt`) - Filter by number of stories (
minNumberStories
,maxNumberStories
)
For examples and more details, check the Endpoint Documentation
Exclude and Include specific properties
- If you have already seen some properties and want to exclude them from the results, you can add their
id
to theexcluded_ids
array in the request. They will not appear in the results. - You may also tell the API that you want some specific properties to be selected. In that case, you can add their
id
to theselected_ids
array in the request. The API will return these properties first, and then iftopN
is high enough, it will also add best next comparables to the response.
We are working on a feature that will make use of the properties you have selected to improve the results. Stay tuned!
Retrieve the details of a comparable property
Once you have found a property that you are interested in, you can retrieve its details using the Get Property
endpoint,
just like you did with the subject property.
Caching
To reduce API costs, cache results from the Get Property endpoint for a few hours. Data generally doesn’t change throughout the day.
Let us know if you have any questions or feedback!
Let me know if you have any other changes you’d like to make!