Agoda API: Get hotel details and rates (v1)

Returns a hotel's address, description, photos, facilities, check-in times and guest scores; with dates, also every room type with its live rates, taxes and cancellation terms for the adults and rooms asked. data is null for a hotel ID Agoda does not know.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

hotel*string

hotel_id from a search or locations result, or an agoda.com link that carries it, such as https://www.agoda.com/search?selectedproperty=10636. Find a hotel by name with the Locations endpoint.

Lengthlength <= 1000

checkin?string

Arrival date, YYYY-MM-DD. With checkout, adds rooms with live rates; omit both for the hotel profile only.

checkout?string

Departure date, YYYY-MM-DD. Required together with checkin.

adults?integer

Adults across all rooms.

Range1 <= value <= 16

Default2

rooms?integer

Rooms to book.

Range1 <= value <= 8

Default1

currency?string

ISO 4217 currency for every price, such as USD, EUR or THB.

Match^[A-Z]{3}$

Default"USD"

curl -X GET "https://example.com/v1/agoda/hotel?hotel=10636" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "hotel_id": "10636",    "name": "Asia Hotel Bangkok",    "star_rating": 4,    "star_rating_scale_max": 5,    "property_type": "Hotel",    "city": "Bangkok",    "neighborhood": "Siam",    "country": "Thailand",    "latitude": 13.7514,    "longitude": 100.53109,    "review_score": 8.3,    "review_score_scale_max": 10,    "review_count": 64941,    "street_address": "296 Phayathai Road",    "postal_code": "10400",    "full_address": "296 Phayathai Road, Siam, Bangkok, Thailand, 10400",    "city_id": "9395",    "description": "string",    "subscores": [      {        "type": "cleanliness",        "label": "Cleanliness",        "score": 8.2      }    ],    "facilities": [      {        "group": "Things to do, ways to relax",        "items": [          "Fitness center"        ]      }    ],    "useful_info": [      {        "group": "Check-in/Check-out",        "items": [          {            "label": "Check-in from",            "value": "15:00"          }        ]      }    ],    "photos": [      {        "url": "https://pix8.agoda.net/hotelImages/10636/0/ef2310543ae8a48fd0db47e19b615b57.jpeg?ce=2",        "caption": "Entrance"      }    ],    "checkin": "2026-12-10",    "checkout": "2026-12-12",    "currency": "USD",    "rooms": [      {        "room_id": "3085770",        "name": "Superior Twin Room - Non-Smoking",        "max_occupancy": 2,        "beds": "2 single beds",        "features": [          "Room size: 27 m²/291 ft²",          "City view"        ],        "amenities": [          "Air conditioning",          "Free Wi-Fi in all rooms!"        ],        "photos": [          "string"        ],        "rates": [          {            "name": "Superior Twin Room - Non-Smoking",            "per_night": 59.77,            "stay_total_amount": 119.53,            "taxes_and_fees": 17.97,            "currency": "USD",            "free_cancellation": true,            "cancellation": "Cancel for free before December 6, 2026",            "pay_later": true,            "breakfast_included": true,            "perks": [              "Parking",              "Free WiFi"            ],            "max_occupancy": 2,            "rooms_left": 17,            "sold_by": "Agoda.com"          }        ]      }    ]  },  "details": {    "reason": "string",    "message": "string"  }}