HomeGuides
Guides

Content API

Suggest Edits

Introduction

Welcome to Agoda! We offer hotel content in two different formats to suit your needs. Your account manager will provide the URL to download either the Data File or Data Feed.

Data File

Format: CSV
Customization: Available in your preferred currency and language
Scope: Includes only hotel-level information
Usage: Ideal for collecting and storing hotel data or initializing a database
Recommendation: Refresh the data file at least once a week

Data Feed

Format: JSON (add Header Content-Type: application/json to receive the JSON format)

Scope: Includes comprehensive hotel and room-level information

Feed_id 1: Continents

Example request (http GET)


   https://[baseURL]/datafeeds/feed/getfeed?feed_id=1&token={{token}}&site_id={{siteid}}

Parameters:

Name Type Is Mandatory
token UniqueIdentifier True
site_id Integer True
olanguage_id Integer False

Response Example:


  {
      "continentFeed": {
          "continents": {
              "continent": [
                  {
                      "continentId": 1,
                      "continentName": "Africa",
                      "continentTranslated": "Africa",
                      "activeHotels": 1
                  },
                  {
                      "continentId": 2,
                      "continentName": "Asia",
                      "continentTranslated": "Asia",
                      "activeHotels": 2
                  },
                  {
                      "continentId": 3,
                      "continentName": "Central America and Caribbean",
                      "continentTranslated": "Central America and Caribbean",
                      "activeHotels": 3
                  },
                  {
                      "continentId": 4,
                      "continentName": "Europe",
                      "continentTranslated": "Europe",
                      "activeHotels": 4
                  },
                  {
                      "continentId": 5,
                      "continentName": "Middle East",
                      "continentTranslated": "Middle East",
                      "activeHotels": 5
                  }
              ]
          }
      }
  }
Feed_id 2: Countries

Example request (http GET)


 https://[baseURL]/datafeeds/feed/getfeed?feed_id=2&token={{token}}&site_id={{siteid}}

Parameters:

Name Type Is Mandatory
token UniqueIdentifier True
site_id Integer True
olanguage_id Integer False
oregion_id Integer False

Response Example:


  {
      "countryFeed" : {
          "countries" : {
              "country" : [
                  {
                      "countryId": 294,
                      "continentId": 1,
                      "countryName": "Comoros",
                      "countryTranslated": "Comoros",
                      "activeHotels": 611,
                      "countryIso": "COM",
                      "countryIso2": "KM",
                      "longitude": 43.33145,
                      "latitude": -11.6213
                  }
              ]
          }
      }
  }
Feed_id 3: Cities

Example request (http GET)


   https://[baseURL]/datafeeds/feed/getfeed?feed_id=3&token={{token}}&site_id={{siteid}}

Parameters:

Name Type Is Mandatory
token UniqueIdentifier True
site_id Integer True
ocountry_id Integer False
olanguage_id Integer False

Response Example:


  {
      "cityFeed" : {
          "cities" : {
              "city" : [
                  {
                      "cityId": 688637,
                      "countryId": 294,
                      "cityName": "Test City",
                      "cityTranslated": "Test City",
                      "activeHotels": 595,
                      "longitude": 43.40929,
                      "latitude": -11.615324,
                      "noArea": 0
                  }
              ]
          }
      }
  }
Feed_id 4: Area within Cities

Example request (http GET)


   https://[baseURL]/datafeeds/feed/getfeed?feed_id=4&token={{token}}&site_id={{siteid}}&ocity_id={{cityid}}

Parameters:

Name Type Is Mandatory
token UniqueIdentifier True
site_id Integer True
ocity_id Integer True
olanguage_id Integer False

Response Example:


  {
      "areaFeed": {
          "areas": {
              "area": [
                  {
                      "areaId": 499670,
                      "cityId": 688637,
                      "areaName": "Test Area",
                      "areaTranslated": "Test Area",
                      "activeHotels": 554,
                      "longitude": 43.331237,
                      "latitude": -11.636096,
                      "polygon": ""
                  }
              ]
          }
      }
  }
Feed_id 5: Hotel

Example request (http GET)


   https://[baseURL]/datafeeds/feed/getfeed?feed_id=5&token={{token}}&site_id={{siteid}}&mcity_id={{cityid}}

Parameters:

