Skip to main content

Introduction

Royal API is the lightest and fastest Hotel distribution API. Royal API, the Etstur Group to develop your own business with instant access to 10000 hotels.

Royal API is designed to provide Etstur Group clients with a set of API calls designed to bring the accommodation distribution capability of our company to your travel projects:

The Etstur Royal API is comprised of six main services:

  • Authentication: Obtain detailed authentication information and token.
  • Content: Get detailed data on Currencies, Board Types, Hotel Facilities, Room Attributes and Room Facilities.
  • Hotel Management: Get detailed Hotel List, Hotel Detail (including images, descriptions etc.) and Revision Hotels.
  • Location: Get detailed Locations List and spesific Location Detail
  • Booking: The hotel booking process begins with the "search" phase, followed by "room search" and "reservation." The essential parameters for each step of this process should be carried over to the next.
  • Booking Management: After booking process Book Detail, Book List and Cancel services.

To use our services, please complete the following steps.

Authentication

Before you can start using Etscore's services, you need to authenticate your access. Authentication ensures that only authorized users can interact with the platform, allowing for secure data transactions.

The authentication process involves obtaining an access token, which will be used for all subsequent requests to the platform. This token is valid for a limited time (4 hours), after which you will need to request a new one. Once authenticated, you can proceed to access various services such as hotel management, bookings, and more.

  1. Submit a request to the Authentication service with your username/email and password to obtain an access (bearer) token.
    • Each token is valid for 5 hours. After expiration, you will need to repeat this step to receive a new token.

Content

Obtain detailed data on currencies, board types, hotel facilities, room attributes and room facilities.

Hotel management

Access a comprehensive list of hotels, detailed hotel information (including images, descriptions, etc.), and hotel revisions.

Location

Retrieve a detailed list of locations and specific location details.

Booking

The booking process begins with the "search" phase, followed by "room search" and "reservation." Ensure that the essential parameters from each stage are carried over to the next.

Booking Management

After completing a booking, manage the booking details, view the booking list, and perform cancellation services.

Royal API is delivered via HTTPS POST, GET, requests. Request and response data can be JSON allowing you to easily build requests and parse responses in a standard way by using the tools included with most of the modern languages.