Hotel and vacation-rental price monitoring
Agodaエンドポイントを使えば、「Hotel and vacation-rental price monitoring」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Turn Agoda's Hotels, Homes & Apartments, Things To Do, and Flights results into structured JSON — city search, hotel and home listings with pricing, activity search and detail, and one-way flight search with segment amenities, sourced from Agoda's own internal APIs. Credential-free.
Search Agoda hotels, homes, activities, and flights and get detail and amenity data as structured JSON.
エンドポイントファミリー
4
ドキュメント化されたパラメータ
31
サンプル数
8
ライブカタログスナップショット
稼働エンドポイント
8
メソッド
GET, POST
必須パラメータ
15
スキーマ参照
8
{
"platform": "Agoda",
"endpoint": "agoda-hotels-search",
"method": "GET",
"path": "/agoda/hotels/search",
"auth": "apiKey"
}ユースケース
Search Agoda hotels, homes, activities, and flights and get detail and amenity data as structured JSON.
Agodaエンドポイントを使えば、「Hotel and vacation-rental price monitoring」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Agodaエンドポイントを使えば、「Travel activity discovery」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Agodaエンドポイントを使えば、「Flight fare research」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
マネージド実行
以下の数値はすべて、稼働中のAgodaエンドポイントカタログから取得しています（エンドポイント8件、ドキュメント化されたリクエストパラメータ31個、公開レスポンススキーマ8件）。DocsとPlaygroundが参照しているカタログと同じものです。
Agodaのエンドポイントは8件、4つのリクエストファミリーに分類されています（Flights、Activities、Hotelsほか1件）。
これらのAgodaエンドポイントには31個のリクエストパラメータがドキュメント化されており、うち15個が必須です。統合コードを書く前に入力仕様をすべて確認できます。
8件のAgodaエンドポイントのうち8件が実際のサンプルレスポンスを、8件がドキュメント化されたレスポンススキーマを備えています。最初のリクエストの前に実データの形に合わせて実装できます。
Agodaのエンドポイントは成功時のスキーマに加えてエラーレスポンス（400、404、500、503）もドキュメント化しています。ブロック、レート制限、レコード欠損は空データではなく型付きのエラーとして返ります。
Agodaのエンドポイントは8個のホスト型MCPツールとして提供されており、エージェントは同じパラメータと同じJSON契約のまま、追加の実装なしに同じルートを呼び出せます。
カバレッジマップ
/agoda/flights/search-locations
/agoda/activities/search
/agoda/hotels/search
/agoda/homes/search
エンドポイントカタログ
/agoda/hotels/searchReturns 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.
レスポンスに関する注記
- One of `city_id` or `city` is required; supplying neither returns `400` before any upstream request is made. An explicit non-positive `city_id` also returns `400`. An unknown/unresolvable city returns `404`. - Each result only carries `property_id` and a direct `source_url`. Call the hotel-detail endpoint with each `property_id` for full hotel content.
MCPツール agoda_hotels_search
/agoda/hotels/{property_id}Returns 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).
レスポンスに関する注記
- `property_id` must be numeric; a non-numeric or non-positive value returns `400` before any upstream request is made. - An unknown/nonexistent property id returns `404`. - `min_age` is an empty list on properties with no minimum-age policy on file; the other policy fields (`adult`, `extra_bed`, `additional`) are Agoda's own short display strings, not a structured rule schema. - `accommodation_type` is Agoda's own numeric property-type code. Known values: `34` (Hotel), `33` (Hostel), `37` (Resort), `120` (Apartment). - `main_image_url` is omitted when Agoda has no main photo on file for the property. Guest-review scores are not yet included in this response — see the endpoint's ongoing coverage notes for what is planned.
MCPツール agoda_hotel_detail
/agoda/homes/searchReturns 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.
レスポンスに関する注記
- One of `city_id` or `city` is required; supplying neither returns `400` before any upstream request is made. An unknown/unresolvable city returns `404`. - `homes` entries carry the same shape as the hotel detail endpoint's response, plus `accommodation_type`. Known `accommodation_type` values observed on Agoda: `34` (Hotel), `33` (Hostel), `37` (Resort), `120` (Apartment). This endpoint currently returns only `120` (Apartment) entries; broader vacation-home/villa coverage is a planned follow-up. - Because results are filtered down from a page of hotel-search candidates, `count` can be smaller than `limit` even when more matching homes exist on later pages — page forward with `page` to see more.
MCPツール agoda_homes_search
/agoda/activities/searchReturns 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.
レスポンスに関する注記
- At least one of `keyword`, `city_id`, or `city` is required; supplying none returns `400` before any upstream request is made. - `keyword` in the response echoes the actual search text used: the caller's own `keyword` when supplied, otherwise the resolved city name. - `city_id` filtering is best-effort: when a city filter is active, only activity results whose own city matches are kept. - A search with no matching activities returns `200` with an empty `activities` list, not an error.
MCPツール agoda_activities_search
/agoda/activities/{activity_id}Returns full activity detail from Agoda: title, description, stated duration, categories, and content images.
レスポンスに関する注記
- `activity_id` must be numeric; a non-numeric or non-positive value returns `400` before any upstream request is made. - An unknown/nonexistent activity id returns `404`. - `duration` and `categories` are exactly as Agoda's own content API returns them (a display-oriented duration pair, not a structured min/max range; categories are Agoda's own category codes, e.g. `FoodAndDrinks`). - `images` is a best-effort list of content images (up to 10); an activity with no supplier-provided images returns an empty list.
MCPツール agoda_activity_detail
/agoda/flights/search-locationsResolves a free-text city or airport name into IATA airport codes for flight search, with each city's direct and nearby airports.
レスポンスに関する注記
- An empty or missing `keyword` returns `400` before any upstream request is made. - A query with no matches returns `200` with an empty `suggestions` list, not an error. - `city_code` is only present when the location has its own distinct city-wide booking code (e.g. Bangkok's is `BKK`, matching its single main airport). Locations with no distinct city-wide code (e.g. a city served by one airport with a different code from the city name) have an empty `city_code` — use one of `airports[].code` instead. - `airports` lists airports directly serving the location; `nearby_airports` lists nearby alternates (each with a `distance_km`), only populated for some entries.
MCPツール agoda_flights_search_locations
/agoda/flights/searchReturns 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.
レスポンスに関する注記
- Missing `origin`/`destination`/`departure_date`, a malformed `departure_date`, or an unrecognized `cabin_class` return `400` before any upstream request is made. - Only one-way search is supported. Round-trip search is not available on this endpoint. - Agoda's own flight search is asynchronous — this endpoint transparently polls upstream until results are complete or a bounded attempt budget is exhausted, so callers always get one settled result in a single call. A route/date/passenger combination with no available inventory returns `200` with an empty `itineraries` list, not an error. - `stops_count` and `duration` on each itinerary reflect the whole journey; each entry in `segments` is one flown leg, with a `layover` object on any segment followed by a connection. - `source_url` on each itinerary is Agoda's own real booking deep link for that exact itinerary.
MCPツール agoda_flights_search
/agoda/flights/itinerary-amenitiesReturns 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.
レスポンスに関する注記
- An empty `segments` array, or a segment missing a required field, returns `400` before any upstream request is made. - `segments` in the response are returned in the same order as requested. - An entry with no amenity content on file returns an empty `amenities` list, not an error.
MCPツール agoda_flights_itinerary_amenities
関連API
Travel & Hospitality
Build travel and lodging research workflows from structured Airbnb stay, room, availability, and review data.
Travel & Hospitality
Research hotels, restaurants, attractions, and destination pages from TripAdvisor with normalized listing and review endpoints.
Travel & Hospitality
Turn Expedia's Stays, Flights, and Things To Do results into structured JSON — destination search, hotel listings with pricing and reviews, flight offers, and activity search, sourced from the same API the official mobile app uses. Credential-free.
対象企業
Booking Holdings Inc. · BKNG
Agodaを運営するのはBooking Holdings Inc.（BKNG）です。CrawloraのSECエンドポイントは同じ企業のCIKを受け取るため、提出書類・財務・インサイダー取引・13F保有を上記のAgodaエンドポイントと同じAPIキーで取得できます。
カタログ内の他のBooking Holdings Inc.プラットフォーム
Agodaのスクレイピング方法
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.
エージェントスキル
Crawlora のエージェントスキルをインストールすると、スクレイパーを書かずに、ドキュメント化された API 経由で Agoda のデータを JSON として取得できます。Agoda に対応するスキル:
Compare public Agoda and Expedia flight offers through Crawlora with matched airports, dates, passengers, cabin, price basis, segment timing, and…
npx skills add github.com/Crawlora-org/crawlora-skills --skill flight-itinerary-comparisonCompares public accommodation, short-term rental, hotel, flight, and activity listings across Airbnb, Agoda, Hotels.com, and Trip.com using the…
npx skills add github.com/Crawlora-org/crawlora-skills --skill travel-accommodation-researchResearches hotels, flights, attractions, short-term rentals, and live events via the Crawlora API — Booking.com, Expedia, Agoda, TripAdvisor…
npx skills add github.com/Crawlora-org/crawlora-skills --skill travel-hotel-researchFAQ
Send a city name to Crawlora's /agoda/hotels/search endpoint and get normalized hotel listings with current pricing as structured JSON — no account required.
Yes — /agoda/homes/search returns Agoda Homes & Apartments listings for a city, in the same normalized shape as hotel search.
Collecting publicly accessible hotel, activity, and flight data is generally permissible if you respect Agoda's terms of use, robots directives, rate limits, and applicable law. This is for public data you are authorized to collect.
On 2026-10-27 each of the 10 rows had a property_id and source URL only. Call the hotel detail route for the name, price and facilities.