Use Case Overview
This search allows users to find hotels within a specified radius around a given airport. It’s particularly useful for users looking for accommodations near airports for convenience, layovers, or quick access to urban cities associated with the airport’s location.
Parameters
- Airport Code: A 3-letter IATA airport code (e.g., “JFK” for John F. Kennedy International Airport).
- Radius: The distance in miles around the airport to include in the search results.
Airport code is referred to as iata_code in the location type.
Example
A user searching for hotels around “JFK” with a radius of 10 miles would retrieve a list of hotels located within 10 miles of JFK Airport.
{
"stay_info": {
"check_in_date": "2025-01-01",
"check_out_date": "2025-01-03",
"guests": {
"adults": 1
}
},
"filter": {
"location": {
"type": "iata_code",
"details": {
"iata_code": "JFK"
},
"radius": {
"value": 10,
"type": "mi"
}
}
}
}