A real-time REST API for hotel and vacation-rental data across Expedia, Booking.com, Airbnb and Amadeus. Authenticate with an X-API-Key header, POST a query, and receive structured JSON or CSV.
| Endpoint | Method | Data vertical | Target engines | Key fields returned | Format |
|---|---|---|---|---|---|
/api/v1/hotel/search | POST | Hotels | Booking.com, Expedia, Amadeus | hotelId, name, address, geo, star_rating, amenities | JSON / CSV |
/api/v1/hotel/rates | POST | Hotels | Booking.com, Expedia, Amadeus | hotelId, room_rates, currency, board_type, platform | JSON / CSV |
/api/v1/airbnb/search | POST | Vacation Rentals | Airbnb | listing_id, title, room_type, host_ratings, lat, lng | JSON / CSV |
/api/v1/airbnb/price | POST | Vacation Rentals | Airbnb | listing_id, base_rate, cleaning_fees, service_fee, calendar | JSON / CSV |
| Parameter | Value | Notes |
|---|---|---|
| Base URL | https://hoteldata.tagxdata.com | Single host for all verticals |
| Authentication | X-API-Key header | Per-key rate limiting & usage metering |
| Protocol | HTTPS REST · POST | JSON request body |
| Engine type | Real-time | Live rate retrieval on request, no cached staleness |
| Latency | ~1.5–4s typical | Per live rate query against target OTA |
| Response formats | JSON, CSV | Structured, schema-stable objects |
| Target engines | Expedia, Booking.com, Airbnb, Amadeus | Hotels + vacation rentals |
| Anti-bot | Proxy rotation · JA3 evasion · CAPTCHA solving | Managed, transparent to the caller |
POST to /api/v1/hotel/rates with your X-API-Key and a JSON body containing hotel_id, check_in, check_out and currency. The API returns a structured room_rates array with base_rate, taxes_and_fees and total_rate per room.
curl -X POST https://hoteldata.tagxdata.com/api/v1/hotel/rates \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"hotel_id": "exp_19482733",
"check_in": "2025-09-14",
"check_out": "2025-09-17",
"currency": "USD",
"platform": "expedia"
}'{
"hotelId": "exp_19482733",
"platform": "expedia",
"currency": "USD",
"check_in": "2025-09-14",
"check_out": "2025-09-17",
"room_rates": [
{
"room_type": "Deluxe King",
"board_type": "room_only",
"base_rate": 184.00,
"taxes_and_fees": 41.28,
"total_rate": 225.28,
"refundable": true,
"available": true
},
{
"room_type": "Executive Suite",
"board_type": "breakfast_included",
"base_rate": 312.50,
"taxes_and_fees": 70.31,
"total_rate": 382.81,
"refundable": false,
"available": true
}
],
"retrieved_at": "2025-08-21T09:41:06Z"
}Each target engine maps to a documented endpoint and a fixed, schema-stable response. Below are the exact properties returned per integration.
POST /api/v1/hotel/ratesPull live Booking.com hotel rates and availability through a single REST call. The TagX Booking.com API returns normalized rate objects per room and stay window, ready for price comparison engines and revenue-management models.
hotelIdroom_rates[]board_typecancellation_policycurrencyavailabilityplatformPOST /api/v1/hotel/ratesScrape Expedia hotel rates in real time with full tax and fee breakdowns. The Expedia rates endpoint exposes per-room pricing so you can reconstruct the exact total a traveller would see at checkout.
hotelIdbase_ratetaxes_and_feestotal_raterefundableroom_typeretrieved_atPOST /api/v1/airbnb/priceQuery Airbnb listing pricing including the fees most APIs hide. The TagX Airbnb price endpoint extracts base_rate, cleaning_fees, host_ratings and real-time calendar arrays so you can model the true nightly cost across any date range.
listing_idbase_ratecleaning_feesservice_feehost_ratingscalendar[]minimum_nightsPOST /api/v1/hotel/searchDiscover and resolve hotel inventory across Amadeus and major OTAs. The hotel search endpoint maps a destination or property query to canonical hotel records with geo-coordinates, ratings and amenities for downstream rate lookups.
hotelIdnameaddressgeo{lat,lng}star_ratingamenities[]review_scorePOST /api/v1/airbnb/searchEnumerate Airbnb vacation rentals by market with structured listing metadata. The Airbnb search endpoint returns room type, capacity and host signals for supply analysis and competitive benchmarking.
listing_idtitleroom_typeperson_capacityhost_ratingslatlngsearch → ratesChain /hotel/search into /hotel/rates to go from a free-text destination to live, comparable rates across Booking.com, Expedia and Amadeus in two calls, with stable hotelId joins between verticals.
hotelIdplatformroom_rates[]currencycheck_incheck_outFrom live flight fares and hotel availability to vacation rental pricing and destination reviews — one API, six data verticals, coverage across Booking.com, Expedia, Airbnb, Skyscanner, MakeMyTrip, and 500+ more travel sources
Parsed one-way, round-trip, and multi-city prices from premier aggregators.
Talk to our team to get set up with live rates from Expedia, Booking.com and Airbnb — with the volume, coverage and SLAs to match your use case.
Live OTA coverage · JSON & CSV output · Fully managed service
Direct, factual answers to the questions developers ask about the TagX Travel Data API, hotel rates, Airbnb pricing and anti-bot handling.
POST to https://hoteldata.tagxdata.com/api/v1/hotel/rates with an X-API-Key header and a JSON body containing hotel_id, check_in, check_out and currency. The response returns a room_types array with room_type, base_rate, taxes_and_fees and total_rate for each available room — retrieved live at request time, not from a cache.
The API covers Expedia, Booking.com, Airbnb and Amadeus (TravelClick). Hotels are available via /api/v1/hotel/search and /api/v1/hotel/rates, and vacation rentals via /api/v1/airbnb/search, /api/v1/airbnb/price and /api/v1/airbnb/details.
Authentication is a single X-API-Key request header — no OAuth or token exchange. Pass X-API-Key: hapi_your_api_key on every request. A free API key is available so you can validate data quality before committing, and you can check your balance any time via GET /api/v1/credits.
Yes. POST to /api/v1/airbnb/price with room_id, check_in and check_out to receive the listing's real pricing, including base rate, cleaning and service fees, so you can reconstruct the true total nightly cost rather than just the advertised rate.
Every endpoint returns normalized, schema-stable JSON by default, with CSV available for bulk and analytics workflows. Fields such as property_id, room_types, rate_plans and base_rate stay consistent across platforms so responses are safe to parse programmatically.
