Property Details & History

Access the most comprehensive property data, and our AI-powered insights

Get everything we know about a property by its id. We keep things simple, so you can focus on building your application. Once you have the id of the property you are interested in, you can use the property/{id} endpoint to get all the details you need.

The only required parameter for this endpoint is the id of the property. You can find it by searching for the property using the search endpoint.

The returned payload includes, among other things:

  • 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.
  • Concession History: This is a list of all the specials that is being or have been offered by the property. It includes the text, 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 we have see 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.
  • Reviews: A summary of reviews we’ve collected from various sources, analysed and aggregated for you by our NLP algorithms.

If you can find it on our platform, you can get it through the API.

$curl --location 'https://api.hellodata.ai/property/0e628031-57b8-5394-821d-13779318fef4' \
>--header 'x-api-key: token'

You’ll get the full history of the property, including all the changes in prices, availabilities, and specials since the first day we saw it on the market. Check our API reference for more details on the reponse payload: property/{id}.

Raw Data VS Processed Data

We’ve seen many users apply our data in diverse ways, each with their own unique objectives. That’s why we provide raw data, giving you the freedom to process and aggregate it as you see fit. Instead of pre-calculating metrics like average prices for properties or unit types, we let you decide how to best utilize the data for your specific needs.

You can explore our platform to see how we handle data for our use cases, but we encourage you to leverage the raw data to build your own models and strategies that align with your goals.

Caching

To reduce API costs, cache results from the Get Property endpoint for a few hours or days. Data generally doesn’t change throughout the day.

Data Freshness

We aggregate property data for any given day the following day. If you call this endpoint daily, we recommend you to call after 9 AM Eastern Time to ensure you get the previous day’s data.

Full Documentation

Find more details about this endpoint our API Reference.