Name Type Is Mandatory
token UniqueIdentifier True
site_id Integer True
mcity_id Integer True
oarea_id Integer False
ohotel_id Integer False
olanguage_id Integer False
ocurrency String False

Response Example:


  {
      "hotelInformationFeed": {
          "hotelInformations": {
              "hotelInformation": [
                  {
                      "hotelId": 58940827,
                      "hotelName": "DO NOT BOOK TEST HOTEL!",
                      "hotelFormerlyName": "",
                      "translatedName": "DO NOT BOOK TEST HOTEL!",
                      "starRating": 4.0,
                      "continentId": 1,
                      "countryId": 294,
                      "cityId": 688637,
                      "areaId": 573809,
                      "longitude": 43.40929,
                      "latitude": -11.615324,
                      "hotelUrl": "https://www.agoda.com/partners/partnersearch.aspx?hid=58940827",
                      "popularityScore": 0,
                      "phoneNo": "",
                      "remark": "",
                      "numberOfReviews": 0,
                      "ratingAverage": 0,
                      "childAndExtrabedPolicy": {
                          "infantAge": "0",
                          "childrenAgeFrom": "0",
                          "childrenAgeTo": "0",
                          "childrenStayFree": "false",
                          "minGuestAge": "0"
                      },
                      "accommodationType": "Serviced apartment",
                      "nationalityRestrictions": "",
                      "singleRoomProperty": false
                  },
                  {
                      "hotelId": 59025570,
                      "hotelName": "Test Hotel By PIKA",
                      "hotelFormerlyName": "",
                      "translatedName": "Test Hotel By PIKA",
                      "starRating": 4.0,
                      "continentId": 1,
                      "countryId": 294,
                      "cityId": 688637,
                      "areaId": 573809,
                      "longitude": 43.40929,
                      "latitude": -11.615324,
                      "hotelUrl": "https://www.agoda.com/partners/partnersearch.aspx?hid=59025570",
                      "popularityScore": 0,
                      "phoneNo": "",
                      "remark": "",
                      "numberOfReviews": 0,
                      "ratingAverage": 0,
                      "childAndExtrabedPolicy": {
                          "infantAge": "0",
                          "childrenAgeFrom": "0",
                          "childrenAgeTo": "0",
                          "childrenStayFree": "false",
                          "minGuestAge": "0"
                      },
                      "accommodationType": "Hotel",
                      "nationalityRestrictions": "",
                      "singleRoomProperty": false
                  },
                  {
                      "hotelId": 58936620,
                      "hotelName": "DO NOT BOOK - TEST HOTEL 3",
                      "hotelFormerlyName": "",
                      "translatedName": "DO NOT BOOK - TEST HOTEL 3",
                      "starRating": 4.0,
                      "continentId": 1,
                      "countryId": 294,
                      "cityId": 688637,
                      "areaId": 573809,
                      "longitude": 43.40929,
                      "latitude": -11.615324,
                      "hotelUrl": "https://www.agoda.com/partners/partnersearch.aspx?hid=58936620",
                      "popularityScore": 0,
                      "phoneNo": "",
                      "remark": "",
                      "numberOfReviews": 0,
                      "ratingAverage": 0,
                      "childAndExtrabedPolicy": {
                          "infantAge": "0",
                          "childrenAgeFrom": "0",
                          "childrenAgeTo": "0",
                          "childrenStayFree": "false",
                          "minGuestAge": "0"
                      },
                      "accommodationType": "Hotel",
                      "nationalityRestrictions": "",
                      "singleRoomProperty": false
                  }
              ]
          }
      }
  }
Feed_id 6: Roomtypes per Hotel

Example request (http GET)


 https://[baseURL]/datafeeds/feed/getfeed?feed_id=6&token={{token}}&site_id={{siteid}}&mhotel_id={{hotelid}}

Parameters:

Name Type Is Mandatory
token UniqueIdentifier True
site_id Integer True
mhotel_id Integer True
olanguage_id Integer False

