listing_data
Fetch details about a specific Listing.
This endpoint returns details about a specific listing.
This request will return details such as:
- Number of bedrooms and bathrooms
- Overall Rating
- Review Count
- Metrics such as ADR, Revenue, and Occupancy
- Amenities
get/listing/{listingId}
Path parameters
listingIdstring required
AirDNA ID for the Listing. This can often be found as property_id. The ID is prefixed with the channel the Listing belongs to:
- abnb_ for Airbnb
- vrbo_ for Vrbo
- bkng_ for Booking.com
Smart Rates endpoints currently only model Airbnb Listings; requests with vrbo_* or bkng_* IDs are rejected with a "Smart Rates does not yet model Booking.com / Vrbo listings." envelope.
Example:abnb_XXXXXXXX
Response
Successful Listing Details Response
Example response
{
"payload": {
"property_id": "abnb_xxxxxx",
"details": {
"title": "Large Home in Denver",
"market_name": "Denver",
"accommodates": 16,
"bedrooms": 9,
"bathrooms": 9.5,
"reviews": 50,
"rating": 4.5,
"images": [
"//sample.jpeg"
],
"instant_book": true,
"minimum_stay": 2,
"created_date": "2023-08-10",
"license": "CITQ 092834",
"cleaning_fee": 125
},
"location": {
"lat": 39.748847,
"lng": -104.99891
},
"exact_location": true,
"location_area": {
"country_name": "United States",
"city_name": "Denver",
"state_name": "Colorado",
"msa_name": "Denver-Aurora-Lakewood, CO Metro Area"
},
"metrics": {
"occupancy": 97.14,
"adr": 2623.66,
"revenue": 632301,
"revenue_potential": 678864,
"days_available": 350,
"days_blocked": 15,
"days_reserved": 340,
"num_reservations": 174,
"response_rate": 98,
"response_time": 12.5,
"last_calendar_update": "2024-04-30",
"last_scraped_date": "2024-03-15"
},
"ratings": {
"overall_rating": 4.5,
"airbnb_accuracy_rating": 3,
"airbnb_cleanliness_rating": 4.2,
"airbnb_checkin_rating": 5,
"airbnb_communication_rating": 2.7,
"airbnb_location_rating": 3.9,
"airbnb_value_rating": 4.8
},
"platforms": {
"airbnb_host_id": "5678910",
"airbnb_property_id": "12345678",
"airbnb_property_url": "https://www.airbnb.com/rooms/12345678",
"vrbo_property_id": "34567890ha",
"vrbo_property_url": "https://www.vrbo.com/34567890ha",
"booking_property_id": "1234567",
"booking_property_url": "https://www.booking.com/hotel/us/example.html"
},
"amenities": {
"has_aircon": true,
"has_cable_tv": true,
"has_dryer": true,
"has_family_friendly": true,
"has_heating": true,
"has_hottub": true,
"has_internet": true,
"has_kitchen": true,
"has_parking": true,
"has_pets_allowed": true,
"has_suitable_for_events": true,
"has_tv": true,
"has_washer": true,
"has_wireless_internet": true
},
"country": {
"country_id": 1,
"country_name": "United States"
},
"market": {
"id": "airdna-163",
"name": "Denver",
"market_type": "mountains_lakes",
"market_score": 68.639
},
"professionally_managed": true,
"property_manager": {
"property_manager_name": "Super Awesome Property Manager",
"property_count": 454,
"review_count": 23912
},
"currency": "usd"
},
"status": {
"type": "success",
"response_id": "API-S-XXX",
"message": "A successful request was made."
}
}