Get the unit pricing for a property given its details. We use all property and unit details (characteristics, amenities, location, etc.)
to find similar units in the market that have been rented recently. We then use the rent prices of these units to estimate the unit pricing.
Request
This endpoint expects an object.
subject
objectRequired
The content of the property for which to compute the recommended pricing.
settings
objectOptional
The settings for computing the recommended pricing. For example to exclude
the subject property from the comps analysis, to limit the search radius for
comparable properties, or to filter the data to include only units occurring
within a specific date range.
Response
This endpoint returns a list of objects
unit
object
The PricingUnit object represents rudimentary information about a unit and its pricing. It is returned when querying a property's recommended pricing instead of the full unit details.
supporting_units
list of objects
predicted_price
doubleOptional
The recommended rent for the unit, based on an analysis of comparable units.
predicted_price_sqft
doubleOptional
The recommended rent per square foot of the unit, based on an analysis of comparable units.
POST
1
curl -X POST https://api.hellodata.ai/property/pricing \
2
-H "x-api-key: <apiKey>" \
3
-H "Content-Type: application/json" \
4
-d '{
5
"subject": {
6
"id": "52907745-7672-470e-a803-a2f8feb52944",
7
"street_address": "111 West Wacker Drive",
8
"street_address_alias": [
9
"street_address_alias"
10
],
11
"city": "Chicago",
12
"state": "IL",
13
"zip_code": "60601",
14
"lat": 41.88651,
15
"lon": -87.63141,
16
"building_name_alias": [
17
"building_name_alias"
18
],
19
"specials_history": [
20
{
21
"specials": "1 month free on 12 month lease if you move in by 12/31/2021",
22
"from_date": "2021-01-01",
23
"to_date": "2021-01-01"
24
}
25
],
26
"pricing_strategy": {},
27
"created_on": "2021-01-01",
28
"building_quality": {},
29
"building_availability": [
30
{
31
"id": "52907745-7672-470e-a803-a2f8feb52944",
32
"is_floorplan": true,
33
"renovated": false,
34
"furnished": true,
35
"den": false,
36
"convertible": true,
37
"created_on": "2021-01-01",
38
"history": [
39
{
40
"from_date": "2021-01-01",
41
"to_date": "2021-01-01"
42
}
43
],
44
"price_plans": [
45
{
46
"duration_in_months": 12,
47
"specials": "Special incentives available at OneEleven! Enjoy up to a half month free on select apartments."