Response Example:


  {
      "roomtypeFeed": {
          "roomtypes": {
              "roomtypes": [
                  {
                      "hotelId": 58940827,
                      "hotelRoomtypeId": 884525199,
                      "standardCaption": "Double Room",
                      "standardCaptionTranslated": "Double Room",
                      "maxOccupancyPerRoom": 1,
                      "noOfRoom": 1,
                      "sizeOfRoom": 213,
                      "roomSizeInclTerrace": false,
                      "views": "",
                      "maxExtrabeds": 0,
                      "maxInfantInRoom": 0,
                      "hotelRoomtypePicture": "https://pix8.agoda.net/hotelImages/58940827/0/ea0016aa2d300846b743bf1687f326c8.jpg?ce=0&s=312x",
                      "bedType": "",
                      "hotelMasterRoomtypeId": 0,
                      "hotelRoomtypeAlternateName": "",
                      "sharedBathroom": false,
                      "gender": ""
                  }
              ]
          }
      }
  }
Feed_id 7: Picture per Hotel

Example request (http GET)


https://[baseURL]/datafeeds/feed/getfeed?feed_id=7&token={{token}}&site_id={{siteid}}&mhotel_id={{hotelid}}

Parameters:

Name Type Is Mandatory
token UniqueIdentifier True
site_id Integer True
mhotel_id Integer True
olanguage_id Integer False

Response Example:


  {
      "pictureFeed": {
          "pictures": {
              "picture": [
                  {
                      "hotelId": 58940827,
                      "pictureId": 145566058,
                      "caption": "",
                      "captionTranslated": "",
                      "URL": "https://pix8.agoda.net/hotelImages/58940827/0/d1933b7b567fce679b70120bba7bdb1d.jpg?ce=0&s=312x",
                      "pictureGroup": "other"
                  },
                  {
                      "hotelId": 58940827,
                      "pictureId": 145566059,
                      "caption": "",
                      "captionTranslated": "",
                      "URL": "https://pix8.agoda.net/hotelImages/58940827/0/1c82fbf4f24a7c7fbd2353bfa3daab89.jpeg?s=312x",
                      "pictureGroup": "other"
                  },
                  {
                      "hotelId": 58940827,
                      "pictureId": 145566060,
                      "caption": "",
                      "captionTranslated": "",
                      "URL": "https://pix8.agoda.net/hotelImages/58940827/0/7453a9c32c11408e6ec5309a85522577.jpeg?s=312x",
                      "pictureGroup": "other"
                  }
              ]
          }
      }
  }
Feed_id 9: Facilities per Hotel

Example request (http GET)


https://[baseURL]/datafeeds/feed/getfeed?feed_id=9&token={{token}}&site_id={{siteid}}&mhotel_id={{hotelid}}

Parameters:

Name Type Is Mandatory
token UniqueIdentifier True
site_id Integer True
mhotel_id Integer True
olanguage_id Integer False

Response Example:


  {
      "facilityFeed": {
          "facilities": {
              "facility": [
                  {
                      "hotelId": 58940827,
                      "propertyGroupDescription": "Services and conveniences",
                      "propertyId": 8,
                      "propertyName": "Laundry service",
                      "propertyTranslatedName": "Laundry service"
                  }
              ]
          }
      }
  }
Feed_id 10: Other info per hotel

Example request (http GET)


https://[baseURL]/datafeeds/feed/getfeed?feed_id=10&token={{token}}&site_id={{siteid}}&mhotel_id={{hotelid}}

Parameters:

Name Type Is Mandatory
token UniqueIdentifier True
site_id Integer True
mhotel_id Integer True
olanguage_id Integer False

Response Example:


{
    "hotelInfoFeed": {
        "hotelInfos": {
            "hotelInfo": [
                {
                    "hotelId": 58940827,
                    "propertyId": 8,
                    "propertyName": "Check-in from",
                    "propertyTranslatedName": "Check-in from",
                    "propertyDetails": "15:00"
                },
                {
                    "hotelId": 58940827,
                    "propertyId": 45,
                    "propertyName": "Check-in until",
                    "propertyTranslatedName": "Check-in until",
                    "propertyDetails": "18:00"
                },
                {
                    "hotelId": 58940827,
                    "propertyId": 9,
                    "propertyName": "Check-out until",
                    "propertyTranslatedName": "Check-out until",
                    "propertyDetails": "11:00"
                },
                {
                    "hotelId": 58940827,
                    "propertyId": 28,
                    "propertyName": "Number of rooms ",
                    "propertyTranslatedName": "Number of rooms ",
                    "propertyDetails": "1"
                }
            ]
        }
    }
}
Feed_id 13: Languages and Codes

Example request (http GET)


