Biblio-Globus Tour Operator JSON price list API

1. API access

1.1. Getting login and password for authorisation

If you don't have your login and password to access our Biblio-Globus Tour Operator system, you should contact our Agency Relations Department:
+7 (495) 109-2500
Alexander Lyubimov - 1448 internal phone number

1.2. Authorization with services

Authorization process: if on each API request shows up 401 error, you should ask for fresh COOKIEs with names A1, Z1, L by sending POST request to with POST parameters login and pwd. Use COOKIE A1, Z1, L values in future service requests. COOKIE Z1 value changes/refreshes on each next service request - accept and indicate it into next request.

1.3. Data compression

Into each request provide Accept-Encoding header: gzip, otherwise 406 error will be shown on response.

2. Request and synchronization of references

To be able to do request to price list, other additional filters and parameters extensions, at first, you should request country lists, city and resort lists, hotel lists and accommodation types lists.

To request lists follow these URLs: Country list City and resort lists Hotel lists. When on request you provide id parameter, hotel information returns only referred to specified id Accommodation types lists

Example response to country lists, city and resort lists, hotel lists and accommodation types lists request:

100510397178#100568421754#100510397261#100510397299#100510397348", "alpha3":"THA", "tours":"Да" }, ... ]


id - object identifier in Biblio-Globus system

Get request attributes:

For countries title_ru – country name in Russian
title_en – country name in English
code – country code
town_from - id list of departure cities in selected country (divided by #)
alpha3 - three-letter country code
tours - is a attribute, which means that there are available tours to this country (in this case parameter’s value is “Да”)
site_cur - country currency in Biblio-Globus system
For cities and resorts title_ru – city name in Russian
title_en – city name in English
country – country id of this city
airports – this attribute sets when there is an airport in selected city
ap_name – airport name in English
code – iata airport code
For accommodation types name – accommodation type name
name_full – full accommodation type name
AD_number – amount of adults in room
CHD_number – amount of children in room
infnum – amount of infants in room

Example response of hotel lists:

    <hotel key="102631286815" name="HOLIDAY INN DUBAI AL BARSHA" stars="4" countryKey="100410510097" cityKey="100510535941" />
    <hotel key="102632934142" name="ORCHID." stars="5" countryKey="100410009918" cityKey="100531910942" />


hotel — hotel block
hotel / key — hotel object identifier
hotel / name — hotel name
hotel / stars — hotel star rating
hotel / countryKey — hotel country id
hotel / cityKey — hotel city id
hotel / inPr - attribute that shows available hotel prices (prices value 0 - no, 1 - yes). This attribute is specified only at GET parameter request by &id=< id of a hotel >. If there is no id specified, return only hotels, which have inPr value = 1.

2.1. Currency rates to rubles requests

To request rates follow the link below:

Example response:

    <rate code="EUR" value="46.81" />
    <rate code="USD" value="34.54" />
        <rate code="EUR" value="13958"/>
        <rate code="USD" value="10231"/>
        <rate code="RUR" value="285"  />
        <rate code="EUR" value="16.52" />
        <rate code="USD" value="12.18" />

Elements within blocks <BYR> and <UAH> contain currency rates from Russian ruble to Belarusian ruble and from Russian ruble to Ukrainian hryvnia. Other elements show other currencies to ruble.

3. Available price list requests in JSON

3.1. Price lists request

Main Biblio-Globus tours price lists id divided to smaller price lists. Each price list has route, departure city, available duration dates and departure date attributes. JSON request price list can have fixed destinations (countries) and departure cities.

Example request URL:


100410000049 — Cyprus identifier from countries list
100510000863 — Moscow identifier from cities list

Example JSON response:

            "route":"Туры на Кипр <b>Трансаэро (аэропорт Пафос \/ Ларнака)<\b>",
            "url":"ТУРЫ НА КИПРflt2=100510000863&id_price=121132934133&data=23.08.2014&xml=11",
        }, ...


date — departure date
route — price list route and airline name
duration — tour duration in price lists
url — a link to JSON request
stop — presence of this element meat that this tour is in stop-list стоп-листе.
minprice — minimal non-zero price from price list for one person with accommodation type "2 взрослых"("2 AD") 2 adults
minindex — equation of min_price of current price list to minimal min_price from all price list from the request
cur — price list currency
imp — a flag (1/0); with value 1 are marked prior Biblio-Globus price lists

3.2. Price lists and cities(resorts) dependency request

