Changelog

Stay up to date with the latest changes to our API

2024-12-11

New Feature: Special Included

  • Added special_included to the concessions_history object to indicate if the concession was already included in asking price. For example: “1 month free. Special included in advertisement”
  • When special_included is true, the price field is back-calculated from the effective rent to show what the actual asking price would have been before the concession was applied. This provides consistency in price tracking regardless of how properties choose to advertise their specials.

Removed Deprecated Fields:

  • specials
  • lease_lengths
  • estimated_occupancy
  • renovated, furnished, den, convertible

2024-11-18

New Feature: Report Metadata

  • Added metadata to the /property_report/list endpoint to allow users to store arbitrary metadata on a report. Accept an object with strings as keys and strings, numbers or booleans as values.
  • New PATCH endpoint on /property_report/{id}/metadata to update the metadata of a report.

2024-10-30

Removed previously deprecated specials_history attribute from PropertyDetails. Use concessions_history instead, which has a more accurate history of concessions.

2023-10-08

Removed previously deprecated /rentsource/* endpoints

2024-09-15

Introduced /market/search to make market level searching that much easier. Contact us to include this in your subscription.

2024-09-05

New Feature: Factoring senior housing into the similarity score

Make sure senior housing is factored into the similarity score when comparing properties. This will help you find the most relevant properties for your needs.

2024-08-22

Dynamic Pricing Strategy

The pricing_strategy field on property details is now computed based on the past 6 months of pricing data. This change will help you gain a better understanding of recent pricing strategies by excluding older patterns.

2024-08-13

New Feature: Distance Filter for Property Search

We have introduced a new parameter, max_distance, to the /property/search endpoint. This parameter allows users to filter properties by distance from a specified location. When lat and lon are provided, the API will return only properties within the specified distance from the location. This new filter should help you find the properties you want when programatically searching for properties near a specific location.

2024-08-09

New Feature: Unit-Level Security Deposit

When publicly available, we are now extracting security deposit at the unit level. This was applied to all of our historical data and will be automatically extracted moving forward.

2024-08-06

New Feature: Senior and Student Housing Flags

We have introduced two new boolean flags, is_senior and is_student, to the PropertyDetailsResponse object. These flags indicate whether a property is likely to be senior or student housing, based on analysis of text from the property website, unit names, or price patterns.

  • is_senior: Indicates if the property is likely to be senior housing.
  • is_student: Indicates if the property is likely to be student housing.

These enhancements will help users quickly identify and filter properties that cater to senior or student residents, improving the accuracy and relevance of search results.

No action is required from users to enable these features; they will be available automatically upon updating to the latest version.

2024-06-14

New Feature: Online Property Reviews

We’re excited to announce that online property reviews are now available for almost all properties! These reviews are included in the property payload under the review_analysis field.

Our Natural Language Processing model analyzes reviews from multiple sources, extracting key insights on various aspects of the properties. The model highlights both positive and negative elements, and breaks reviews down into their most important topics: location, staff, amenities, cleanliness, and value.

1"review_analysis": {
2    "avg_score": 0.803,
3    "count_reviews": "67",
4    "positive_counts": {
5        "value": 3,
6        "location": 23,
7        "staff_and_management": 21,
8        "amenities_and_features": 19,
9        "cleanliness_and_maintenance": 13
10    },
11    "negative_counts": {
12        "value": 7,
13        "location": 3,
14        "staff_and_management": 7,
15        "amenities_and_features": 18,
16        "cleanliness_and_maintenance": 13
17    }
18}

2024-05-24

  • Added concessions_history as a replacement for specials_history. This uses a new model that extracts more data from the text in property website banners. specials_history has been marked as deprecated.
  • Deprecated lease_lengths, more accurate data can be found on the building_availability list.
  • Deprecated estimated_occupancy, advertised occupancy can be computed from the building_availability list.
  • Deprecated from building_availability, renovated, furnished, den, convertible. These are now available in tags.

2024-05-21

  • Added price_plans to the availability_periods when possible to show what the final lease terms that were offered before the unit was rented.
  • Added tags to each building_availability object when possible. Tags represent standardized names for each amenity based on floorplan names, unit amenities and floorplan images.

2024-05-20

Added number_units_prediction to the response from /property/{id}. This field is an estimate of the number of units in the building based on the listings we have seen, building characteristics and its location. Its intended use is to help you understand the building better when we don’t have the exact number of units. Perfect when filtering for example, but we do not recommend using it for financial analysis (where results are linear with the number of units).

2024-05-14

The /property/comparable endpoint now has a 50 miles radius upper limit. This will help prevent the endpoint from returning unrelated properties when the search area is too large. Speedup the /property/comparable endpoint by up to 5x for some requests in suburban areas. A request might return an empty list of comparable properties if the subject is too different from evertything in the database within the 50 miles radius.

2024-05-09

Include new amenities attribute to each unit object. These amenities come straight from property websites!

2024-04-22

More realistic validation for parameters used for the /comparable endpoint. This will help prevent errors and improve the overall experience when using the endpoint.

2024-04-08

Added availability_periods to each building_availability object to represent the periods this unit was on the market. Added period_id to each history object as a way to associate each price with an availability_period.

2024-04-01

New Filters

The following parameters have been added to the /property/comparable endpoint:

  • allowNullNumberUnits - When used along with minNumberUnits or maxNumberUnits, it allows the endpoint to return properties with unknown number of units.
  • allowNullYearBuilt - When used along with minYearBuilt or maxYearBuilt, it allows the endpoint to return properties with unknown year built.
  • allowNullNumberStories - When used along with minNumberStories or maxNumberStories, it allows the endpoint to return properties with unknown number of stories.

By default, using any of the following filters will exclude properties with unknown values for the respective field:

  • minNumberUnits
  • maxNumberUnits
  • minYearBuilt
  • maxYearBuilt
  • minNumberStories
  • maxNumberStories

More granular settings for renovation

  • Added the renovations parameter to the /property/comparable endpoint - A float between 0 and 1 you can set to boost overall quality score and account for renovations. For example, a value of 0 means no renovations, while a value of 0.3 increases the subject’s overall quality score by 30% (a pretty heavy renovation)

2024-03-27

  • The /property/comparable supports minDistance (in miles)
  • The /property/comparable accepts a simple_subject object with a simplified version of the subject property. This is useful when you don’t have all the details of the subject property, but you have a simplified version of it.

2024-03-21

  • /property/search now supports ZIP+4 formatted zip codes for zip_code query parameters. For example, 90210-1234 is now a valid zip code.

2024-03-19

  • Better error message when an api key is provided but has no access to the requested endpoint

2024-03-15

  • New POST endpoint on /property to insert a new building on the platform

2024-03-02

  • Increased accuracy and fill rate for floors on unit details (items of building_availability), thanks to a new approach to extracting them from unit names.

2024-02-21

  • Deprecated specials field on PropertyDetails. Use specials_history on the same object to get the full history of specials instead.

2024-02-17

/property/comparables additions: Added avg_quality and number_stories fields to aid in confirming comparable properties. 2024-02-14

API documentation revamp: New documentation launched for enhanced developer experience, including the latest updates, deprecations, and features. Endpoint migration: /rentsource/* endpoints are deprecated but remain accessible via /property/* endpoints. /property/comparables filtering expansion: Added minNumberUnits, maxNumberUnits, minYearBuilt, and maxYearBuilt filter parameters.