https://[baseURL]/datafeeds/feed/getfeed?feed_id=13&token={{token}}&site_id={{siteid}}

Parameters:

Name Type Is Mandatory
token UniqueIdentifier True
site_id Integer True

Response Example:


  {
      "languageFeed" : {
          "languages" : {
              "language" : [
                  {
                      "languageId" : 1,
                      "languageName" : "English",
                      "translatedName" : "English"
                  },
                  {
                      "languageId" : 2,
                      "languageName" : "French",
                      "translatedName" : "Français"
                  },
                  {
                      "languageId" : 3,
                      "languageName" : "German",
                      "translatedName" : "Deutsch"
                  },
                  {
                      "languageId" : 4,
                      "languageName" : "Italian",
                      "translatedName" : "Italiano"
                  },
                  {
                      "languageId" : 5,
                      "languageName" : "Spanish",
                      "translatedName" : "Español"
                  }
              ]
          }
      }
  }
Feed_id 14: Facilities per Roomtype

Example request (http GET)


https://[baseURL]/datafeeds/feed/getfeed?feed_id=14&token={{token}}&site_id={{siteid}}&mhotel_id={{hotelid}}

Parameters:

Name Type Is Mandatory
token UniqueIdentifier True
site_id Integer True
mhotel_id Integer True
olanguage_id Integer False

Response Example:


  {
      "roomTypeFacilityFeed": {
          "roomTypeFacilities": {
              "roomTypeFacility": [
                  {
                      "hotelId": 58936620,
                      "hotelRoomTypeId": 884397795,
                      "propertyId": 25,
                      "propertyName": "Air conditioning",
                      "translatedName": "Air conditioning"
                  }
              ]
          }
      }
  }
Feed_id 15: Hotel Chains

Example request (http GET)


https://[baseURL]/datafeeds/feed/getfeed?feed_id=15&token={{token}}&site_id={{siteid}}

Parameters:

Name Type Is Mandatory
token UniqueIdentifier True
site_id Integer True

Response Example:


  {
      "hotelChainFeed" : {
          "hotelChains" : {
              "hotelChain" : [
                  {
                      "chainId" : 0,
                      "chainName" : "No chain"
                  },
                  {
                      "chainId" : 3,
                      "chainName" : "Accor Hotels"
                  },
                  {
                      "chainId" : 4,
                      "chainName" : "Ascott International"
                  },
                  {
                      "chainId" : 5,
                      "chainName" : "Banyan Tree Hotels & Resorts"
                  },
                  {
                      "chainId" : 6,
                      "chainName" : "Best Western International"
                  }
              ]
          }
      }
  }
Feed_id 16: Hotel per Hotels Brand

Example request (http GET)


https://[baseURL]/datafeeds/feed/getfeed?feed_id=16&token={{token}}&site_id={{siteid}}&mbrand_id={{brandid}}

Parameters:

Name Type Is Mandatory
token UniqueIdentifier True
site_id Integer True
mbrand_id Integer True
olanguage_id Integer False

Response Example:


{
    "brandHotelFeed": {
        "brandHotels": {
            "brandHotel": [
                {
                    "brandId": 12345,
                    "hotelId": 123456
                }
            ]
        }
    }
}
Feed_id 17: Hotel Description

Example request (http GET)


https://[baseURL]/datafeeds/feed/getfeed?feed_id=17&token={{token}}&site_id={{siteid}}&mcity_id={{cityid}}

Parameters:

Name Type Is Mandatory
token UniqueIdentifier True
site_id Integer True
mcity_id Integer True
oarea_id Integer False
ohotel_id Integer False
olanguage_id Integer False

Response Example:


  {
      "hotelDescriptionFeed": {
          "hotelDescriptions": {
              "hotelDescription": [
                  {
                      "hotelId": 58936620,
                      "overview": "At DO NOT BOOK - TEST HOTEL 3, exceptional service and top-notch amenities create a memorable experience for guests. Complimentary internet access is available in the hotel to ensure you stay connected during your visit.For guests with their own vehicle, parking facilities are provided. At DO NOT BOOK - TEST HOTEL 3, each day commences with a scrumptious breakfast offered at no additional cost.At DO NOT BOOK - TEST HOTEL 3, guests can take pleasure in the delightful recreational amenities provided for their entertainment. At the hotel, a wide range of enjoyable activities ensures that there's never a dull moment during your visit. Don't miss out on the easily reachable beach in the vicinity.",
                      "snippet": "At DO NOT BOOK - TEST HOTEL 3, exceptional service and top-notch amenities create a memorable experience"
                  }
              ]
          }
      }
  }
