How do the Object table and JSON output of property valuations rentalizer API of AirDNA work?
In this article, I will clarify the object table and JSON output of the AirDNA property valuations rentalizer API. Specifically, I will describe the structure and contents of the object table and explain how the data is formatted in the JSON output. It is important to understand the object table and JSON output in order to effectively use and manipulate the data provided by the API.
Object Table
Objects | Description |
access_token | {{CLIENT_TOKEN}} |
address | Optional: Must provide either address or latitude & longitude location |
bedrooms | number of bedrooms |
bathrooms | number of bathrooms |
accommodates | number of accommodates |
currency | Optional: Specify 'usd' or 'native' to return results in either USD or the local currency of the address |
lat | Optional: Must provide either address or latitude & longitude location |
lng | Optional: Must provide either address or latitude & longitude location |
show_urls | rentalizer URL |
access_token: a string value representing the client's access token. This is required for authenticating the API request.
address: a string value representing the address of the property. This is optional and can be provided as an alternative to latitude and longitude coordinates.
bedrooms: an integer value representing the number of bedrooms in the property.
bathrooms: an integer value representing the number of bathrooms in the property.
accommodates: an integer value representing the maximum number of people the property can accommodate.
currency: a string value specifying the currency in which the property valuation should be returned. This is optional and can be either 'usd' for US dollars or 'native' for the local currency of the address.
lat: a floating point value representing the latitude coordinate of the property's location. This is optional and must be provided along with the 'lng' value if used.
lng: a floating point value representing the longitude coordinate of the property's location. This is optional and must be provided along with the 'lat' value if used.
show_urls: a boolean value indicating whether or not to include the rentalizer URL in the API response. If set to 'true', the URL will be included.
The information in the table is useful because it clearly defines the parameters that can be included in an API request to the AirDNA property valuations rentalizer. By understanding the available objects and their descriptions, a developer can accurately construct a request and receive a relevant and useful response. For example, by including the 'bedrooms' and 'bathrooms' objects in the request, the API will return a valuation for a property with the specified number of bedrooms and bathrooms. Similarly, the 'currency' object allows the developer to specify the desired currency for the valuation. Overall, the information in the table helps ensure that the API is used correctly and effectively.
JSON output explained
This JSON output contains information about a property, including its address, number of bedrooms and bathrooms, maximum capacity, location coordinates, currency symbol, and URLs for the market minder and rentalizer. It also includes statistical data about the property, such as revenue and occupancy rate for the current year and the previous year, as well as a range of values for these statistics. Additionally, there is data on the total number of comparable properties and historical valuations for the property. This information is organized in a hierarchical structure, with the property details and property stats objects containing further nested objects and arrays.
{
"permission": "full",
"property_details": {
"address": "525 Pier Ave Santa Monica CA",
"address_lookup": "525 Pier Ave Santa Monica CA",
"zipcode": null,
"bedrooms": 3,
"bathrooms": 2,
"accommodates": 6,
"property_value": 2414000,
"location": {
"lat": 39.739235,
"lng": -104.99025
},
"currency_symbol": "$",
"market_minder_url": "https://www.airdna.co/market-data/app/us/colorado/denver/overview",
"rentalizer_url": "https://www.airdna.co/rentalizer?address=525 Pier Ave Santa Monica CA&bedrooms=3&bathrooms=2.0&accommodates=6"
},
"property_stats": {
"revenue": {
"2021": {
"10": 8316,
"11": 5968,
"12": 4949
},
"2022": {
"1": 3937,
"2": 5330,
"3": 4375,
"4": 6166,
"5": 7239,
"6": 7845,
"7": 9642,
"8": 8793,
"9": 9412
},
"ltm": 81972
},
"adr": {
"2021": {
"10": 369.87,
"11": 318.78,
"12": 341.63
},
"2022": {
"1": 338.44,
"2": 365.49,
"3": 320.05,
"4": 299.95,
"5": 324.26,
"6": 348.52,
"7": 426.71,
"8": 400.58,
"9": 415.44
},
"ltm": 355
},
"occupancy": {
"2021": {
"10": 0.73,
"11": 0.62,
"12": 0.47
},
"2022": {
"1": 0.38,
"2": 0.52,
"3": 0.44,
"4": 0.69,
"5": 0.72,
"6": 0.75,
"7": 0.73,
"8": 0.71,
"9": 0.76
},
"ltm": 0.63
},
"total_comps": 9,
"historical_valuation": {
"2019": {
"10": 55199,
"11": 55359,
"12": 55921
},
"2020": {
"1": 55610,
"2": 55933,
"3": 55933,
"4": 55101,
"5": 58635,
"6": 60097,
"7": 64431,
"8": 66588,
"9": 68838,
"10": 71488,
"11": 73496,
"12": 74815
},
"2021": {
"1": 76170,
"2": 78154,
"3": 78070,
"4": 79917,
"5": 78767,
"6": 79794,
"7": 79083,
"8": 79922,
"9": 81972
},
"mom_perc_chg": 2.56,
"yoy_perc_chg": 19.07
},
"revenue_range": {
"2021": {
"10": {
"upper": 8578,
"lower": 8053
},
"11": {
"upper": 6234,
"lower": 5701
},
"12": {
"upper": 5056,
"lower": 4841
}
},
"2022": {
"1": {
"upper": 4143,
"lower": 3730
},
"2": {
"upper": 5585,
"lower": 5074
},
"3": {
"upper": 4608,
"lower": 4141
},
"4": {
"upper": 6478,
"lower": 5853
},
"5": {
"upper": 7698,
"lower": 6779
},
"6": {
"upper": 8202,
"lower": 7487
},
"7": {
"upper": 10149,
"lower": 9134
},
"8": {
"upper": 9166,
"lower": 8419
},
"9": {
"upper": 9910,
"lower": 8913
}
},
"ltm": {
"upper": 85814,
"lower": 78129
}
}
},
"comps": [
{
"airbnb_property_id": 50208825,
"cover_img": "https://a0.muscache.com/im/pictures/prohost-api/Hosting-50208825/original/5184b4a2-ea26-41e6-b467-a899c6c85a15.jpeg?aki_policy=x_large",
"title": "NEW! Chic Denver Escape w/ Rooftop Near Downtown!",
"room_type": "Entire home/apt",
"property_type": "Townhouse",
"reviews": 2,
"rating": 9,
"platforms": {
"airbnb_property_id": "50208825",
"vrbo_property_id": "9576930ha"
},
"distance_meters": 301,
"listing_url": "https://www.airbnb.com/rooms/50208825",
"location": {
"lat": 39.73847,
"lng": -104.99363
},
"bedrooms": 3,
"bathrooms": 3,
"accommodates": 7,
"stats": {
"revenue": {
"2020": {
"10": null,
"11": null,
"12": null
},
"2021": {
"1": null,
"2": null,
"3": null,
"4": null,
"5": null,
"6": null,
"7": 9844,
"8": 8189,
"9": 11791
},
"ltm": 29824
},
"revenue_potential": {
"2020": {
"10": 14099,
"11": 8489,
"12": 7511
},
"2021": {
"1": 5310,
"2": 5178,
"3": 6942,
"4": 8102,
"5": 10666,
"6": 13543,
"7": 9844,
"8": 8189,
"9": 11791
},
"ltm": 109669
},
"adr": {
"2020": {
"10": null,
"11": null,
"12": null
},
"2021": {
"1": null,
"2": null,
"3": null,
"4": null,
"5": null,
"6": null,
"7": 518,
"8": 409,
"9": 453
},
"ltm": 460
},
"days_available": {
"ltm": 92
},
"occupancy": {
"2020": {
"10": null,
"11": null,
"12": null
},
"2021": {
"1": null,
"2": null,
"3": null,
"4": null,
"5": null,
"6": null,
"7": 0.61,
"8": 0.65,
"9": 0.87
},
"ltm": 0.7
}
}
},
{
"airbnb_property_id": 42858367,
"cover_img": "https://a0.muscache.com/im/pictures/e248e372-0b17-430a-b75b-1870c8ac1235.jpg?aki_policy=x_large",
"title": "Hip Townhome w/ Rooftop VIEWS - Walk to Everything",
"room_type": "Entire home/apt",
"property_type": "Townhouse",
"reviews": 20,
"rating": 9.8,
"platforms": {
"airbnb_property_id": "42858367",
"vrbo_property_id": null
},
"distance_meters": 673,
"listing_url": "https://www.airbnb.com/rooms/42858367",
"location": {
"lat": 39.73321,
"lng": -104.98937
},
"bedrooms": 3,
"bathrooms": 3,
"accommodates": 8,
"stats": {
"revenue": {
"2020": {
"10": 6432,
"11": 5657,
"12": 2422
},
"2021": {
"1": 1267,
"2": 6390,
"3": 2310,
"4": 9110,
"5": 16629,
"6": 7026,
"7": 9861,
"8": 15210,
"9": 13500
},
"ltm": 95816
},
"revenue_potential": {
"2020": {
"10": 14050,
"11": 11898,
"12": 2580
},
"2021": {
"1": 1267,
"2": 8852,
"3": 9121,
"4": 11968,
"5": 16629,
"6": 13721,
"7": 17844,
"8": 15478,
"9": 13500
},
"ltm": 136913
},
"adr": {
"2020": {
"10": 584,
"11": 565,
"12": 605
},
"2021": {
"1": 633,
"2": 580,
"3": 577,
"4": 569,
"5": 554,
"6": 585,
"7": 986,
"8": 760,
"9": 750
},
"ltm": 646
},
"days_available": {
"ltm": 240
},
"occupancy": {
"2020": {
"10": 0.79,
"11": 1,
"12": 0.14
},
"2021": {
"1": 0.06,
"2": 0.65,
"3": 0.8,
"4": 0.84,
"5": 0.97,
"6": 0.92,
"7": 0.71,
"8": 0.71,
"9": 0.62
},
"ltm": 0.62
}
}
},
....
Conclusion
In this article, we discussed the object table and JSON output of the AirDNA property valuations rentalizer API. We explained the various objects that can be used as inputs to the API to specify properties and the desired output, and provided examples of the JSON output that can be received in response. This output includes detailed information about a property, including its location, size, value, and performance data. We also provided a brief overview of how this information can be useful for anyone looking to use the AirDNA rentalizer API to obtain accurate and relevant property valuations.
Footnote
The AirDNA property valuations rentalizer API is a powerful tool that allows users to obtain accurate and up-to-date valuations for properties around the world. If you are interested in accessing this API, you can do so through the third party data marketplace of Worldindata. Worldindata is a platform that connects users with a wide range of data sources, including APIs, databases, and other types of digital content. By using Worldindata, you can easily search for and find the data you need, and request access to specific APIs, such as the AirDNA rentalizer API, with just a few clicks. Whether you are a developer looking to build a new application, a data scientist seeking to analyze trends and patterns, or simply someone who is curious about the value of properties in a particular area, Worldindata can help you get the data you need to make informed decisions.