Comparables

POST

Find the best rent comps for a property given its details among close by properties. Score different facets of all candidates and return the best ones. In order to get the best results, we leverage market demographics, detected quality, amenities, similarity of unit mixes, and more.

  • Data completion: feel free to complete the record with extra data only you have access to or if you want to override the data we have. For example, what would be the rent of the property if it was in a better condition? You can increase the quality of the property and see how the comps change.
  • Extra Filters: you can set extra filters. For example, you can set a maximum distance between the subject and the rent comps, a minimum number of units, a maximum number of units, a minimum year built, and a maximum year built.
  • Exclusions: you can exclude properties from the results. For example, you can exclude properties that are not good comps or properties that have already been selected. We will make sure we don’t return them in the results.
  • Already Selected: you can also pass the ids of the properties that you want to force into the results.

Computing Similarities:

If you are interested in simply getting similarities between properties, you can use the comparables endpoint. Pass the ids of the comps you want similarities for into the selected_ids field. And set topN to the same number of properties you are passing. We will return the similarities between the subject and the selected properties.

Query parameters

topNdoubleOptional

The number of rent comps to return.

tier"valueAdd" or "current"Optional

The tier of the property. Either ‘valueAdd’ or ‘current’. When ‘valueAdd’, the results will assume a better condition of the property.

Allowed values: valueAddcurrent
renovationsdoubleOptional

The renovations to apply to the property. A value between 0 and 1 to add to the property quality. (e.g. 0.1 will transform a 0.4 quality property into a 0.5 quality property).

maxDistancedoubleOptional

The maximum distance in miles between the subject and the rent comps.

minDistancedoubleOptional

The minimum distance in miles between the subject and the rent comps.

minNumberUnitsdoubleOptional

The minimum number of units of the rent comps. Does not filter properties with no units.

maxNumberUnitsdoubleOptional

The maximum number of units of the rent comps. Does not filter properties with no units.

allowNullNumberUnitsbooleanOptional

Whether to allow properties with no units to be included in the results. False by default.

minYearBuiltdoubleOptional

The minimum year built of the rent comps. Does not filter properties with no year built.

maxYearBuiltdoubleOptional

The maximum year built of the rent comps. Does not filter properties with no year built.

allowNullYearBuiltbooleanOptional

Whether to allow properties with no year built to be included in the results. False by default.

minNumberStoriesdoubleOptional

The minimum number of stories of the rent comps. Does not filter properties with no stories.

maxNumberStoriesdoubleOptional

The maximum number of stories of the rent comps. Does not filter properties with no stories.

allowNullNumberStoriesbooleanOptional

Whether to allow properties with no stories to be included in the results. False by default.

Request

This endpoint expects an object.
selected_idslist of stringsOptional

Force include some properties in the results

excluded_idslist of stringsOptional

Exclude some properties from the results that are not suitable for comparison.

simple_subjectobjectOptional

A simple property object that can come from your systems if you only have the basic information about the property. We will use the basic information to find the most similar properties.

subjectobjectOptional

A detailed property object if you have queried the property details from /property/{id}. We will use all the available information to find the most similar properties, including market statistics, detailed quality scores, unit details and detected values for missing fields.

Response

The list of rent comps with high-level details.

comparableslist of objects
competition_profilelist of objectsOptional
Built with