Feed_id 18: Hotel Address

Example request (http GET)


https://[baseURL]/datafeeds/feed/getfeed?feed_id=18&token={{token}}&site_id={{siteid}}&mcity_id={{cityid}}

Parameters:

Name Type Is Mandatory
token UniqueIdentifier True
site_id Integer True
mcity_id Integer True
oarea_id Integer False
ohotel_id Integer False

Response Example:


  {
      "hotelAddressFeed": {
          "hotelAddresses": {
              "hotelAddress": [
                  {
                      "hotelId": 58936620,
                      "addressType": "English address",
                      "addressLine1": "test street, comoros",
                      "addressLine2": "",
                      "postalCode": "00000",
                      "state": "Comoros",
                      "city": "Test City",
                      "country": "Comoros"
                  },
                  {
                      "hotelId": 58936620,
                      "addressType": "Local language",
                      "addressLine1": "test street, comoros",
                      "addressLine2": "",
                      "postalCode": "00000",
                      "state": "Comoros",
                      "city": "Test City",
                      "country": "Comoros"
                  }
              ]
          }
      }
  }
Feed_id 19: Full Hotel Information

Example request (http GET)


https://[baseURL]/datafeeds/feed/getfeed?feed_id=19&token={{token}}&site_id={{siteid}}&mhotel_id={{hotelid}}

Parameters:

Name Type Is Mandatory
token UniqueIdentifier True
site_id Integer True
mhotel_id Integer True
olanguage_id Integer False
ocurrency String False

Response Example:


  {
      "hotelFullFeed": {
          "hotels": {
              "hotel": [
                  {
                      "hotelId": 58940827,
                      "hotelName": "DO NOT BOOK TEST HOTEL!",
                      "hotelFormerlyName": "",
                      "translatedName": "DO NOT BOOK TEST HOTEL!",
                      "starRating": 4.0,
                      "continentId": 1,
                      "countryId": 294,
                      "cityId": 688637,
                      "areaId": 573809,
                      "longitude": 43.40929,
                      "latitude": -11.615324,
                      "hotelUrl": "https://www.agoda.com/partners/partnersearch.aspx?hid=58940827",
                      "popularityScore": 0,
                      "remark": "",
                      "numberOfReviews": 0,
                      "ratingAverage": 0,
                      "childAndExtrabedPolicy": {
                          "infantAge": "0",
                          "childrenAgeFrom": "0",
                          "childrenAgeTo": "0",
                          "childrenStayFree": "false",
                          "minGuestAge": "0"
                      },
                      "accommodationType": "Serviced apartment",
                      "nationalityRestrictions": "",
                      "singleRoomProperty": false,
                      "ownerId": 0,
                      "ownerName": ""
                  }
              ]
          },
          "addresses": {
              "address": [
                  {
                      "hotelId": 58940827,
                      "addressType": "English address",
                      "addressLine1": "test",
                      "addressLine2": "",
                      "postalCode": "",
                      "state": "Comoros",
                      "city": "Test City",
                      "country": "Comoros"
                  },
                  {
                      "hotelId": 58940827,
                      "addressType": "Local language",
                      "addressLine1": "test",
                      "addressLine2": "",
                      "postalCode": "",
                      "state": "Comoros",
                      "city": "Test City",
                      "country": "Comoros"
                  }
              ]
          },
          "descriptions": {
              "description": [
                  {
                      "hotelId": 58940827,
                      "overview": "",
                      "snippet": ""
                  }
              ]
          },
          "facilities": {
              "facility": [
                  {
                      "hotelId": 58940827,
                      "propertyGroupDescription": "Services and conveniences",
                      "propertyId": 8,
                      "propertyName": "Laundry service",
                      "propertyTranslatedName": "Laundry service"
                  }
              ]
          },
          "pictures": {
              "picture": [
                  {
                      "hotelId": 58940827,
                      "pictureId": 145566058,
                      "caption": "",
                      "captionTranslated": "",
                      "URL": "https://pix8.agoda.net/hotelImages/58940827/0/d1933b7b567fce679b70120bba7bdb1d.jpg?ce=0&s=312x"
                  },
                  {
                      "hotelId": 58940827,
                      "pictureId": 145566059,
                      "caption": "",
                      "captionTranslated": "",
                      "URL": "https://pix8.agoda.net/hotelImages/58940827/0/1c82fbf4f24a7c7fbd2353bfa3daab89.jpeg?s=312x"
                  },
                  {
                      "hotelId": 58940827,
                      "pictureId": 145566060,
                      "caption": "",
                      "captionTranslated": "",
                      "URL": "https://pix8.agoda.net/hotelImages/58940827/0/7453a9c32c11408e6ec5309a85522577.jpeg?s=312x"
                  }
              ]
          },
          "roomtypes": {
              "roomtype": [
                  {
                      "hotelId": 58940827,
                      "hotelRoomtypeId": 884525199,
                      "standardCaption": "Double Room",
                      "standardCaptionTranslated": "Double Room",
                      "maxOccupancyPerRoom": 1,
                      "noOfRoom": 1,
                      "sizeOfRoom": 213,
                      "roomSizeInclTerrace": false,
                      "views": "",
                      "maxExtrabeds": 0,
                      "maxInfantInRoom": 0,
                      "hotelRoomtypePicture": "https://pix8.agoda.net/hotelImages/58940827/0/ea0016aa2d300846b743bf1687f326c8.jpg?ce=0&s=312x",
                      "bedType": "",
                      "hotelMasterRoomtypeId": 0,
                      "hotelRoomtypeAlternateName": "",
                      "sharedBathroom": false,
                      "gender": ""
                  }
              ]
          }
      }
  }
