Biblio-Globus Tour Operator JSON price list API

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

Where:

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

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).

Where:

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)

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

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

Where:

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.

Where:

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.

Example request URL:

http://export.bgoperator.ru/partners?action=price&tid=211&id_price=-1&flt=100410000049&data=29.06.2013&xml=11

Where:

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.

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

ATTENTION!

• 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.

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

Where:

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:
http://export.bgoperator.ru/yandex?action=flightdetails&id=103139130550&data=10.10.2014

Where:

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:
http://export.bgoperator.ru/partners?action=title&id=103820000045&data=12.12.2015&id_valut=EUR&xml=11
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.

Where:

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:
http://export.bgoperator.ru/partners?xml=11&action=title&id=300010000000&flt=100410000049&data=31.03.2016&n=2&id_price=121120516103
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.

Where:

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.

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

http://export.bgoperator.ru/yandex?action=minprice&cityId=100510000863

Where:

100510000863 – is an identifier of Moscow city from city list

Where:

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

Special offers list are stored in auto generated files. They are available from the link below:
http://export.bgoperator.ru/auto/auto-spo-{flt2}-124331253701.js

Where:

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

http://export.bgoperator.ru/auto/auto-spo-100510000863v2-124331253701.js

Where:

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

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

http://export.bgoperator.ru/site?action=biletblock&vr0=1&vr1=1&vr2=0&idfrom=100510000863&idto=100510001068&datefrom=2017-01-20&dateto=2017-01-27&class=Y&cur=EUR

Where:

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.

Where:

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