docs / agoda

Agoda API scraper

base /agoda/v14 endpoints

post/agoda/v1/destinations1 credit

Resolve a free-text place ('Bangkok', 'Tokyo', 'Maldives', an airport or a landmark) into Agoda's destination ids. Returns matched cities, areas, airports, points of interest and hotels with their object_id, type and (for cities) the city_id + hotel count. Use this first to get the city_id the city_browse action needs.

Parameter		Allowed / range	Description
query	required	—	Place to look up — a city, area, airport, landmark or hotel name.
language = en-us	optional	—	Agoda locale for result names (e.g. en-us, th-th, ja-jp, zh-cn). Defaults to en-us.

Try in playground →

post/agoda/v1/city_browse1 credit

Browse a city's popular hotels and accommodation themes. Returns ~100 popular hotels (name + Agoda detail URL), property-type theme links (apartments, hostels, resorts…) and the city's travel guides. Pass a numeric city_id from the destinations action.

Parameter		Allowed / range	Description
city_id	required	—	Agoda city id (from the destinations action — e.g. 9395=Bangkok). Routes the listing geographically.
language = en-us	optional	—	Agoda locale (en-us, th-th, ja-jp…).

Try in playground →

post/agoda/v1/detail1 credit

Full hotel record by hotel_id (or hotel URL): name, accommodation type, star rating, full address + city/country, coordinates, description, facilities (grouped), policies, important notes, nearby places of interest and the property FAQ.

Parameter		Allowed / range	Description
hotel_id	optional	—	Agoda hotel id (the number in a hotel page's data-hotel-id, also the hotel_id in detail responses). Provide hotel_id OR url.
url	optional	—	Full Agoda hotel page URL (the engine extracts the hotel id from it). Use this when you have the hotel link but not the numeric id.
language = en-us	optional	—	Agoda locale (en-us, th-th, ja-jp…).

Try in playground →

post/agoda/v1/reviews1 credit

Paginated guest reviews for one hotel (70 per page): star rating, title, separate positive/negative text, review date, reviewer country, traveler type, room type and length of stay, the owner's reply and helpful votes. The response also carries the hotel's overall score and total review count. Page with `page` until meta.has_more is false.

Parameter		Allowed / range	Description
hotel_id	optional	—	Agoda hotel id (the number in a hotel page's data-hotel-id, also the hotel_id in detail responses). Provide hotel_id OR url.
url	optional	—	Full Agoda hotel page URL (the engine extracts the hotel id from it). Use this when you have the hotel link but not the numeric id.
page = 1	optional	1–500	Review page (70 reviews each). Page until meta.has_more is false; meta.total_pages tells you how many.
sort_by = newest	optional	newest · rating_high · rating_low · most_helpful	Review order: newest (default), rating_high, rating_low or most_helpful.
language = en-us	optional	—	Agoda locale (en-us, th-th, ja-jp…).

Try in playground →

Example request · destinations

curl -X POST https://api.reefapi.com/agoda/v1/destinations \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"Bangkok"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}