Feed_id 20: Hotel Brands

Example request (http GET)


https://[baseURL]/datafeeds/feed/getfeed?feed_id=20&token={{token}}&site_id={{siteid}}

Parameters:

Name Type Is Mandatory
token UniqueIdentifier True
site_id Integer True

Response Example:


  {
      "hotelBrandFeed" : {
          "hotelBrands" : {
              "hotelBrand" : [
                  {
                      "brandId" : 2186,
                      "brandName" : "JP_Sai Industries (Ideal Resort)",
                      "chainId" : 1009
                  },
                  {
                      "brandId" : 2187,
                      "brandName" : "Bestbnb (Sogi)",
                      "chainId" : 1010
                  },
                  {
                      "brandId" : 2188,
                      "brandName" : "Handgrowing",
                      "chainId" : 1011
                  },
                  {
                      "brandId" : 2189,
                      "brandName" : "Twist",
                      "chainId" : 1012
                  },
                  {
                      "brandId" : 2190,
                      "brandName" : "Genesis",
                      "chainId" : 1013
                  }
              ]
          }
      }
  }
Feed_id 21: States/Provinces

Example request (http GET)


https://[baseURL]/datafeeds/feed/getfeed?feed_id=21&token={{token}}&site_id={{siteid}}

Parameters:

Name Type Is Mandatory
token UniqueIdentifier True
site_id Integer True
ocountry_id Integer False
olanguage_id Integer False

Response Example:


  {
      "stateFeed": {
          "states": {
              "state": [
                  {
                      "stateId": 4050,
                      "stateName": "Comoros",
                      "stateTranslated": "Comoros"
                  }
              ]
          }
      }
  }
Feed_id 22: Benefits

Example request (http GET)


https://[baseURL]/datafeeds/feed/getfeed?feed_id=22&token={{token}}&site_id={{siteid}}

Parameters:

Name Type Is Mandatory
token UniqueIdentifier True
site_id Integer True
olanguage_id Integer False

