Agoda API: Search hotels (v1)

Returns one page of 45 properties in a city for dates and guests, with star rating, guest score, area, nightly price with and without taxes, stay total and cancellation terms. Sold-out properties stay in the list without a price. An unknown location is rejected with a 400.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

location*string

location_id from the Locations endpoint (an Agoda city ID such as 9395 for Bangkok), or an agoda.com search link such as https://www.agoda.com/search?city=9395.

Lengthlength <= 1000

checkin*string

Arrival date, YYYY-MM-DD; today or later.

checkout*string

Departure date, YYYY-MM-DD; after checkin and at most 30 nights later.

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"

children?string

Each child's age (0-17), separated by commas. Omit for no children.

Match^(?:\d{1,2}(?:\s*,\s*\d{1,2})*)?$

Lengthlength <= 60

Default""

sort?string

recommended (Agoda's own order), price (lowest first), rating (guest score) or stars (hotel class).

Default"recommended"

Value in

"recommended"
"price"
"rating"
"stars"

page?integer

One-based page of 45 hotels. Prices are live, so a hotel can move between pages from one request to the next.

Range1 <= value <= 200

Default1

curl -X GET "https://example.com/v1/agoda/search?location=9395&checkin=2026-12-10&checkout=2026-12-12" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "location": "9395",    "city": "Bangkok",    "country": "Thailand",    "checkin": "2026-12-10",    "checkout": "2026-12-12",    "adults": 0,    "rooms": 0,    "children": [      0    ],    "currency": "USD",    "sort": "recommended",    "page": 1,    "page_size": 45,    "total": 6650,    "has_more": true,    "count": 0,    "results": [      {        "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,        "url": "https://www.agoda.com/asia-hotel-bangkok/hotel/bangkok-th.html",        "country_code": "TH",        "photo_url": "string",        "is_ad": true,        "is_sold_out": true,        "price": {          "per_night": 50.46,          "per_night_before_taxes": 42.87,          "stay_total_amount": 100.91,          "strike_price": 56.78,          "currency": "USD",          "free_cancellation": true,          "free_cancellation_until": "2026-12-06T00:00:00.000+07:00",          "pay_later": true,          "pay_at_hotel": true,          "rooms_left": 17        }      }    ]  },  "details": {    "reason": "string",    "message": "string"  }}