Dida API # 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.