Response Example:


  {
      "benefitFeed" : {
          "benefits" : {
              "benefit" : [
                  {
                      "benefitId" : 1,
                      "benefitName" : "Breakfast",
                      "benefitTranslated" : "Breakfast",
                      "benefitTemplate" : "",
                      "benefitTemplateTranslated" : "",
                      "benefitWithVariables" : false
                  },
                  {
                      "benefitId" : 2,
                      "benefitName" : "Lunch included",
                      "benefitTranslated" : "Lunch included",
                      "benefitTemplate" : "",
                      "benefitTemplateTranslated" : "",
                      "benefitWithVariables" : false
                  },
                  {
                      "benefitId" : 3,
                      "benefitName" : "Dinner included",
                      "benefitTranslated" : "Dinner included",
                      "benefitTemplate" : "",
                      "benefitTemplateTranslated" : "",
                      "benefitWithVariables" : false
                  },
                  {
                      "benefitId" : 4,
                      "benefitName" : "Beverages",
                      "benefitTranslated" : "Beverages",
                      "benefitTemplate" : "",
                      "benefitTemplateTranslated" : "",
                      "benefitWithVariables" : false
                  },
                  {
                      "benefitId" : 6,
                      "benefitName" : "Parking",
                      "benefitTranslated" : "Parking",
                      "benefitTemplate" : "",
                      "benefitTemplateTranslated" : "",
                      "benefitWithVariables" : false
                  }
              ]
          }
      }
  }
Feed_id 30: Agoda Preferred Hotel

Example request (http GET)


https://[baseURL]/datafeeds/feed/getfeed?feed_id=30&token={{token}}&site_id={{siteid}}

Parameters:

Name Type Is Mandatory
token UniqueIdentifier True
site_id Integer True
ocountry_id Integer False
ocity_id Integer False

Response Example:


  {
      "agodaPreferredFeed" : {
          "agodaPreferredHotels" : {
              "hotels" : [
                  {
                      "hotelId" : 12345,
                      "countryId" : 123,
                      "cityId" : 123
                  }
              ]
          }
      }
  }
Feed_id 31: Local Information

Example request (http GET)


https://[baseURL]/datafeeds/feed/getfeed?feed_id=31&token={{token}}&site_id={{siteid}}&mhotel_id={{hotelid}}

Parameters:

Name Type Is Mandatory
token UniqueIdentifier True
site_id Integer True
mhotel_id Integer True
olanguage_id Integer False

Response Example:


  {
      "localInformationFeed": {
          "nearbyPlaces": {
              "places": [
                  {
                      "name": "test landmark",
                      "distance": 8.81,
                      "distanceUnit": "kilometers"
                  },
                  {
                      "name": "Prince Said Ibrahim International Airport",
                      "distance": 17.1,
                      "distanceUnit": "kilometers"
                  },
                  {
                      "name": "Moh‚li Bandar Es Eslam Airport",
                      "distance": 84.79,
                      "distanceUnit": "kilometers"
                  }
              ]
          }
      }
  }
Feed_id 32: Hotel Change

Example request (http GET)


https://[baseURL]/datafeeds/feed/getfeed?feed_id=32&token={{token}}&site_id={{siteid}}&mdate={{YYYYMMDD}}&mtypeid={{mtypeid}}

Parameters:

Name Type Is Mandatory
token UniqueIdentifier True
site_id Integer True
mdate Date (YYYYMMDD) True
mtypeid Integer True
opageid Integer False

Additional Information:

  • mdate is the date in the format YYYYMMDD, within the range [today() - 7, today() - 1]. (the date is based on bangkok timezone (UTC+7))
  • The possible values for mtypeid are:
    • mtypeid=1: HotelID has content updates on mdate; update the content
    • mtypeid=2: HotelID is newly enabled for partners on mdate; map these new properties
    • mtypeid=3: HotelID is disabled/closed for partners on mdate; remove these properties from search

Response Example:


  {
      "changedHotelFeed": {
          "changed": {
              "hotels": {
                  "hotel_id": [
                      12345,
                      67891
                  ]
              },
              "page": {
                  "id": 1,
                  "total": 1
              }
          }
      }
  }

Steps to Access Important Hotel Information:

  1. Feed 3: Retrieve all available City_IDs in Agoda
  2. Feed 5: Use City_IDs to get all Hotel_IDs (with primary information) in each city
  3. Feed 13: Get all Agoda language codes
  4. Feed 19: Use Hotel_IDs to get full hotel information, including other languages by specifying olanguage_id as an optional parameter
  5. Feed 32: Get a list of hotels with updated information

Regularly refreshing content

To keep your hotel content fresh and up-to-date, we recommend the following schedule:

  • Weekly: Refresh all available hotel information using Feed 3, Feed 5, Feed 13, and Feed 19
  • Daily: Refresh updated hotel information using Feed 32, Feed 13, and Feed 19

By following these steps, you can ensure that your hotel data remains current and accurate.

Updated about 1 year ago