API Reference
Search Agoda hotels, homes, activities, and flights and get detail and amenity data as structured JSON. 8 endpoints documented below.
curl "https://api.crawlora.net/api/v1/agoda/hotels/search?city_id=9395" \
-H "x-api-key: $CRAWLORA_API_KEY"Agoda's Hotels, Homes, Things To Do, and Flights surfaces run on internal GraphQL APIs. Crawlora's Agoda endpoints replay these directly and return hotel and home listings, activity search and detail, and flight offers as normalized JSON — no account or signed session required. A pull on 2026-10-27 for Bangkok resolved to city id 9395 and showed that hotel search returns property ids, activity search returns 8 activities and flight location search returns 10 city and airport suggestions, while the homes search returned none.
/agoda/hotels/search, /agoda/homes/search and /agoda/activities/search take a city name or a city_id with page and limit; activities also accept a free-text keyword and, without one, list the resolved city's activities. Hotel search returns property ids and listing links, not full detail.
/agoda/hotels/{property_id} returns the property's identity, accommodation type code, address and the rest of the hotel record. /agoda/activities/{activity_id} returns title, description, stated duration, categories and content images.
/agoda/flights/search requires origin, destination and departure_date as IATA codes and takes adults, children, infants, cabin_class and page. Resolve city or airport names to codes first with /agoda/flights/search-locations; /agoda/flights/itinerary-amenities takes segments copied from a search result and returns aircraft type, seat layout, meals, entertainment and wifi.
Passing city=Bangkok resolved to city_id 9395, which you can reuse across hotel, home and activity searches. Store the id with the name.
hotels search returned 10 properties with a property_id (1254412 first) and a source_url, so fetch hotel detail for names and rates. Page and limit control the window.
homes search for Bangkok returned count 0 with a null list. Treat a null as no results and try a smaller or different city id.
flights search-locations for Bangkok returned 10 suggestions, with the BKK city code, a list of two airports (Suvarnabhumi Airport first) and country and state names. Use the code as origin or destination.
/agoda/activities/{activity_id}apiKey3 credits/requestReturns full activity detail from Agoda: title, description, stated duration, categories, and content images.
Required: activity_id.
Sampled 14 Oct 2026: 10 items. Filled in every item: url, image_type. In the sample: url: pix6.agoda.net.
/agoda/activities/searchapiKey3 credits/requestReturns Agoda activities (tours, attractions, experiences) matching a free-text keyword and/or a city. When keyword is omitted, the resolved city's name is used instead to return a general listing of activities in that city. Callers may supply a known Agoda city id or a free-text city name for the city filter; when both are supplied city_id takes precedence.
Optional: keyword, city_id, city.
Sampled 14 Oct 2026: 3 items. Filled in every item: activity_id, name, city_id, city_name, categories, source_url. In the sample: name: “Bangkok Chim Chum | Bangkok” and 2 other values; source_url: agoda.com; categories: median 1 entry; city_name: “Bangkok”.
/agoda/flights/itinerary-amenitiesapiKey3 credits/requestReturns real-content amenities (aircraft type, seat layout, meals, entertainment, wifi) for one or more flight segments. Copy the segments straight from a flight search response's own segment fields.
Required: body.
Sampled 14 Oct 2026: 1 item. Filled in every item: flight_number.
/agoda/flights/search-locationsapiKey3 credits/requestResolves a free-text city or airport name into IATA airport codes for flight search, with each city's direct and nearby airports.
Required: keyword.
Sampled 14 Oct 2026: 10 items. Filled in every item: name, country_code, country_name, state_name. Not in every item: city_code (1), airports (2), nearby_airports (9). In the sample: name: “Bangkok” and 9 other values; airports: median 1 entry; country_name: “Thailand” and 6 other values; state_name: “Bangkok Province” and 8 other values; nearby_airports: median 2 entries.
/agoda/flights/searchapiKey3 credits/requestReturns bookable one-way flight itineraries between two IATA airport codes for a departure date, including per-segment flight number, airline, times, layovers, aircraft type, and price. Resolve free-text city/airport names to codes first via the flight destination search endpoint.
Required: origin, destination, departure_date. Optional: adults, children, infants, cabin_class (4 allowed values: Economy, PremiumEconomy, Business, First), page.
Sampled 14 Oct 2026: 20 items. Filled in every item: bundle_ref_id, price, duration, stops_count, airline, segments, source_url. In the sample: stops_count: 0 to 2, median 1; duration: “16h 45m” and 19 other values; source_url: agoda.com; segments: median 2 entries.
/agoda/homes/searchapiKey3 credits/requestReturns Homes & Apartments results for an Agoda city: full listing detail for every matching property whose accommodation type is Apartment. Callers may supply a known Agoda city id or a free-text city name; when both are supplied city_id takes precedence.
Optional: city_id, city, page, limit.
Sampled 14 Oct 2026: 3 items. Filled in every item: property_id, display_name, accommodation_type, rating, address, number_of_rooms, children_stay_free_type_id, description_long and 4 more. Not in every item: chain_id (1). In the sample: rating: 2 to 4, median 3.5; description_short: “. Unwind and Enjoy at The Quarter Ploenchit by UHG (SHA Plu…” and 2 other values; main_image_url: pix8.agoda.net; description_long: median 22,021 characters; number_of_rooms: 75 to 129, median 112; source_url: agoda.com.
/agoda/hotels/{property_id}apiKey3 credits/requestReturns full hotel detail from Agoda: identity (name, any former name), an accommodation type code, address (street address, postal code, city, country), guest rating, a main photo, room count, hotel chain id, a long and short description, and short-form policy statements (minimum age, adult/child definitions, extra-bed and additional-room booking policy).
Required: property_id.
Sampled 14 Oct 2026: 17 fields returned with a value. In the sample: accommodation_type: 34; description_short: “Experience Luxury and Convenience at Baiyoke Sky Hotel. Wel…”; main_image_url: pix8.agoda.net; description_long: 24,189 characters; policy.adult: 1 entry; rating: 4; number_of_rooms: 659; policy.extra_bed: 1 entry.
/agoda/hotels/searchapiKey3 credits/requestReturns hotel search results for an Agoda city: the matching property ids for that city plus a direct link to each property's listing page. Callers may supply a known Agoda city id or a free-text city name; when both are supplied city_id takes precedence.
Optional: city_id, city, page, limit.
Sampled 14 Oct 2026: 10 items. Filled in every item: property_id, source_url. In the sample: source_url: agoda.com.
Results from the 7 days to 14 Oct 2026. Current status
| Endpoint | Request | Checks passed | Median response |
|---|---|---|---|
| Get Agoda activity detail | GET /agoda/activities/1633875 | 100% | 1.32 s |
| Search Agoda activities | GET /agoda/activities/search?city_id=9395&keyword=chim+chum | 100% | 0.36 s |
| Get Agoda flight segment amenities | POST /agoda/flights/itinerary-amenities | 100% | 1.31 s |
| Search Agoda flight destinations/airports | GET /agoda/flights/search-locations?keyword=Bangkok | 100% | 1.21 s |
| Search Agoda one-way flights | GET /agoda/flights/search?departure_date=2026-09-15&destination=SGN&origin=SYD | 100% | 4.49 s |
| Search Agoda Homes & Apartments by city | GET /agoda/homes/search?city_id=9395&limit=30 | 100% | 3.43 s |
| Get Agoda hotel detail | GET /agoda/hotels/10637 | 100% | 1.36 s |
| Search Agoda hotels by city | GET /agoda/hotels/search?city_id=9395 | 100% | 1.50 s |