# Explanation of the New Version Content API

The old version of Dida's Content API returned many static information about hotels in CSV format, which was too large and inconvenient for customers to handle. To make it easier and faster for Dida API customers to obtain static data related to Dida hotels, changes were made to the previous version, resulting in this new version of the Content API. The static information of Dida hotels will now be returned in JSON format in the API, making it more convenient for customers to access.

The new version was released in January 2025. For new API customers, it is strongly recommended to use the new version.

# Domain

Please note that the Domain for the test account is the same as that for the formal account.

https://static-api.didatravel.com

# API List

Please note that there is a QPS (Query Per Second) limit when accessing static content through the interface. For example, if the QPS is set to 10, it means that a maximum of 10 requests are supported per second. If more than 10 requests are made, they may be blocked.

Url Description Default QPS
/api/v1/region/counties This API is used to retrieve a list of countries. 10
/api/v1/region/destinations This API is used to retrieve a list of destinations from a specific country. 1
/api/v1/hotel/list This API is used to retrieve a list of hotels from a specific country. 1
/api/v1/hotel/details This API is used to retrieve hotel details from a specific list of hotel IDs. 10

# Authorization

The current API uses Basic access authentication. Please use the ClientID as the username and the LicenseKey as the password.

# Authorization Example

Please be aware that the DidaApiTestID, a general test account, can only view 10 hotels per country. If you need to access more hotel information, please contact your dedicated API account manager.

Username: DidaApiTestID
Password: TestKey
Credentials = Base64(DidaApiTestID:TestKey) // RGlkYUFwaVRlc3RJRDpUZXN0S2V5

curl -X 'GET' \
  'https://static-api.didatravel.com/api/v1/region/countries?language=en-US' \
  -H 'accept: application/json' \
  -H 'Authorization: Basic RGlkYUFwaVRlc3RJRDpUZXN0S2V5'

# Multilingual

Dida currently supports languages including English, Chinese, Japanese, Korean, and Brazilian Portuguese. The majority of hotels have English static information, but coverage for other languages may not be as extensive, and Dida is working hard to improve this.

If you want to obtain static information in other languages, you can change the language code in "language=en-US" to the corresponding language code as follows:

Language Code
Chinese zh-CN
Japanese ja-JP
Korean ko-KR
Brazilian Portuguese pt-BR

Please note that non-default test accounts are defaulted to English only. If you need static information in other languages, please contact your dedicated API account manager.

# Gzip

To optimize data transfer, all requests should accept gzip encoding. Similarly, all response messages are returned in gzip encoding to ensure efficient and fast data delivery.