You need to form this URL to request a price list:

The link contains a parameter id_price - price list. To get dependencies request between cities(resorts) and id_price pull the request link:

Where the required parameters are:

data — refers to the date for the dependency request
flt2 — departure city(resort)

For proper work with this API service, please, follow these three steps:

  1. For each departure city(resort) and date save dependencies caches daily.
  2. To find dependencies for each hotel, first step - refer to the hotel’s city from the reference lists, second step - fetch the price lists for each city by pulling a request or find it from saved cache.
  3. Empty the saved caches daily.

Successful JSON response example:


      {"id":"121174225779", "imp":"Нет", "res": ["100574180976"]},
      {"id":"121174217697", "imp":"Нет", "res": ["100574180976"]},



id — object price list identifier
imp — boolean mark Yes(Да)/No(Нет). Yes(Да) is for priority Biblio-Globus price lists
res — an array of cities(resorts) identifiers, found in this price list
t — price list description. Is shown when a parameter is specified in your request URL
a — price list airline. Is shown when a parameter is specified in your request URL

3.3. Departure cities and tour destination countries request

Get the list of all possible departure cities with available tours by following the link below

It this JavaScript file you will find these parameters:

BG_FLTX — is initialized by its inherited object. It contains parameters:
flt2 — departure city
flt — tour’s country

