orbitz.com APIorbitz.com ↗
Search Orbitz hotels and destinations via API. Get region IDs, hotel listings with pricing, and detailed property data including amenities and coordinates.
curl -X GET 'https://api.parse.bot/scraper/f1e72489-f062-425f-b9f3-d38c97a881ed/location_typeahead?query=London' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for travel destinations by name and get region IDs, coordinates, and location type. Returns up to 10 matching locations including cities, airports, neighborhoods, and points of interest.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search query for location (e.g., 'New York', 'Paris', 'London') |
{
"type": "object",
"fields": {
"locations": "array of location objects with regionId, primaryText, secondaryText, displayName, type, coordinates, and country"
},
"sample": {
"data": {
"locations": [
{
"type": "CITY",
"country": {
"name": "France",
"isoCode2": "FR"
},
"regionId": "2734",
"coordinates": {
"latitude": "48.853564",
"longitude": "2.348095"
},
"displayName": "Paris, France",
"primaryText": "Paris",
"secondaryText": "Paris, France"
}
]
},
"status": "success"
}
}About the orbitz.com API
The Orbitz API covers 3 endpoints that let you search travel destinations, find hotels by region and date, and retrieve full property details. Starting with location_typeahead, you can resolve a city name or airport code into a regionId, then pass that ID directly into search_hotels to pull live hotel listings. Each hotel object returned by get_hotel_details includes address, star rating, amenities, coordinates, and up to 10 gallery images.
Destination Search and Region IDs
The location_typeahead endpoint accepts a query string — a city name, airport, neighborhood, or point of interest — and returns up to 10 matching location objects. Each object includes a regionId, primaryText, secondaryText, displayName, type, coordinates, and country. The regionId is the key value: it acts as the required input for hotel searches and ties location lookup to inventory retrieval.
Hotel Search
Once you have a regionId, pass it to search_hotels along with check_in and check_out dates (YYYY-MM-DD format). The optional adults parameter sets the number of adults per room. The endpoint returns an array of hotel objects with pricing and images drawn directly from Orbitz listings for those dates.
Hotel Details
The get_hotel_details endpoint takes a property_id from search results and returns a single property record. Fields include name, address (with full_address, city, province, and country_code), coordinates (latitude and longitude), star_rating, tagline, amenities as a string array, and images — each image object carries a url and a description. Star rating and tagline are nullable and may not be present for every property.
- Build a hotel price comparison tool using
search_hotelsresults keyed byregionId - Populate a destination autocomplete input using
location_typeaheadresults for cities and airports - Display a hotel detail page with gallery images and amenities from
get_hotel_details - Map hotel locations using
coordinatesreturned byget_hotel_details - Filter hotel search results by date range using
check_inandcheck_outparameters - Resolve user-typed destination names to stable region IDs for downstream travel workflows
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Orbitz have an official developer API?+
What does `location_typeahead` return beyond city names?+
regionId, displayName, type, coordinates, and country — not just the place name.Does `get_hotel_details` return room-level pricing or availability?+
Can I search for flights or car rentals through this API?+
Is `star_rating` always present in hotel detail responses?+
star_rating field is nullable, as is tagline. Not every property on Orbitz carries a star classification, so callers should handle null values for both fields.