flt — is an array of countries elements [100420695633, {"n":"Абхазия"}], which are country id (100420695633), and country name (Абхазия)
flt2 — is an array of cities elements [100510000863, {"n":Москва", "f" : 0, "t" : [1,3,1,...,1,1]}], where t equals to the size of ids array (equals to the amount of flt array size). Index of an element in the t array equals to country id from flt array.
If indicator in t array equals 1, then there are only tours without transfers for this country, else means tours have transfers (ex. flight, railway, bus).

3.4. Flight transfers and stop sale request

To get a list of stopped sales for flights and accommodation, make a request for stopped sales: Flights stopped sales Accommodation stopped sales

Successful response example for flights stopped sales:

  <item flight="103119663447" date="2013-10-05" class="E" nights="9"/>  
  <item flight="103119663447" date="2013-10-05" class="E" nights="6"/> 
  <item flight="103119663447" date="2013-10-05" class="E" nights="5"/>


flight — flight identifier in Biblio-Globus system
date — flight departure date
class — flight seat class
nights — amount of tour nights.
If an attribute nights is empty, then for this flight has been set a stopped sale for the picked flight departure date. If an attribute nights is not empty, then for this flight has been set a stopped sale for return flights on equal amount of tour nights

Successful response example for accommodation stopped sales:

  <item hotel="102640059661" datebeg="2013-10-06" dateend="2013-10-25" ns="104630536730"/>
  <item hotel="102640059661" datebeg="2013-10-06" dateend="2013-10-25" ns="104640059686"/>
  <item hotel="102630316562" datebeg="2013-12-29" dateend="2014-01-02"/>

Accomodation stopped sale happens for those hotels, which have intersection on date ranges from datebeg to dateend including. If ns is indicated, then stopped sales are only for specific accommodation types (room type, board basis, view).


hotel — hotel identifier in Biblio-Globus system
datebeg — start of stop date
dateend — end of stop date (incl.)
ns — accommodation type (room type, board basis, view)

4. Single price list request from Biblio-Globus system

To get price list data in JSON go to 3.1.

Change the last parameter of query string &xml=11 to &xml=21 to get the references of filters and for additional information If you add a new parameter &entr=-1 at the end of the query string, you will only get filters

JSON response example:

  "cur": "EUR",
  "prx": "104499999900000025",
  "entries": [
      "tour_date": "27.07.2014",
      "aircompany": "Аэрофлот",
      "town": "Ayia Napa",
      "room": "STANDARD Inland View HB",
      "dt": "27.07.2014",
      "href1": "&templ=121120516103&otn=104610790295&dt=27.07.2014&kol=2&sr=43UpM9e04HAuj08YLk204HAu+08YLkN-CF8yGA&c=YY00000000",
      "id_hotel": "102610001486",
      "id_ns": "104610790295",
      "duration": "2",
      "o_duration": "2",
      "quota": "9",
      "id_price": "121120516103",
      "sr": "43UpM9e04HAuj08YLk204HAu+08YLkN-CF8yGAj2d1f78aeef81c9d7aeeccc8bdfdf93ff",
      "prices": [
          "amount": "1473",
          "RUR": "71205",
          "href2": "&otv=102510005340&p=0250819780.0250819780#",
          "ag": "[14-99][14-99]"

Elements (entries) of the array have price-list description information like: hotel prices, accommodation, board basis, duration for each room type and board basises.


cur — tour currency
prx — a required parameter to create new bookings for tours via API.
tour_date — tour beginning date
aircompany — airlines
town — hotel's city
hotel — booked hotel and its category
room — room type and board basis
dt — the begiining date of the main tour accommodation (optional parameter)
flights — flight informationin HTML, is the same as on our main website. This parameter shows up only when a query parameter novirt is added.

duration — full nights accommodation duration

o_duration — full nights duration of main accommodation (optional parameter)
b_duration — full nights duration before the main accommodation (optional parameter)

ab_duration — second full nights duration before the main accommodation (optional parameter)
ba_duration — second full nights duration after the main accommodation (optional parameter)

a_duration — full nights duration after the main accommodation (optional parameter)

id_hotel — hotel identifier in Biblio-Globus system
isstop — array describes tour's stopped sales. Possible parameters are avia_to — flight departure stops, avia_from — return flight stops, hotel — hotel stops.

id_ns — room / board basis types identifier in Biblio-Globus system(*)

b_id_ns — room / board basis types identifier(*) before the beginning of the main accommodation (optional parameter)
b_id_h — its hotel identifier (optional parameter)

ab_id_ns — room / board basis types second identifier(*) before the beginning of the main accommodation (optional parameter)
ab_id_h — its hotel identifier (optional parameter)

ba_id_ns — room / board basis types second identifier(*) after the end of the main accommodation (optional parameter)
ba_id_h — its hotel identifier (optional parameter)

a_id_ns — room / board basis types identifier(*) after the end of the main accommodation (optional parameter)
a_id_h — its hotel identifier (optional parameter)

quota — quota of available suites for booking for selected hotel from this tour
ic, id_price, sr — service parameters for tour creation via Biblio-Globus API (are optional parameters)
flt2_ret — return city destination identifier. Only appears when return city is different from derarture city
prices — array describes tour's prices. Possible parameters are prices / amount — cost in tour's country currency, prices / RUR — cost in rubles, if tour's country currency is not in rubles
href0 + href1 + (prices / href2) — tour creation URL, that opens an HTML form for tour creation.

Example of stopped sales for both departure and return tickets:

  prices / isstop=["avia_to", "avia_from"]

Examples of tourists age ranges in price list response:

prices / ag="2-11,12+"
prices / ag="12+,12+"


prices / ag — tourists' age parameters. Age scopes are included in ranges. List of tourists' age ranges are separated by commas.
2-11,12+ — one child, one adult
12+,12+ — two adults

If parameter prices / amount is empty, then there are no available prices for current combination.
To request available prices for ground handling, specify a id_price=-1 parameter in your request URL with selected tour destination and tour dates.


100410000049 - Cyprus identifier from countries list
data=29.06.2013 - accommodation beginning date. Date format is DD.MM.YYYY

The response is identical to price list's.

4.1. Detailed parameters and filters for price list request

By default, any JSON price list response is cut after the first 60 array entries. To get more of array entries, add entr parameter to the request URL.

Value of entr starts from zero index of elements of the array. If you need to show 4 hotel entries at a page, substract from 4 - 1 to get the desirable amount of entries.
Example: For 4 hotel entries, enter the value equal to 3 entr = 3.

Additional request parameters that help to filter out the elements of the price list:

f1 - cities ids in the country, which can be added multiple times to the request URL in a row.
Example: &f1=100510001069 - shows the prices only for hotels in Limassol.
f3 - hotel category, which can be added multiple times to the request URL in a row.
Example: &f3=3*&f3=4* - adds filters only for 3* and 4* hotels.
F4 - hotel identifier, which can be added multiple times to the request URL in a row.
Example: &F4=102610001472&F4=102610001641 - shows the prices only for AKTEA BEACH VILLAGE 4* и ALMYRA 4* hotels.
f7 - booking duration (nights), which can be added multiple times to the request URL in a row.
Example: &f7=7&f7=9 - shows the prices only for 7 and 9 nights. Maximum value is 28 nights.
f8 - board basis types, which can be added multiple times to the request URL in a row.
Example: &f8=BB&f8=HB - shows the prices only for BB and HB.
novirt=0 - a parameter that allows to filter and pick a certain flight
stop=0 - a parameter that shows tours from stopped sales
p - description of age groups and tourist ages. Each tourist has its symbol group 0DDMMYYYYS.. Groups are divided by dots ".". Where: DDMMYYYY - is tourist's date of birth.
s - is a string of non-recurring digits from 0 to 4.
Example: 0010119600.0010119600 - group 0, two adults
Example: 02103196001.01612195023.00704200802 - 4 groups.
group 0 - 1 adult + 1 child
group 1 - 1 adult
group 2 - 1 adult + 1 child
group 3 - 1 adult


  • m parameter is no longer available.
  • According to Biblio-Globus tour offer agreement, if a tour was purchased without picking a certain flight, a tourist has a right to change departure airport, airlines and time. Even if at the moment of booking there was only one flight option available.
  • Picking a certain flight charges additional fee.
  • To pick a certain flight at booking creation via XML API, get value of <sr> only from request with the novirt=0 parameter.

List of hotel categories

5* 4* (Superior) 3*plus 2* DE LUX
5*sup (Grand Deluxe) 4*plus 3* 2* (Tourist) CLASS A
5* (Cat. Deluxe) 4* (Cat. A) 3* (Cat. B) 2* (Cat. B) CLASS B
5* (Deluxe) 4* 3* (Cat. A) 2* (Cat. C) CLASS C
3* (First) 1* APARTMENT

Board basis types

BB Bed and Breakfast: breakfast
HB Half Board: breakfast and evening meal
FB Full Board: breakfast, lunch and evening meal
AI All Inclusive
UAI, ULTRA ALL Ultra All Inclusive
AO Accommodation only: no meals

4.2. Detailed information for price list request

To get detailed information at price list JSON request, add &xml=31 parameter to you request URL

Example response:

"tourComposition": [
    "type": "flight",
    "id": "103151365832;103173777714;",
    "data": "26.03.2016",
    "id2": "103123196731;",
    "dl": "4",
    "d2": "30.03.2016",
    "n": "0",
    "q": "00"
    "type": "transfer",
    "title": "Трансфер26.03.2016DEGAULLE-PARIS(airport)-Paris(hotel)/group/bus",
    "id": "103875523965",
    "data": "26.03.2016"
    "type": "accomodation",
    "title": "Проживание: с26.03.2016по30.03.2016(4ночи)",
    "id": "104618112854",
    "n": "2",
    "q": "0"
    "type": "transfer",
    "title": "Трансфер30.03.2016Paris(hotel)-DEGAULLE-PARIS(airport)/group/bus",
    "id": "103875523957",
    "data": "30.03.2016"
    "type": "flight",
    "id": "103123196731;",
    "data": "30.03.2016",
    "id2": "103151365832;103173777714;",
    "dl": "4",
    "d2": "26.03.2016",
    "n": "1",
    "q": "00"
    "type": "medins",
    "title": "ECONOM-CLASS30000EUR"
    "type": "excursion",
    "id": "103625040753",
    "data": "26.03.2016"
    "type": "extra",
    "id": "105827587196"

4.2.1. Information for flight transfers


flight — flight description
id — flight identifier in Biblio-Globus system
data — flight date
id2 — flight identifier which is a part of forward flight id
data2 — date of forward flight
q — indicator of available seats on this flight. Its value can be 0 then econom seats have to be requested for. If its value is two-symbols, for example a4, then the first symbol stands for economy class, and the second symbol stands for business class. Each symbol is either a digit, which is not equal to 0, which is equal to available free seats left for this class.
a - there are many available seats
c - no seats available at all

To get more detailed information about flight by its data and id parameters, follow the request URL below:

4.2.2. Information for transfers


transfer — transfer description
title — transfer header
data — transfer date
id — transfer identifier in Biblio-Globus system

To get alternate for current transfer request, follow the request URL below:
Change this URL's parameters id, data from current transfer and id_valut - currency parameter from price list's upper section.
In the output JSON response you will get all transfer alternatives. Alternate transfers can be attached to booking on its creation via API.

4.2.3. Information for excursions and extras


excursion — excursion description
data — excursion date
id — excursion identifier in Biblio-Globus system

To get the full list of available excursions, follow the request URL below:
Change this URL's parameters flt - for country id, data - for date, n - number of tourists and id_price - price list id for all available excursions for.
In the output JSON response you will get all available excursions.

Example response:

"103618102053": {
  "1005": [
  "2005": [
  "name": "Accompaniment around Cyprus HALF DAY STANDARD CAR / Индивидуальная экскурсия по Кипру на полдня по эксклюзивно разработанному маршруту от 1 до 4 человек на стандартной машине",
  "ps": 230,
  "dates": [


1005 — list of cities ids, where are these excursions are available
2005 — list of cities names, matching the list of cities ids (1005)
name — excursion name
ps — excursion price, matching the list of cities ids (1005). Its format can be a number or an array of the following parameters: adt - adult, chd - child and inf - infant. Each parameter has its own price.
data — excursion date, matching the list of cities ids (1005)

In addition to excursions list, there can also be available other extras:

300110000000 — id of extra services
300210000000 — id of car rental services
300310000000 — id of books and city guides
300410000000 — id of tickets for sale

To get extras information, change the excursion id to the id from the list above to your request URL.

5. Special offers request in Biblio-Globus system

To get a list of hot special offers, request an XML file for selected departure city

Example link:


100510000863 – is an identifier of Moscow city from city list

Example response:

        <tourname>ТУРЫ НА КИПР</tourname>
  </entry> ...


country / id — country identifier
country / name — country name
city — departure city identifier
aircompany — airline name
cost / amount — cost in currency
cost / valute — currency code
duration — tour duration
date — flight departure date
tourname — price list route name
url — URL to price list

6. Special offers request in Biblio-Globus system: instant confirmation

Special offers list are stored in auto generated files. They are available from the link below:{flt2}-124331253701.js


flt2 – departure city/resort identifier in Biblio-Globus system

Example request:

Example response:

        "data" : "09.07.2014",
        "URL" : "",
        "hotelTown" : "Мармарис",
        "hotelPic" : "",
        "cntryName" : "Турция",
        "hotelURL" : "",
        "hotelId" : "102625929987",
        "hotelName" : "Gold Kaya Hotel 3*",
        "meal" : "BB",
        "dur" : "2, 4, 6, 7",
        "amount" : "173",
        "val" : "USD",
        "RUR" : "6124"
    }, ...


data — departure date
URL — search URL, where you can find special offers. it includes selected
hotelTown — resort name
hotelPic — a link to a hotel picture
cntryName — tour country name
hotelURL — an URL to the hotel
hotelId — hotel identifier in Biblio-Globus system
hotelName — hotel name
meal — meal type in hotel
dur — duration lists, divided by comma (,)
amount — lowest cost in currency for least duration
val — tour currency
RUR — lowest cost in rubles for least duration
ok — (IMPORTANT VALUE) if this field appears and has value 0, then this special offer has instant confirmation

7. Charter flights price search request

A search request returns charter flights price for indicated persons amount and their ages.

Example request url:


vr0 — amount of adults
vr1 — amount of kids
vr2 — amount of infants
idfrom — departure city id in Biblio-Globus system or an departure airport IATA code
idto — arrival city id or an arrival airport IATA code
datefrom — departure date YYYY-MM-DD
dateto — arrival date YYYY-MM-DD. If there is a one way flight, this field is missed
class — flight class. Y - economy class, C - business class
cur — currency. Is an optional parameter. By default are RUB (rubles). All possible currencies are RUB, EUR, USD.

Example response:

    "prx": "104499999900000071",
    "offers": [{
        "price": 4446,
        "nodes": ["FV550320170303", "FV550420170310"]
    "nodes": {
        "FV550320170303": {
            "ac": "FV",
            "fn": "5503",
            "dep": {
                "d": "03.03.2017",
                "t": "16:10:00",
                "n": "VKO"
            "arr": {
                "d": "03.03.2017",
                "t": "18:50:00",
                "n": "AER"
        "FV550420170310": {
            "ac": "FV",
            "fn": "5504",
            "dep": {
                "d": "10.03.2017",
                "t": "20:05:00",
                "n": "AER"
            "arr": {
                "d": "10.03.2017",
                "t": "22:40:00",
                "n": "VKO"


prx — session identifier
nodes — flight descriptions, that are included in price. Each node has unique name, which is been used to describe price
ac — airline code
fn — flight number
dep — departure point description
d — departure date DD.MM.YYYY
t — departure time HH:MM:SS или HH:MM
n — airport IATA code
arr — arrival point description. structure is the same as in "dep"
offers — price list for flight combination
price — responded price same as set in the request. Integer number variable
nodes — flights list, which have prices. node names are taken from "nodes" field