The Flight Labs API was built to provide a simple way of accessing global aviation data for real-time and historical flights as well as allow customers to tap into an extensive data set of airline routes and other up-to-date aviation-related information.
Quickstart
To connect to the API, you can click the "run" button to run the show API request.
Requests to the REST API are made using a straightforward HTTP GET URL structure and responses are provided in lightweight JSON format.
Example API Request:
https://app.goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY
API Endpoints
Flight Data
This endpoint is capable of bringing real-time information about a specific flight in the world and retrieving flight status information in real time.
Example API Request With Flight Number Parameter:
https://app.goflightlabs.com/flight?access_key=YOUR_ACCESS_KEY&flight_number=3o375
Real-Time Flights
This endpoint is capable of information about all flights in the world flights and retrieving flight status information in real-time. In order to look up real-time information about one or multiple flights.
Data is being updated every 10 minutes
Example API Request:
https://app.goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY
Example API Request with limit parameter:
https://app.goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY&limit=100
Example API Request with Flight Iata parameter:
Please note that this is a Real-Time Flight. It may happen that the example does not return a response, as it is not en route. In that case, we recommend using another flight_iata.
https://app.goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY&flightIata=BA179
Example API Request with airline Iata parameter:
https://app.goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY&airlineIata=W8
Example API Request with departure location Iata parameter:
https://app.goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY&depIata=MAD
Example API Request with arrival location Iata parameter:
https://app.goflightlabs.com/flights?access_key=YOUR_ACCESS_KEY&arrIata=GIG
HTTP GET Request Parameters:
Object | Description |
---|---|
access_key |
[Required] Your API access key, which can be found in your acccount dashboard. |
limit |
[Optional] Limit value for output, integer max 10000 |
flightIata |
[Optional] Flight IATA code |
flightIcao |
[Optional] Flight ICAO code |
flightNum |
[Optional] Flight Number |
airlineIata |
[Optional] Airline IATA code |
airlineIcao |
[Optional] Airline ICAO code |
depIata |
[Optional] Departure airport IATA code |
depIcao |
[Optional] Departure airport ICAO code |
arrIata |
[Optional] Arrival airport IATA code |
arrIcao |
[Optional] Arrival airport ICAO code |
aircraftIcao |
[Optional] Aircraft ICAO code |
regNum |
[Optional] Aircraft registration number |
aircraftIcao24 |
[Optional] Aircraft ICAO24 code |
status |
[Optional] Status of the flight (started, en-route, landed, unknown) |
Example API Response:
{
"success": true,
"data": [
{
"aircraft": {
"iataCode":"B789",
"icao24":"C01040",
"icaoCode":"B789",
"regNumber":"C-FGDZ"
},
"airline": {
"iataCode":"AC",
"icaoCode":"ACA"
},
"arrival" : {
"iataCode":"GRU",
"icaoCode":"SBGR"
},
"departure" : {
"iataCode":"EZE",
"icaoCode":"SAEZ"
},
"flight" : {
"iataNumber":"AC91",
"icaoNumber":"ACA091",
"number":"91"
},
"geography" : {
"altitude":12496.8,
"direction":31.15,
"latitude":-26.98,
"longitude":-49.95
},
"speed" : {
"horizontal":880.74,
"isGround":0,
"vspeed":-1.188
},
"status":"en-route",
"system" : {
"squawk":null,
"updated":1665523076
}
},
{ ... },
]
}
API Response Objects:
Response Object | Description |
---|---|
aircraft |
Returns the aircraft data. Format: Array |
aircraft > iataCode |
Returns the IATA code. |
aircraft > icao24 |
Returns the Aircraft ICAO24 code. Example: C01040 |
aircraft > icaoCode |
Returns the ICAO code. |
aircraft > regNumber |
Returns the Aircraft registration number. |
airline |
Returns the array data. |
airline > iataCode |
Returns the IATA code Airline. |
airline > icaoCode |
Returns the ICAO code Airline. |
arrival |
Returns array data |
arrival > iataCode |
Returns the arrival airport IATA code . |
arrival > icaoCode |
Returns the arrival airport ICAO code. |
departure |
Returns array data |
departure > iataCode |
Returns the departure airport IATA code. |
departure > icaoCode |
Returns the departure airport ICAO code. |
flight |
Returns the data array. |
flight > iataNumber |
Returns the IATA Number. |
flight > icaoNumber |
Returns the ICAO Number. |
flight > number |
Returns the number of flight. |
geography |
Returns the data array. |
geography > altitude |
Returns the altitude flight. |
geography > direction |
Returns the direction flight. |
geography > latitude |
Returns the latitude flight. |
geography > longitude |
Returns the longitude flight. |
speed > horinzontal |
Returns the horizontal speed |
speed > isGround |
Returns the if is ground |
speed > vspeed |
Returns the vertical speed |
status |
Returns the status flight |
Flight Schedules.
The API is capable of tracking flights and retrieving flight status information in real-time. In order to look up real-time information about one or multiple flights, you can use the API's flights endpoint together with optional parameters to filter your result set.
Example API Request:
https://app.goflightlabs.com/advanced-flights-schedules?access_key=YOUR_ACCESS_KEY
Example API Request For the departure schedule of a certain airport:
https://app.goflightlabs.com/advanced-flights-schedules?access_key=YOUR_ACCESS_KEY&iataCode=JFK&type=departure
HTTP GET Request Parameters:
Object | Description |
---|---|
access_key |
[Required] Your API access key, which can be found in your acccount dashboard. |
iataCode |
[Optional] The IATA code of the airport you'd like to request data from. |
type |
[Optional] Flight type: departure or arrival |
status |
[Optional] The status of the flight: landed, scheduled, cancelled, active, incident, diverted, redirected, unknown. |
dep_iataCode |
[Optional] The IATA code of the departure airport (JFK, AMS, CDG, etc). |
dep_icaoCode |
[Optional] The ICAO code of the departure airport (KJFK, EHAM, LFPG, etc). |
dep_terminal |
[Optional] The terminal at the departure airport (1, 2, 3, 4, etc). |
dep_delay |
[Optional] The delay in minutes at departure (10, 20, 45, etc) it is not possible to set a delay range. |
dep_schTime |
[Optional] The scheduled flight's departure in the following format: YYYY-MM-DDT00:00:00.000 For example: 2023-06-01T21:00:00.000 |
dep_actTime |
[Optional] The actual flight departure time in the following format: YYYY-MM-DDT00:00:00.000 For example: 2023-06-01T21:00:00.000 |
dep_estRunway |
[Optional] The estimated departure time at runway in the following format: YYYY-MM-DDT00:00:00.000 For example: 2023-06-01T21:00:00.000 |
dep_actRunway |
[Optional] The actual departure time at runway in the following format: YYYY-MM-DDT00:00:00.000 For example: 2023-06-01T21:00:00.000 |
arr_iataCode |
[Optional] The IATA code of the arrival airport (JFK, AMS, CDG, etc). |
arr_icaoCode |
[Optional] The ICAO code of the arrival airport (KJFK, EHAM, LFPG, etc). |
arr_terminal |
[Optional] The terminal at the arrival airport (1, 2, 3, 4, etc) |
arr_delay |
[Optional] The delay in minutes at arrival (10, 20, 45, etc) it is not possible to set a delay range |
arr_schTime |
[Optional] The scheduled flight's arrival in the following format: YYYY-MM-DDT00:00:00.000 For example: 2023-06-01T21:00:00.000 |
arr_estTime |
[Optional] The actual flight arrival time in the following format: YYYY-MM-DDT00:00:00.000 For example: 2023-06-01T21:00:00.000 |
arr_estRunway |
[Optional] The estimated arrival time at runway in the following format: YYYY-MM-DDT00:00:00.000 For example: 2023-06-01T21:00:00.000 |
arr_estRunway |
[Optional] The actual arrival time at runway in the following format: YYYY-MM-DDT00:00:00.000 For example: 2023-06-01T21:00:00.000 |
airline_name |
[Optional] Name of the airline (Air France, American Airlines, Delta Air Lines, etc) (may need air%20france, american%20airlines, delta%20air%20lines is the response has problems) |
airline_iata |
[Optional] IATA code of airline |
airline_icao |
[Optional] ICAO code of airline |
flight_num |
[Optional] The flight number based on 1 to 4 digits, for example: 171 |
flight_iata |
[Optional] The flight iata number consisting of digits and letters, usually of the airline iata code. For example: AA171 |
flight_icao |
[Optional] The flight icao number consisting of digits and letters, usually the airline icao code. For example: AAL171 |
codeshared |
[Optional] If the flight is codeshared, this data will be included. If you don't want codeshared flights, you can input null |
Example API Response:
{
"success": true,
"data":
[
{
"airline": {
"iataCode": "TV",
"icaoCode": "TBA",
"name": "Tibet Airlines"
},
"arrival": {
"actualRunway": null,
"actualTime": null,
"baggage": null,
"delay": null,
"estimatedRunway": null,
"estimatedTime": "2022-11-07T16:17:00.000",
"gate": null,
"iataCode": "HJJ",
"icaoCode": "ZGCJ",
"scheduledTime": "2022-11-07T16:35:00.000",
"terminal": "3"
},
"codeshared": {
"airline": {
"iataCode": "gj",
"icaoCode": "cdc",
"name": "loong air"
},
"flight": {
"iataNumber": "gj8802",
"icaoNumber": "cdc8802",
"number": "8802"
}
},
"departure": {
"actualRunway": "2022-11-07T14:51:00.000",
"actualTime": "2022-11-07T14:51:00.000",
"baggage": null,
"delay": "1",
"estimatedRunway": "2022-11-07T14:51:00.000",
"estimatedTime": "2022-11-07T14:52:00.000",
"gate": "6",
"iataCode": "LJG",
"icaoCode": "ZPLJ",
"scheduledTime": "2022-11-07T14:50:00.000",
"terminal": null
},
"flight": {
"iataNumber": "TV7104",
"icaoNumber": "TBA7104",
"number": "7104"
},
"status": "active",
"type": "arrival"
},
[{...}]
]
}
API Response Objects:
Response Object | Description |
---|---|
airline > iataCode |
Returns The IATA code of the airline. |
airline > icaoCode |
Returns The ICAO code of the airline. |
airline > name |
Returns The NAME of the airline. |
arrival > actualRunway |
Returns The actual arrival time at runway in the following format: YYYY-MM-DDT00:00:00.000. |
arrival > actualTime |
Returns The actual time in the following format: YYYY-MM-DDT00:00:00.000. |
arrival > baggage |
Returns The baggage. |
arrival > delay |
Returns The delay. |
arrival > estimatedRunway |
Returns The estimated arrival time at runway in the following format: YYYY-MM-DDT00:00:00.000. |
arrival > estimatedTime |
Returns The estimated arrival time in the following format: YYYY-MM-DDT00:00:00.000. |
arrival > gate |
Returns The gate. |
arrival > iataCode |
Returns The IATA CODE. |
arrival > icaoCode |
Returns The ICAO CODE. |
arrival > scheduledTime |
Returns The Scheduled Time. |
arrival > terminal |
Returns The terminal. |
codeshared > airline > airline |
Returns The IATA Code airline. |
codeshared > airline > icaoCode |
Returns The ICAO Code airline. |
codeshared > airline > name |
Returns The Name. |
codeshared > flight > iataNumber |
Returns The IATA Code of flight. |
codeshared > flight > icaoNumber |
Returns The ICAO Code of flight. |
codeshared > flight > number |
Returns The number of flight. |
departure > actualRunway |
Returns The actual departure time at runway in the following format: YYYY-MM-DDT00:00:00.000. |
departure > actualTime |
Returns The actual time in the following format: YYYY-MM-DDT00:00:00.000. |
departure > baggage |
Returns The baggage. |
departure > delay |
Returns The delay. |
departure > estimatedRunway |
Returns The estimated departure time at runway in the following format: YYYY-MM-DDT00:00:00.000 . |
departure > estimatedTime |
Returns The estimated departure time in the following format: YYYY-MM-DDT00:00:00.000. |
departure > gate |
Returns The gate. |
departure > iataCode |
Returns The IATA code of departure. |
departure > icaoCode |
Returns The ICAO code of departure. |
departure > scheduledTime |
Returns The Scheduled Time of departure. |
departure > terminal |
Returns The terminal. |
flight > iataNumber |
Returns The IATA number of flight. |
flight > icaoNumber |
Returns The ICAO number of flight. |
flight > number |
Returns The flight number. |
status |
Returns The flight status. |
type |
Returns The flight type. |
Historical Flights
Apart from providing data about real-time flight, the API's flights endpoint is also capable of looking up data about historical flights.
Example API Request For the departure schedule of a certain airport on a certain date:
https://app.goflightlabs.com/historical/2023-05-02?access_key=YOUR_ACCESS_KEY&code=JFK&type=departure
Example API Request For the arrival schedule of a certain airport on a certain date:
https://app.goflightlabs.com/historical/2023-05-02?access_key=YOUR_ACCESS_KEY&code=JFK&type=arrival
Example API Request For the schedule of a certain airport of a certain date range (also available for arrival):
https://app.goflightlabs.com/historical/2023-05-02?access_key=YOUR_ACCESS_KEY&code=JFK&type=departure&date_to=2023-05-05
Example API Request For the schedule of a certain airport on a certain date (or range) but only flights with a certain status:
https://app.goflightlabs.com/historical/2023-05-02?access_key=YOUR_ACCESS_KEY&code=JFK&type=departure&date_to=2023-05-05&status=cancelled
Example API Request For tracking individual historical flights:
https://app.goflightlabs.com/historical/2023-05-02?access_key=YOUR_ACCESS_KEY&code=JFK&type=departure&date_to=2023-05-05&flight_number=5703
Example API Request For filtering the flights of a certain airline from the arrival schedule of a certain airport on a certain date (also available for departure schedules and as a date range):
https://app.goflightlabs.com/historical/2023-05-02?access_key=YOUR_ACCESS_KEY&code=JFK&type=departure&date_to=2023-05-05&airline_iata=AY
HTTP GET Request Parameters:
Status can be: "active" (for departure schedules only), "landed" (for arrival schedules only), "cancelled", "unknown".
Delay amount is included in minutes if a flight was delayed at the date.
The maximum date range can be 30 days which may be reduced to 3-5 days for large airports with heavy traffic.
Object | Description |
---|---|
access_key |
[Required] Your API access key, which can be found in your acccount dashboard. |
code |
[Required] Departure or arrival airport IATA code. |
type |
[Required] Either "departure" or "arrival" as both within the same query is not possible. |
date_to |
[Optional] Filter your results by end date of the requested date range. |
dep_iataCode |
[Optional] Filter by departure airport if "arrival" for "&type=" was chosen, based on the airport IATA code. |
arr_iataCode |
[Optional] Filter your results by arrival airport if "departure" for "&type=" was chosen, based on the airport IATA code. |
airline_iata |
[Optional] Option to filter airline based on airline IATA code |
flight_num |
[Optional] Option to filter a specific flight based on its flight number. Example: 5703 |
Example API Response:
{
"data": [
{
"type":"arrival",
"status":"cancelled",
"departure": {
"iata_code":"MLA",
"icao_code":"LMML",
"scheduled_time":"2020-07-18T08:35:00.000"
},
"arrival": {
"iata_code":"LGW",
"icao_code":"EGKK",
"terminal":"S",
"scheduled_time":"2020-07-18T10:55:00.000"
},
"airline": {
"name":"Air Baltic",
"iata_code":"BT",
"icao_code":"BTI"
},
"flight": {
"number":"6079",
"iata_number":"BT6079",
"icao_number":"BTI6079"
},
"codeshared": {
"airline": {
"name":"Air Malta",
"iata_code":"KM",
"icao_code":"AMC"
},
"flight": {
"number":"116",
"iata_number":"KM116",
"icao_number":"AMC116"
}
}
},
[...]
]
}
API Response Objects:
Response Object | Description |
---|---|
type |
Returns the type flight |
status |
Returns the flight status. Possible values: active (for departure schedules only), landed (for arrival schedules only), cancelled , unknown . |
departure > iata_code |
Returns the IATA code of the departure airport. |
departure > icao_code |
Returns the ICAO code of the departure airport. |
departure > scheduled_time |
Returns the scheduled time. |
arrival > iata_code |
Returns the IATA code of the arrival airport. |
arrival > icao_code |
Returns the ICAO code of the arrival airport. |
arrival > terminal |
Returns the terminal of the arrival airport. |
arrival > scheduled_time |
Returns the scheduled time. |
airline > name |
Returns the airline name. |
airline > iata_code |
Returns the airline IATA code. |
airline > icao_code |
Returns the airline ICAO code. |
flight > number |
Returns the flight number. |
flight > iata_number |
Returns the flight IATA number. |
flight > icao_number |
Returns the flight ICAO number. |
codeshared > airline > name |
Returns the airline name. |
codeshared > airline > iata_code |
Returns the airline IATA code. |
codeshared > airline > icao_code |
Returns the airline ICAO code. |
codeshared > flight > number |
Returns the flight number. |
codeshared > flight > iata_number |
Returns the flight IATA number. |
codeshared > flight > icao_number |
Returns the flight ICAO number. |
Object | Description |
---|---|
access_key |
[Required] Your API access key, which can be found in your acccount dashboard. |
iataCode |
[Required] Airport IATA code. |
type |
[Required] Either "departure" or "arrival" as both within the same query is not possible. |
date |
[Required] Future date in YYYY-MM-DD format and greater than 7 days from the current date. |
dep_iataCode |
[Optional] Filter of departure airport if "arrival" for "&type=" was chosen, based on the airport IATA code. |
dep_icaoCode |
[Optional] Filter of departure airport if "arrival" for "&type=" was chosen, based on the airport ICAO code. |
arr_iataCode |
[Optional] Filter of arrival airport if "departure" for "&type=" was chosen, based on the airport IATA code. |
arr_icaoCode |
[Optional] Filter of arrival airport if "departure" for "&type=" was chosen, based on the airport ICAO code. |
arr_icaoCode |
[Optional] Filter airline based on airline IATA code. |
airline_icao |
[Optional] Filter airline based on airline ICAO code. |
flight_num |
[Optional] Filter a specific flight based on its flight number. |
Example API Response:
{
"data": [
{
"weekday": "4",
"departure": {
"iataCode": "lax",
"icaoCode": "klax",
"terminal": "4",
"gate": "A",
"scheduledTime": "12:00"
},
"arrival": {
"iataCode": "jfk",
"icaoCode": "kjfk",
"terminal": "8",
"gate": "B",
"scheduledTime": "20:35"
},
"aircraft": {
"modelCode": "a321",
"modelText": "airbus a321-231"
},
"airline": {
"name": "american airlines",
"iataCode": "aa",
"icaoCode": "aal"
},
"flight": {
"number": "274",
"iataNumber": "aa274",
"icaoNumber": "aal274"
}
},
[...]
]
}
API Response Objects:
Response Object | Description |
---|---|
weekday |
Returns the weekday number | 1 = monday, 7 = sunday. |
departure > iataCode |
Returns the IATA code associated with the departure airport. |
departure > icaoCode |
Returns the ICAO code associated with the departure airport. |
departure > terminal |
Returns the terminal. |
departure > gate |
Returns the gate. |
departure > scheduledTime |
Returns the Scheduled Time. |
arrival > iataCode |
Returns the IATA code associated with the arrival airport. |
arrival > icaoCode |
Returns the ICAO code associated with the arrival airport. |
arrival > terminal |
Returns the terminal associated with the arrival airport. |
arrival > gate |
Returns the gate associated with the arrival airport. |
arrival > scheduledTime |
Returns the Scheduled Time associated with the arrival airport. |
aircraft > modelCode |
Returns the model code of aircraft. |
aircraft > modelText |
Returns the model in text of aircraft. |
airline > name |
Returns the name of airline. |
airline > iataCode |
Returns the IATA code of airline. |
airline > icaoCode |
Returns the ICAO code of airline. |
flight > number |
Returns the flight number. |
flight > iataNumber |
Returns the flight IATA number. |
flight > icaoNumber |
Returns the flight ICAO number. |
Airline Routes
The API is capable of providing data about airline routes, updated every 24 hours. In order to get airline route data, use the API's routes endpoint along with a series of optional parameters to filter results.
Example API Request:
https://app.goflightlabs.com/routes?access_key=YOUR_ACCESS_KEY
Example API Request with parameter Departure Iata Code:
https://app.goflightlabs.com/routes?access_key=YOUR_ACCESS_KEY&departureIata=OTP
Example API Request with parameter Departure Icao Code:
https://app.goflightlabs.com/routes?access_key=YOUR_ACCESS_KEY&departureIcao=LROP
Example API Request with parameter Airline Iata Code:
https://app.goflightlabs.com/routes?access_key=YOUR_ACCESS_KEY&airlineIata=0B
Example API Request with parameter Airline Icao Code:
https://app.goflightlabs.com/routes?access_key=YOUR_ACCESS_KEY&airlineIcao=BMS
Example API Request with parameter Flight Number:
https://app.goflightlabs.com/routes?access_key=YOUR_ACCESS_KEY&flightNumber=101
Example API Request with parameter Arrival Iata Code:
https://app.goflightlabs.com/routes?access_key=YOUR_ACCESS_KEY&arrivalIata=WAW
Example API Request with parameter Arrival Icao Code:
https://app.goflightlabs.com/routes?access_key=YOUR_ACCESS_KEY&arrivalIcao=EPWA
Example API Request for information about a specific route:
https://app.goflightlabs.com/routes?access_key=YOUR_ACCESS_KEY&departureIata=OTP&departureIcao=LROP&airlineIata=0B&airlineIcao=BMS&flightNumber=101
HTTP GET Request Parameters:
Object | Description |
---|---|
access_key |
[Required] Your API access key, which can be found in your acccount dashboard. |
departureIata |
[Optional] Filter your results by departure city or airport using an IATA code. You can retrieve IATA codes using the Airports or Cities API endpoints. Example: OTP. |
departureIcao |
[Optional] Filter your results by departure city or airport using an ICAO code. You can retrieve ICAO codes using the Airports or Cities API endpoints. Example: LROP. |
arrivalIata |
[Optional] Filter your results by arrival city or airport using an IATA code. You can retrieve IATA codes using the Airports or Cities API endpoints. Example: WAW. |
arrivalIcao |
[Optional] Filter your results by arrival airport using an ICAO code. You can retrieve ICAO codes using the Airports API endpoint. Example:EPWA. |
airlineIata |
[Optional] Filter your results by airline IATA code. You can retrieve airline IATA codes using the Airlines API endpoint. Example:0B. |
airlineIcao |
[Optional] Filter your results by airline ICAO code. You can retrieve airline IATA codes using the Airlines API endpoint. Example:BMS. |
flightNumber |
[Optional] Filter your results by providing a flight number. Example: 101. |
Example API Response:
{
"success": true,
"data": [
{
"airlineIata": "0B",
"airlineIcao": "BMS",
"arrivalIata": "TRN",
"arrivalIcao": "LIMF",
"arrivalTerminal": null,
"arrivalTime": "10:45:00",
"codeshares": null,
"departureIata": "OTP",
"departureIcao": "LROP",
"departureTerminal": null,
"departureTime": "09:15:00",
"flightNumber": "101",
"regNumber": [
"YR-BAP"
]
},
{
...
}
]
}
API Response Objects:
Response Object | Description |
---|---|
airlineIata |
Returns the Airline IATA code. |
airlineIcao |
Returns the Airline ICAO code. |
arrivalIata |
Returns the IATA code of the arrival location/airport. |
arrivalIcao |
Returns the ICAO code of the arrival location/airport. |
arrivalTerminal |
Returns the arrival terminal. |
arrivalTime |
Returns the arrival time. |
codeshares |
Returns the name of the code shares. |
departureIata |
Returns the IATA code of the departure location/airport. |
departureIcao |
Returns the ICAO code of the departure location/airport. |
departureTerminal |
Returns the departure terminal. |
departureTime |
Returns the departure time. |
flightNumber |
Returns the flight number. |
regNumber |
Returns the registration number. |
Airports
To get data about global airports, you can use the API's airports endpoint.
Example API Request For the entire database of airports:
https://app.goflightlabs.com/airports?access_key=YOUR_ACCESS_KEY
API request example For information about a specific airport, you can search based on IATA code.
https://app.goflightlabs.com/airports?access_key=YOUR_ACCESS_KEY&codeIataAirport=AAH
API request example For the airports based on the country code.
https://app.goflightlabs.com/airports?access_key=YOUR_ACCESS_KEY&codeIso2Country=DE
HTTP GET Request Parameters:
Object | Description |
---|---|
access_key |
[Required] Your API access key, which can be found in your acccount dashboard. |
codeIataAirport |
[Optional] Use this parameter to get information about a specific airport, you can search based on IATA code. |
codeIso2Country |
[Optional] Use this parameter to get airports based on the country ISO code. Example: DE, US, ES. |
Example API Response:
{
"data": [
{
"GTM": "1",
"airportId": 7,
"codeIataAirport": "AAH",
"codeIataCity": "AAH",
"codeIcaoAirport": "EDKA",
"codeIso2Country": "DE",
"geonameId": "3207669",
"latitudeAirport": 50.75,
"longitudeAirport": 6.133333,
"nameAirport": "Aachen/Merzbruc",
"nameCountry": "Germany",
"phone": "",
"timezone": "Europe/Berlin"
},
[...]
]
}
API Response Objects:
Response Object | Description |
---|---|
GTM |
Returns the GMT offset in hours. |
airportId |
Returns the full name of the airport. |
codeIataAirport |
Returns the IATA code associated with the airport. |
codeIataCity |
Returns the IATA code of the city the airport is in. |
codeIcaoAirport |
Returns the ICAO code associated with the airport. |
codeIso2Country |
Returns the ISO code country of the airport. |
geonameId |
Returns the GeoNames ID of the airport. |
latitudeAirport |
Returns the latitude coordinate associated with the airport location. |
longitudeAirport |
Returns the longitude coordinate associated with the airport location. |
nameAirport |
Returns the full name of the airport. |
nameCountry |
Returns the name of the country the airport is in. |
phone |
Returns the phone number of the airport. |
timezone |
Returns the timezone the airport is in. Example: Europe/Berlin |
Airlines
To get data about global airlines, you can use the API's airlines endpoint.
Example API Request For the entire database of airlines:
https://app.goflightlabs.com/airlines?access_key=YOUR_ACCESS_KEY
API request example for information about a specific airline, you can search based on IATA airline code
https://app.goflightlabs.com/airlines?access_key=YOUR_ACCESS_KEY&codeIataAirline=AA
API request example for the airlines based on the country codes.
https://app.goflightlabs.com/airlines?access_key=YOUR_ACCESS_KEY&codeIso2Country=US
HTTP GET Request Parameters:
Object | Description |
---|---|
access_key |
[Required] Your API access key, which can be found in your acccount dashboard. |
codeIataAirline |
[Optional] Use this parameter to get information about a specific airline, you can search based on IATA airline code. |
codeIso2Country |
[Optional] Use this parameter to get information the airlines based on the country codes. |
Example API Response:
{
"success": true,
"data": [
{
"ageFleet": 10.9,
"airlineId": 1,
"callsign": "AMERICAN",
"codeHub": "DFW",
"codeIataAirline": "AA",
"codeIcaoAirline": "AAL",
"codeIso2Country": "US",
"founding": 1934,
"iataPrefixAccounting": "1",
"nameAirline": "American Airlines",
"nameCountry": "United States",
"sizeAirline": 963,
"statusAirline": "active",
"type": "scheduled",
},
[...]
]
}
API Response Objects:
Response Object | Description |
---|---|
ageFleet |
Returns age fleet. |
airlineId |
Returns the airline Id. |
callsign |
Returns the call sign. |
codeHub |
Returns the hub code associated with the airline. |
callsign |
Returns the ICAO callsign of the airline. |
codeIataAirline |
Returns the IATA code of airline. |
codeIso2Country |
Returns the ISO2 code of Country. |
founding |
Returns the founding year. |
iataPrefixAccounting |
Returns the IATA code prefix accounting. |
nameAirline |
Returns the name of airline. |
nameCountry |
Returns the name of country. |
sizeAirline |
Returns the size of airline. |
statusAirline |
Returns the status of airline. |
type |
Returns the type of airline. |
Object | Description |
---|---|
access_key |
[Required] Your API access key, which can be found in your acccount dashboard. |
numberRegistration |
[Requiered | Conditional] Use this parameter to get information about a specific airplane, you can search based on registration number. |
hexIcaoAirplane |
[Requiered | Conditional] Use this parameter to get information about the airplanes based on the hex ICAO code. |
codeIataAirline |
[Requiered | Conditional] Use this parameter to get information about airplanes of a specific airline, you can search based on airline IATA code. |
Example API Response:
{
"success": true,
"data": [
{
airplaneIataType: "F28 MK0100"
airplaneId: 55
codeIataAirline: "2L"
codeIataPlaneLong: "F100"
codeIataPlaneShort: "100"
codeIcaoAirline: ""
constructionNumber: "11459"
deliveryDate: "1993-06-29T22:00:00.000Z"
enginesCount: "2"
enginesType: "JET"
firstFlight: "1993-05-31T22:00:00.000Z"
hexIcaoAirplane: "4B19EA"
lineNumber: ""
modelCode: "F100"
numberRegistration: "HB-JVE"
numberTestRgistration: "PH-EZD"
planeAge: "24"
planeClass: "1"
planeModel: "F-100"
planeOwner: ""
planeSeries: ""
planeStatus: "active"
productionLine: "Fokker 28/70/100"
registrationDate: "2004-05-11T22:00:00.000Z"
rolloutDate: "0000-00-00"
},
]
}
API Response Objects:
Response Object | Description |
---|---|
airplaneId |
Returns the ID of the airplane. |
numberRegistration |
Returns the registration number of the airplane. |
productionLine |
Returns the production line identifier of the airplane. |
airplaneIataType |
Returns the IATA type of the airplane. |
planeModel |
Returns the model name of the airplane. |
modelCode |
Returns the model code of the airplane. |
hexIcaoAirplane |
Returns the HEX ICAO code of the airplane. |
codeIataPlaneShort |
Returns the short IATA code of the airplane. |
codeIataPlaneLong |
Returns the long IATA code of the airplane. |
constructionNumber |
Returns the construction number of the airplane. |
numberTestRgistration |
Returns the test registration number of the airplane. |
rolloutDate |
Returns the rollout date of the airplane. |
firstFlight |
Returns the first flight date of the airplane. |
deliveryDate |
Returns the initial delivery date of the airplane. |
registrationDate |
Returns the initial registration date of the airplane. |
lineNumber |
Returns the production line number of the airplane. |
codeIataAirline |
Returns the IATA code of the airplane. |
codeIcaoAirline |
Returns the ICAO code of the airplane. |
planeOwner |
Returns the owner name of the airplane. |
enginesCount |
Returns the number of engines on the airplane. |
enginesType |
Returns the type of engines on the airplane. |
planeAge |
Returns the age of the airplane in years. |
planeStatus |
Returns the current status of the airplane. |
Object | Description |
---|---|
access_key |
[Required] Your API access key, which can be found in your acccount dashboard. |
codeIataAircraft |
[Optional] Use this parameter to get ainformation about a specific Aircraft type, input the IATA code. |
Example API Response:
{
"success": true,
"data": [
{
"planeTypeId": "100",
"nameAircraft": "Boeing 767-200 Freighter",
"codeIataAircraft": "76X"
},
[...]
]
}
API Response Objects:
Response Object | Description |
---|---|
planeTypeId |
Returns the aircraft type ID. |
nameAircraft |
Returns the aircraft name associated with the aircraft type. |
codeIataAircraft |
Returns the IATA code associated with the aircraft type. |
Object | Description |
---|---|
access_key |
[Required] Your API access key, which can be found in your acccount dashboard. |
codeIataTax |
[Optional] Use this parameter to get information about a specific tax code, input the IATA tax code. |
Example API Response:
{
"data": [
{
"taxId": "1",
"nameTax": "Government Tax",
"codeIataTax": "AB"
},
[...]
]
}
API Response Objects:
Response Object | Description |
---|---|
taxId |
Returns the ID of tax. |
nameTax |
Returns the name of the aviation tax. |
codeIataTax |
Returns the IATA code associated with the aviation tax. |
Object | Description |
---|---|
access_key |
[Required] Your API access key, which can be found in your acccount dashboard. |
city |
[Required] Autocomplete based on cities alone, example: amsterdam, ams. |
Example API Response:
{
"success": true,
"data": [
{
"cityId": "1",
"nameCity": "Anaa",
"codeIataCity": "AAA",
"codeIso2Country": "PF",
"latitudeCity": "-17.05",
"longitudeCity": "-145.41667",
"timezone": "Pacific/Tahiti",
"GMT": "-10",
"geonameId": "0"
},
[...]
]
}
API Response Objects:
Response Object | Description |
---|---|
cityId |
Returns the ID of the city. |
nameCity |
Returns the name of the city. |
codeIataCity |
Returns the IATA code of the city. |
codeIso2Country |
Returns the 2-letter ISO code of the city. |
latitudeCity |
Returns the latitude coordinate associated with the city. |
longitudeCity |
Returns the longitude coordinate associated with the city. |
timezone |
Returns the timezone the city is in. |
GMT |
Returns the GMT offset in hours. |
geonameId |
Returns the GeoName ID associated with the city. |
Object | Description |
---|---|
access_key |
[Required] Your API access key, which can be found in your acccount dashboard. |
codeIataCity |
[Optional] Use this parameter to get information about a specific city benchmark information, you can search based on IATA code. |
codeIso2Country |
[Optional] Use this parameter to get the city benchmark information based on the country code. |
Example API Response:
{
"success": true,
"data": [
{
"cityId": "1",
"nameCity": "Anaa",
"codeIataCity": "AAA",
"codeIso2Country": "PF",
"latitudeCity": "-17.05",
"longitudeCity": "-145.41667",
"timezone": "Pacific/Tahiti",
"GMT": "-10",
"geonameId": "0"
},
[...]
]
}
API Response Objects:
Response Object | Description |
---|---|
cityId |
Returns the ID of the city. |
nameCity |
Returns the name of the city. |
codeIataCity |
Returns the IATA code of the city. |
codeIso2Country |
Returns the 2-letter ISO code of the city. |
latitudeCity |
Returns the latitude coordinate associated with the city. |
longitudeCity |
Returns the longitude coordinate associated with the city. |
timezone |
Returns the timezone the city is in. |
GMT |
Returns the GMT offset in hours. |
geonameId |
Returns the GeoName ID associated with the city. |
Object | Description |
---|---|
access_key |
[Required] Your API access key, which can be found in your acccount dashboard. |
codeIso2Country |
[Optional] Use this parameter to get information about a specific country, you can search based on ISO code. |
nameCountry |
[Optional] Use this parameter to get the country information based on the country name. |
Example API Response:
{
"data": [
{
"countryId": "1",
"nameCountry": "Andorra",
"codeIso2Country": "AD",
"codeIso3Country": "AND",
"numericIso": "20", "population": "84000",
"capital": "Andorra la Vella",
"continent": "EU",
"nameCurrency": "Euro",
"codeCurrency": "EUR",
"codeFips": "AN",
"phonePrefix": "376"
},
[...]
]
}
API Response Objects:
Response Object | Description |
---|---|
countryId |
Returns the ID of the country. |
nameCountry |
Returns the name of the country. |
codeIso2Country |
Returns the 2-letter ISO code of the country. |
codeIso3Country |
Returns the 3-letter ISO code of the country. |
numericIso |
Returns the numeric ISO code of the country. |
capital |
Returns the capital of the country. |
continent |
Returns the continent the country is located in. |
nameCurrency |
Returns the name of the currency associated with the country. |
codeCurrency |
Returns the code of the currency associated with the country. |
codeFips |
Returns the FIPS code of the country. |
phonePrefix |
Returns the phone prefix associated with the country. |
population |
Returns the population of the country. |
Object | Description |
---|---|
access_key |
[Required] Your API access key, which can be found in your acccount dashboard. |
query |
[Required] Use this parameter to get autocomplete suggestions for matching airport data by specifying any country as a string. |
Example API Response:
{
"success": true,
"data": [
{
"iata_code": "BER",
"name": "Berlin Brandenburg",
"city": "Berlin",
"country": "Germany"
},
{
"iata_code": "BGO",
"name": "Bergen",
"city": "Bergen",
"country": "Norway"
},
{
"iata_code": "BRN",
"name": "Bern",
"city": "Bern",
"country": "Switzerland"
},
{
"iata_code": "BZE",
"name": "Belize City Philip S.W.Goldson Int",
"city": "Belize City",
"country": "Belize"
},
{
"iata_code": "BNI",
"name": "Benin City",
"city": "Benin City",
"country": "Nigeria"
}
]
}
API Response Objects:
Response Object | Description |
---|---|
iata_code |
Returns IATA Code of each airport. |
name |
Returns the name of airport. |
city |
Returns the name of city airport. |
country |
Returns the name of country airport. |
Object | Description |
---|---|
access_key |
[Required] Your API access key, which can be found in your acccount dashboard. |
adults |
[Required] Number of adult passengers (16 and over) Allowed values: 1-8. |
origin |
[Required] Departure airport IATA code. |
destination |
[Required] Destination airport IATA code. |
departureDate |
[Required] Departure date Format: YYYY-MM-DD. |
returnDate |
[Optional] Return date Format: YYYY-MM-DD. |
cabinClass |
[Optional] Enum only accept 'economy', 'premiumeconomy', 'business', 'first'. |
currency |
[Optional] Currency code (ISO 4217) Ex: EUR - USD as string. |
childAge1 |
[Optional] Age of first child Allowed values: 0- 15. |
childAge2 |
[Optional] Age of first child Allowed values: 0- 15. |
childAge3 |
[Optional] Age of first child Allowed values: 0- 15. |
childAge4 |
[Optional] Age of first child Allowed values: 0- 15. |
childAge5 |
[Optional] Age of first child Allowed values: 0- 15. |
childAge6 |
[Optional] Age of first child Allowed values: 0- 15. |
childAge7 |
[Optional] Age of first child Allowed values: 0- 15. |
childAge8 |
[Optional] Age of first child Allowed values: 0- 15. |
Example API Response:
{
"success": true,
"data": {
"buckets": [
{
"id": "Best",
"name": "Best",
"items": [
{
"id": "13870-2210110630--31915-0-11493-2210110900",
"price": {
"raw": 75,
"formatted": "75 €"
},
"legs": [
{
"id": "13870-2210110630--31915-0-11493-2210110900",
"origin": {
"id": "MAD",
"name": "Madrid",
"displayCode": "MAD",
"city": "Madrid",
"isHighlighted": false
},
"destination": {
"id": "FCO",
"name": "Rome Fiumicino",
"displayCode": "FCO",
"city": "Rome",
"isHighlighted": false
},
"durationInMinutes": 150,
"stopCount": 0,
"isSmallestStops": true,
"departure": "2022-10-11T06:30:00",
"arrival": "2022-10-11T09:00:00",
"timeDeltaInDays": 0,
"carriers": {
"marketing": [
{
"id": -31915,
"logoUrl": "https://logos.skyscnr.com/images/airlines/favicon/FR.png",
"name": "Ryanair"
}
],
"operationType": "fully_operated"
},
"segments": [
{
"id": "13870-11493-2210110630-2210110900--31915",
"origin": {
"flightPlaceId": "MAD",
"parent": {
"flightPlaceId": "MADR",
"name": "Madrid",
"type": "City"
},
"name": "Madrid",
"type": "Airport"
},
"destination": {
"flightPlaceId": "FCO",
"parent": {
"flightPlaceId": "ROME",
"name": "Rome",
"type": "City"
},
"name": "Rome Fiumicino",
"type": "Airport"
},
"departure": "2022-10-11T06:30:00",
"arrival": "2022-10-11T09:00:00",
"durationInMinutes": 150,
"flightNumber": "9674",
"marketingCarrier": {
"id": -31915,
"name": "Ryanair",
"alternateId": "FR",
"allianceId": 0
},
"operatingCarrier": {
"id": -31915,
"name": "Ryanair",
"alternateId": "FR",
"allianceId": 0
}
}
]
}
],
"isSelfTransfer": false,
"eco": {
"ecoContenderDelta": 7.2873774
},
"isMashUp": false,
"hasFlexibleOptions": false,
"score": 3.14962
}
]
}
]
}
}
API Response Objects:
Response Object | Description |
---|---|
buckets |
Returns array with Best - Fastest - Cheapest - Direct flights. |
id |
Returns id of kind of flights. |
name |
Returns the name of kind of flights. |
items |
Returns array of flights of each type. |
id |
Returns id of flight. |
price |
Returns price of flight. |
legs |
Returns content information of flight. |
Object | Description |
---|---|
access_key |
[Required] Your API access key, which can be found in your acccount dashboard. |
adults |
[Required] Number of adult (16 and over) passengers (1-8). |
origin |
[Required] IATA code of origin airport. |
destination |
[Required] IATA code of destination airport. |
departureDate |
[Required] Date of first flight, format YYYY-MM-DD. |
returnDate |
[Optional] Date of return flight, format YYYY-MM-DD - if omitted, one-way ticket itineraries are shown. |
cabinClass |
[Optional] Class of ticket, possible values: economy, premiumeconomy, business, first - default: economy. |
currency |
[Optional] Currency of flight prices, default: EUR. |
childAge1 |
[Optional] Age of first child Allowed values: 0- 15. |
childAge2 |
[Optional] Age of first child Allowed values: 0- 15. |
childAge3 |
[Optional] Age of first child Allowed values: 0- 15. |
childAge4 |
[Optional] Age of first child Allowed values: 0- 15. |
childAge5 |
[Optional] Age of first child Allowed values: 0- 15. |
childAge6 |
[Optional] Age of first child Allowed values: 0- 15. |
childAge7 |
[Optional] Age of first child Allowed values: 0- 15. |
childAge8 |
[Optional] Age of first child Allowed values: 0- 15. |
stops |
[Optional] Comma separated filter for number of stops per leg, possible values 0, 1, and 2 (2 = 2+). |
duration |
[Optional] Filter for maximum leg duration in hours. |
startFrom |
[Optional] Outbound journey departs after, format HH:mm. |
arriveTo |
[Optional] Outbound journey arrives before, format HH:mm. |
returnStartFrom |
[Optional] Return journey departs after, format HH:mm. |
returnArriveTo |
[Optional] Return journey arrives before, format HH:mm. |
Example API Response:
{
"success": true,
"data": {
"results": [
{
"id": "13870-2210111040--32480-1-11493-2210111725",
"legs": [
{
"id": "13870-2210111040--32480-1-11493-2210111725",
"origin": {
"id": 13870,
"name": "Madrid",
"displayCode": "MAD"
},
"destination": {
"id": 11493,
"name": "Rome Fiumicino",
"displayCode": "FCO"
},
"durationInMinutes": 405,
"stopCount": 1,
"isSmallestStops": true,
"departure": "2022-10-11T10:40:00",
"arrival": "2022-10-11T17:25:00",
"timeDeltaInDays": 0,
"carriers": {
"marketing": [
{
"id": -32480,
"name": "British Airways"
}
],
"operationType": "fully_operated"
},
"segments": [
{
"id": "13870-13554-2210111040-2210111200--32480",
"origin": {
"flightPlaceId": "MAD",
"parent": {
"flightPlaceId": "MAD",
"name": "Madrid",
"type": "City"
},
"name": "Madrid",
"type": "Airport"
},
"destination": {
"flightPlaceId": "LHR",
"parent": {
"flightPlaceId": "LON",
"name": "London",
"type": "City"
},
"name": "London Heathrow",
"type": "Airport"
},
"departure": "2022-10-11T10:40:00",
"arrival": "2022-10-11T12:00:00",
"durationInMinutes": 140,
"flightNumber": "457",
"marketingCarrier": {
"id": -32480,
"name": "British Airways",
"alternate_di": "BA",
"allianceId": -32000
},
"operatingCarrier": {
"id": -32480,
"name": "British Airways",
"alternate_di": "BA",
"allianceId": -32000
}
},
{
"id": "13554-11493-2210111345-2210111725--32480",
"origin": {
"flightPlaceId": "LHR",
"parent": {
"flightPlaceId": "LON",
"name": "London",
"type": "City"
},
"name": "London Heathrow",
"type": "Airport"
},
"destination": {
"flightPlaceId": "FCO",
"parent": {
"flightPlaceId": "ROM",
"name": "Rome",
"type": "City"
},
"name": "Rome Fiumicino",
"type": "Airport"
},
"departure": "2022-10-11T13:45:00",
"arrival": "2022-10-11T17:25:00",
"durationInMinutes": 160,
"flightNumber": "556",
"marketingCarrier": {
"id": -32480,
"name": "British Airways",
"alternate_di": "BA",
"allianceId": -32000
},
"operatingCarrier": {
"id": -32480,
"name": "British Airways",
"alternate_di": "BA",
"allianceId": -32000
}
}
]
}
],
"pricing_options": [
{
"agents": [
{
"id": "eduk",
"name": "eDreams",
"is_carrier": false,
"update_status": "current",
"optimised_for_mobile": true,
"live_update_allowed": true,
"rating_status": "available",
"rating": 2.35,
"feedback_count": 9130,
"rating_breakdown": {
"reliable_prices": 2.675344,
"clear_extra_fees": 3.789988,
"customer_service": 3.508816,
"ease_of_booking": 3.248132,
"other": 1.186932
}
}
],
"price": {
"amount": 255.81,
"update_status": "current",
"last_updated": "2022-09-14T17:38:00",
"quote_age": 134
}
},
{
"agents": [
{
"id": "trup",
"name": "travelup",
"is_carrier": false,
"update_status": "current",
"optimised_for_mobile": true,
"live_update_allowed": true,
"rating_status": "available",
"rating": 3.49,
"feedback_count": 21357,
"rating_breakdown": {
"reliable_prices": 2.8393,
"clear_extra_fees": 4.476256,
"customer_service": 4.966728,
"ease_of_booking": 4.006016,
"other": 2.6659
}
}
],
"price": {
"amount": 256.86,
"update_status": "current",
"last_updated": "2022-09-14T19:44:00",
"quote_age": 8
}
},
{
"agents": [
{
"id": "ba__",
"name": "British Airways",
"is_carrier": true,
"update_status": "current",
"optimised_for_mobile": true,
"live_update_allowed": true,
"rating_status": "available",
"rating": 4.33,
"feedback_count": 8103,
"rating_breakdown": {
"reliable_prices": 4.63556,
"clear_extra_fees": 4.676892,
"customer_service": 4.98788,
"ease_of_booking": 4.538596,
"other": 3.462924
}
}
],
"price": {
"amount": 262.31,
"update_status": "current",
"last_updated": "2022-09-14T13:37:00",
"quote_age": 375
}
},
{
"agents": [
{
"id": "opuk",
"name": "Opodo",
"is_carrier": false,
"update_status": "current",
"optimised_for_mobile": true,
"live_update_allowed": true,
"rating_status": "available",
"rating": 2.89,
"feedback_count": 10524,
"rating_breakdown": {
"reliable_prices": 2.642644,
"clear_extra_fees": 4.037472,
"customer_service": 4.926028,
"ease_of_booking": 3.48266,
"other": 1.475856
}
}
],
"price": {
"amount": 263.35,
"update_status": "current",
"last_updated": "2022-09-14T17:38:44",
"quote_age": 133
}
},
{
"agents": [
{
"id": "ytuk",
"name": "Skyscanner",
"is_carrier": false,
"update_status": "current",
"optimised_for_mobile": true,
"live_update_allowed": true,
"rating_status": "available",
"rating": 4.5,
"feedback_count": 6145,
"rating_breakdown": {
"reliable_prices": 4.624616,
"clear_extra_fees": 4.722904,
"customer_service": 5,
"ease_of_booking": 4.739636,
"other": 3.929264
}
}
],
"price": {
"amount": 265.51,
"update_status": "current",
"last_updated": "2022-09-14T19:44:38",
"quote_age": 7
}
},
{
"agents": [
{
"id": "s1uk",
"name": "BudgetAir",
"is_carrier": false,
"update_status": "current",
"optimised_for_mobile": true,
"live_update_allowed": true,
"rating_status": "available",
"rating": 3.88,
"feedback_count": 19734,
"rating_breakdown": {
"reliable_prices": 4.048528,
"clear_extra_fees": 4.510536,
"customer_service": 4.811432,
"ease_of_booking": 4.285048,
"other": 2.883328
}
}
],
"price": {
"amount": 266.41,
"update_status": "current",
"last_updated": "2022-09-14T17:38:49",
"quote_age": 133
}
}
]
}
]
}
}
API Response Objects:
Response Object | Description |
---|---|
results |
Returns array with flights. |
id |
Returns id of flights. |
legs |
Returns array of objects with information of flight with origin and destination selected. |
pricing_options |
Returns array of pricing options. |
Object | Description |
---|---|
access_key |
[Required] Your API access key, which can be found in your acccount dashboard. |
query |
[Required] Use this parameter to get suggestions for hotel location by city. |
Example API Response (scrollable):
{
"success": true,
"data": [
{
"hierarchy": "Berlin|Berlin|Germany",
"location": "52.366667, 13.50333",
"highlight": {
"hierarchy": "Berlin|Berlin|Germany",
"location_name": "95673383"
},
"class": "Airport",
"location_id": "95673383",
"location_name": "Berlin Brandenburg (BER)"
},
{
"hierarchy": "Berlin|Germany",
"location": "52.4865621581, 13.4245185552",
"highlight": {
"hierarchy": "Berlin|Germany",
"location_name": "27547053"
},
"class": "City",
"location_id": "27547053",
"location_name": "Berlin"
},
{
"hierarchy": "Berlin|Coos County|New Hampshire|United States",
"location": "44.574722, -71.176389",
"highlight": {
"hierarchy": "Berlin|Coos County|New Hampshire|United States",
"location_name": "129052940"
},
"class": "Airport",
"location_id": "129052940",
"location_name": "Berlin (BML)"
},
{
"hierarchy": "Hartford County|Connecticut|United States",
"location": "41.621487992, -72.7456519713",
"highlight": {
"hierarchy": "Hartford County|Connecticut|United States",
"location_name": "35467636"
},
"class": "City",
"location_id": "35467636",
"location_name": "Berlin"
},
{
"hierarchy": "Brandenburg|Germany",
"location": "52.6739047886, 13.568761033",
"highlight": {
"hierarchy": "Brandenburg|Germany",
"location_name": "81980359"
},
"class": "City",
"location_id": "81980359",
"location_name": "Bernau bei Berlin"
},
{
"hierarchy": "Neiva|Huila Department|Colombia",
"location": "3.0536110992, -75.4236110947",
"highlight": {
"hierarchy": "Neiva|Huila Department|Colombia",
"location_name": "45789405"
},
"class": "City",
"location_id": "45789405",
"location_name": "Berlin"
},
{
"hierarchy": "Marshall County|Tennessee|United States",
"location": "35.5297941932, -86.8244448044",
"highlight": {
"hierarchy": "Marshall County|Tennessee|United States",
"location_name": "46824016"
},
"class": "City",
"location_id": "46824016",
"location_name": "Berlin"
},
{
"hierarchy": "Worcester County|Massachusetts|United States",
"location": "42.3812039914, -71.6370120133",
"highlight": {
"hierarchy": "Worcester County|Massachusetts|United States",
"location_name": "46855770"
},
"class": "City",
"location_id": "46855770",
"location_name": "Berlin"
},
{
"hierarchy": "Worcester County|Maryland|United States",
"location": "38.3226153929, -75.2176891939",
"highlight": {
"hierarchy": "Worcester County|Maryland|United States",
"location_name": "46793487"
},
"class": "City",
"location_id": "46793487",
"location_name": "Berlin"
},
{
"hierarchy": "LaMoure County|North Dakota|United States",
"location": "46.3785822928, -98.48981832",
"highlight": {
"hierarchy": "LaMoure County|North Dakota|United States",
"location_name": "46864936"
},
"class": "City",
"location_id": "46864936",
"location_name": "Berlin"
}
]
}
API Response Objects:
Response Object | Description |
---|---|
data |
Returns array of results. |
hierarchy |
Returns the city | locality | country . |
location |
Returns the coordinates of the city. |
location_name |
Returns the name of location. |
highlight |
Returns the highlight of entity. |
location_id |
Returns the location id of city to be used in Search Hotel Rooms Endpoint and in Search Car Rentals Endpoint. |
class |
Returns type of result if is Airport or City. |
Object | Description |
---|---|
access_key |
[Required] Your API access key, which can be found in your acccount dashboard. |
adults |
[Required] number of adult (18 and over) guests (1-10). |
rooms |
[Required] number of rooms (1-5). |
locationId |
[Required] location entity id - it can be obtained via Location Data For Hotel Search. |
checkin |
[Required] checkin date, format YYYY-MM-DD. |
checkout |
[Required] checkout date, format YYYY-MM-DD. |
rooms |
[Required] number of rooms (1-5). |
childAge1-childAge5 |
[Optional] childAge1-childAge5 - ages of children (0-15) guests. |
page |
[Optional] page of results - default: first page is returned. |
sortBy |
[Optional] sort results by, possible values: -relevance, -price, price, distance, -hotel_rating, -stars, stars - default: -relevance. |
currency |
[Optional] currency of hotel prices, default: EUR. |
Example API Response: (scrollable)
{
"success": true,
"data": {
"hotels": [
{
"hotelId": "104597435",
"heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/767398211/767398211_WxH.jpg",
"name": "Grand Hostel Berlin Urban",
"stars": 3,
"brandIds": [],
"distance": "3,89 km from city centre",
"relevantPoiDistance": "2.07 km from Tempelhofer Park",
"coordinates": [
13.4258,
52.48752
],
"price": "585 €",
"cheapestOfferPartnerId": "h_ad",
"cheapestOfferRateId": null,
"rawPrice": 585,
"rating": {
"description": "Very good",
"count": 614,
"value": "8.0",
"color": "colorMonteverde"
},
"reviewSummary": {
"description": "Very good",
"count": 614,
"formatCount": "614",
"value": "4.0",
"formatValue": "4,0",
"color": "colorMonteverde",
"taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.0-64600-4.png"
},
"cheapestOffer": "meta",
"offerTypes": "meta",
"guestType": null,
"exclusiveDealLabel": null,
"pricesFrom": "5 prices from",
"images": [
"https://d2xf5gjipzd8cd.cloudfront.net/available/767398211/767398211_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/767398213/767398213_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/791664227/791664227_WxH.jpg"
],
"otherRates": [
{
"partnerId": "h_hc",
"partnerName": "Hotels.com",
"rawPrice": 627,
"price": "627 €"
},
{
"partnerId": "h_bc",
"partnerName": "Booking.com",
"rawPrice": 688,
"price": "688 €"
},
{
"partnerId": "h_io",
"partnerName": "Opodo",
"rawPrice": 688,
"price": "688 €"
},
{
"partnerId": "h_ct",
"partnerName": "Trip.com",
"rawPrice": 689,
"price": "689 €"
}
],
"priceDescription": "195 € a night",
"taxPolicy": "All taxes and fees included",
"rateFeatures": [
{
"key": "free_cancellation",
"text": "Free cancellation",
"color": {
"light": "colorAbisko",
"dark": "colorValensole"
}
}
],
"cheapestOfferPartnerName": "Agoda"
},
{
"hotelId": "117357901",
"heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/884719305/884719305_WxH.jpg",
"name": "Park Inn by Radisson Berlin Alexanderplatz",
"stars": 4,
"brandIds": [],
"distance": "0,17 km from city centre",
"relevantPoiDistance": "2.91 km from Berlin Central Station",
"coordinates": [
13.41293,
52.5232
],
"price": "2.298 €",
"cheapestOfferPartnerId": "h_ct",
"cheapestOfferRateId": null,
"rawPrice": 2298,
"rating": {
"description": "Good",
"count": 11439,
"value": "7.0",
"color": "colorKolkata"
},
"reviewSummary": {
"description": "Good",
"count": 11439,
"formatCount": "11.439",
"value": "3.5",
"formatValue": "3,5",
"color": "colorKolkata",
"taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/3.5-64600-4.png",
"confidenceBadge": {
"type": "location",
"score": 4.5,
"icon": "thumbs-up",
"color": {
"light": "colorMonteverde",
"dark": "colorMonteverde"
},
"message": "Hotel location is rated 4.5/5"
}
},
"cheapestOffer": "meta",
"offerTypes": "meta",
"guestType": null,
"exclusiveDealLabel": null,
"pricesFrom": "1 price",
"images": [
"https://d2xf5gjipzd8cd.cloudfront.net/available/884719305/884719305_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/540318460/540318460_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/475829685/475829685_WxH.jpg"
],
"otherRates": [],
"priceDescription": "766 € a night",
"taxPolicy": "All taxes and fees included",
"rateFeatures": [],
"cheapestOfferPartnerName": "Trip.com"
},
{
"hotelId": "81981751",
"heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/798019037/798019037_WxH.jpg",
"name": "City Pension Berlin",
"stars": 2,
"brandIds": [],
"distance": "7,62 km from city centre",
"relevantPoiDistance": "2.31 km from Tierpark",
"coordinates": [
13.3039,
52.50565
],
"price": "574 €",
"cheapestOfferPartnerId": "h_bc",
"cheapestOfferRateId": null,
"rawPrice": 574,
"rating": {
"description": "Very good",
"count": 95,
"value": "8.0",
"color": "colorMonteverde"
},
"reviewSummary": {
"description": "Very good",
"count": 95,
"formatCount": "95",
"value": "4.0",
"formatValue": "4,0",
"color": "colorMonteverde",
"taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.0-64600-4.png",
"confidenceBadge": {
"type": "location",
"score": 4.5,
"icon": "thumbs-up",
"color": {
"light": "colorMonteverde",
"dark": "colorMonteverde"
},
"message": "Hotel location is rated 4.5/5"
}
},
"cheapestOffer": "meta",
"offerTypes": "meta",
"guestType": null,
"exclusiveDealLabel": null,
"pricesFrom": "3 prices from",
"images": [
"https://d2xf5gjipzd8cd.cloudfront.net/available/798019037/798019037_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/721648397/721648397_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/798019009/798019009_WxH.jpg"
],
"otherRates": [
{
"partnerId": "h_io",
"partnerName": "Opodo",
"rawPrice": 574,
"price": "574 €"
},
{
"partnerId": "h_ad",
"partnerName": "Agoda",
"rawPrice": 574,
"price": "574 €"
}
],
"priceDescription": "192 € a night",
"taxPolicy": "All taxes and fees included",
"rateFeatures": [
{
"key": "breakfast_included",
"text": "Breakfast included",
"color": {
"light": "colorMonteverde",
"dark": "colorMonteverde"
}
}
],
"cheapestOfferPartnerName": "Booking.com"
},
{
"hotelId": "47005673",
"heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/678947461/678947461_WxH.jpg",
"name": "Hotel am Schloß Köpenick by Golden Tulip",
"stars": 4,
"brandIds": [],
"distance": "13,75 km from city centre",
"relevantPoiDistance": "1.72 km from Sportplatz Eiche",
"coordinates": [
13.56953,
52.44259
],
"price": "650 €",
"cheapestOfferPartnerId": "h_ad",
"cheapestOfferRateId": null,
"rawPrice": 650,
"rating": {
"description": "Good",
"count": 323,
"value": "7.0",
"color": "colorKolkata"
},
"reviewSummary": {
"description": "Good",
"count": 323,
"formatCount": "323",
"value": "3.5",
"formatValue": "3,5",
"color": "colorKolkata",
"taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/3.5-64600-4.png"
},
"cheapestOffer": "meta",
"offerTypes": "meta",
"guestType": null,
"exclusiveDealLabel": null,
"pricesFrom": "6 prices from",
"images": [
"https://d2xf5gjipzd8cd.cloudfront.net/available/678947461/678947461_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/767187908/767187908_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/678947398/678947398_WxH.jpg"
],
"otherRates": [
{
"partnerId": "h_zh",
"partnerName": "ZenHotels",
"rawPrice": 687,
"price": "687 €"
},
{
"partnerId": "h_ct",
"partnerName": "Trip.com",
"rawPrice": 692,
"price": "692 €"
},
{
"partnerId": "h_hc",
"partnerName": "Hotels.com",
"rawPrice": 704,
"price": "704 €"
},
{
"partnerId": "h_bc",
"partnerName": "Booking.com",
"rawPrice": 706,
"price": "706 €"
},
{
"partnerId": "h_io",
"partnerName": "Opodo",
"rawPrice": 706,
"price": "706 €"
}
],
"priceDescription": "217 € a night",
"taxPolicy": "All taxes and fees included",
"rateFeatures": [],
"cheapestOfferPartnerName": "Agoda"
},
{
"hotelId": "47024884",
"heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/885415561/885415561_WxH.jpg",
"name": "Leonardo Royal Hotel Berlin Alexanderplatz",
"stars": 4,
"brandIds": [],
"distance": "0,93 km from city centre",
"relevantPoiDistance": "0.92 km from Alexanderplatz",
"coordinates": [
13.42333,
52.52741
],
"price": "820 €",
"cheapestOfferPartnerId": "h_ad",
"cheapestOfferRateId": null,
"rawPrice": 820,
"rating": {
"description": "Very good",
"count": 2676,
"value": "8.0",
"color": "colorMonteverde"
},
"reviewSummary": {
"description": "Very good",
"count": 2676,
"formatCount": "2.676",
"value": "4.0",
"formatValue": "4,0",
"color": "colorMonteverde",
"taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.0-64600-4.png",
"confidenceBadge": {
"type": "cleanliness",
"score": 4.5,
"icon": "thumbs-up",
"color": {
"light": "colorAbisko",
"dark": "colorValensole"
},
"message": "Hotel cleanliness is rated 4.5/5"
},
"cleanliness": {
"score": 4.5,
"text": "Cleanliness 4,5",
"color": {
"light": "colorAbisko",
"dark": "colorValensole"
}
}
},
"cheapestOffer": "meta",
"offerTypes": "meta",
"guestType": null,
"exclusiveDealLabel": null,
"pricesFrom": "7 prices from",
"images": [
"https://d2xf5gjipzd8cd.cloudfront.net/available/885415561/885415561_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/626336231/626336231_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/797629239/797629239_WxH.jpg"
],
"otherRates": [
{
"partnerId": "h_ct",
"partnerName": "Trip.com",
"rawPrice": 846,
"price": "846 €"
},
{
"partnerId": "h_zh",
"partnerName": "ZenHotels",
"rawPrice": 934,
"price": "934 €"
},
{
"partnerId": "h_hc",
"partnerName": "Hotels.com",
"rawPrice": 986,
"price": "986 €"
},
{
"partnerId": "h_pi",
"partnerName": "Prestigia",
"rawPrice": 986,
"price": "986 €"
},
{
"partnerId": "h_bc",
"partnerName": "Booking.com",
"rawPrice": 989,
"price": "989 €"
},
{
"partnerId": "h_io",
"partnerName": "Opodo",
"rawPrice": 989,
"price": "989 €"
}
],
"priceDescription": "274 € a night",
"taxPolicy": "All taxes and fees included",
"rateFeatures": [],
"cheapestOfferPartnerName": "Agoda"
},
{
"hotelId": "118138611",
"heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/720408331/720408331_WxH.jpg",
"name": "Steigenberger Hotel Am Kanzleramt",
"stars": 5,
"brandIds": [
"90718601"
],
"distance": "3,06 km from city centre",
"relevantPoiDistance": "0.17 km from Berlin Central Station",
"coordinates": [
13.36818,
52.52389
],
"price": "1.132 €",
"cheapestOfferPartnerId": "h_ad",
"cheapestOfferRateId": null,
"rawPrice": 1132,
"rating": {
"description": "Excellent",
"count": 5180,
"value": "9.0",
"color": "colorMonteverde"
},
"reviewSummary": {
"description": "Excellent",
"count": 5180,
"formatCount": "5.180",
"value": "4.5",
"formatValue": "4,5",
"color": "colorMonteverde",
"taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.5-64600-4.png",
"confidenceBadge": {
"type": "cleanliness",
"score": 4.5,
"icon": "thumbs-up",
"color": {
"light": "colorAbisko",
"dark": "colorValensole"
},
"message": "Hotel cleanliness is rated 4.5/5"
},
"cleanliness": {
"score": 4.5,
"text": "Cleanliness 4,5",
"color": {
"light": "colorAbisko",
"dark": "colorValensole"
}
}
},
"cheapestOffer": "meta",
"offerTypes": "meta",
"guestType": null,
"exclusiveDealLabel": null,
"pricesFrom": "8 prices from",
"images": [
"https://d2xf5gjipzd8cd.cloudfront.net/available/720408331/720408331_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/479080044/479080044_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/756238280/756238280_WxH.jpg"
],
"otherRates": [
{
"partnerId": "h_ct",
"partnerName": "Trip.com",
"rawPrice": 1174,
"price": "1.174 €"
},
{
"partnerId": "h_hc",
"partnerName": "Hotels.com",
"rawPrice": 1190,
"price": "1.190 €"
},
{
"partnerId": "h_pi",
"partnerName": "Prestigia",
"rawPrice": 1190,
"price": "1.190 €"
},
{
"partnerId": "h_bc",
"partnerName": "Booking.com",
"rawPrice": 1193,
"price": "1.193 €"
},
{
"partnerId": "h_io",
"partnerName": "Opodo",
"rawPrice": 1193,
"price": "1.193 €"
},
{
"partnerId": "h_df",
"partnerName": "Derbysoft CPA",
"rawPrice": 1193,
"price": "1.193 €"
},
{
"partnerId": "h_zh",
"partnerName": "ZenHotels",
"rawPrice": 1565,
"price": "1.565 €"
}
],
"priceDescription": "378 € a night",
"taxPolicy": "All taxes and fees included",
"rateFeatures": [],
"cheapestOfferPartnerName": "Agoda"
},
{
"hotelId": "46946476",
"heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/756493656/756493656_WxH.jpg",
"name": "Pentahotel Berlin Köpenick",
"stars": 4,
"brandIds": [],
"distance": "13,65 km from city centre",
"relevantPoiDistance": "1.67 km from Sportplatz Eiche",
"coordinates": [
13.56946,
52.44405
],
"price": "648 €",
"cheapestOfferPartnerId": "h_ad",
"cheapestOfferRateId": null,
"rawPrice": 648,
"rating": {
"description": "Very good",
"count": 2,
"value": "8.6",
"color": "colorMonteverde"
},
"reviewSummary": {
"description": "Excellent",
"count": 2,
"formatCount": "2",
"value": "4.3",
"formatValue": "4,3",
"color": "colorMonteverde",
"taImage": null
},
"cheapestOffer": "meta",
"offerTypes": "meta",
"guestType": null,
"exclusiveDealLabel": null,
"pricesFrom": "5 prices from",
"images": [
"https://d2xf5gjipzd8cd.cloudfront.net/available/756493656/756493656_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/846221229/846221229_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/756493726/756493726_WxH.jpg"
],
"otherRates": [
{
"partnerId": "h_hc",
"partnerName": "Hotels.com",
"rawPrice": 790,
"price": "790 €"
},
{
"partnerId": "h_bc",
"partnerName": "Booking.com",
"rawPrice": 881,
"price": "881 €"
},
{
"partnerId": "h_io",
"partnerName": "Opodo",
"rawPrice": 881,
"price": "881 €"
},
{
"partnerId": "h_ct",
"partnerName": "Trip.com",
"rawPrice": 881,
"price": "881 €"
}
],
"priceDescription": "216 € a night",
"taxPolicy": "All taxes and fees included",
"rateFeatures": [],
"cheapestOfferPartnerName": "Agoda"
},
{
"hotelId": "46980715",
"heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/353065567/353065567_WxH.jpg",
"name": "Vienna House Andel's Berlin",
"stars": 4,
"brandIds": [
"90718630"
],
"distance": "3,08 km from city centre",
"relevantPoiDistance": "2.69 km from Haus des Lehrers",
"coordinates": [
13.45736,
52.52856
],
"price": "757 €",
"cheapestOfferPartnerId": "h_ad",
"cheapestOfferRateId": null,
"rawPrice": 757,
"rating": {
"description": "Excellent",
"count": 3179,
"value": "9.0",
"color": "colorMonteverde"
},
"reviewSummary": {
"description": "Excellent",
"count": 3179,
"formatCount": "3.179",
"value": "4.5",
"formatValue": "4,5",
"color": "colorMonteverde",
"taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.5-64600-4.png",
"confidenceBadge": {
"type": "cleanliness",
"score": 4.5,
"icon": "thumbs-up",
"color": {
"light": "colorAbisko",
"dark": "colorValensole"
},
"message": "Hotel cleanliness is rated 4.5/5"
},
"cleanliness": {
"score": 4.5,
"text": "Cleanliness 4,5",
"color": {
"light": "colorAbisko",
"dark": "colorValensole"
}
}
},
"cheapestOffer": "meta",
"offerTypes": "meta",
"guestType": null,
"exclusiveDealLabel": null,
"pricesFrom": "6 prices from",
"images": [
"https://d2xf5gjipzd8cd.cloudfront.net/available/353065567/353065567_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/766308939/766308939_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/676746400/676746400_WxH.jpg"
],
"otherRates": [
{
"partnerId": "h_bc",
"partnerName": "Booking.com",
"rawPrice": 800,
"price": "800 €"
},
{
"partnerId": "h_hc",
"partnerName": "Hotels.com",
"rawPrice": 800,
"price": "800 €"
},
{
"partnerId": "h_io",
"partnerName": "Opodo",
"rawPrice": 800,
"price": "800 €"
},
{
"partnerId": "h_pi",
"partnerName": "Prestigia",
"rawPrice": 800,
"price": "800 €"
},
{
"partnerId": "h_ct",
"partnerName": "Trip.com",
"rawPrice": 833,
"price": "833 €"
}
],
"priceDescription": "253 € a night",
"taxPolicy": "All taxes and fees included",
"rateFeatures": [],
"cheapestOfferPartnerName": "Agoda"
},
{
"hotelId": "123708745",
"heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/776543855/776543855_WxH.jpg",
"name": "Best Western Plus Plaza Berlin Kurfuerstendamm",
"stars": 4,
"brandIds": [
"90718297"
],
"distance": "6,49 km from city centre",
"relevantPoiDistance": "1.20 km from Tierpark",
"coordinates": [
13.32313,
52.50188
],
"price": "883 €",
"cheapestOfferPartnerId": "h_ct",
"cheapestOfferRateId": null,
"rawPrice": 883,
"rating": {
"description": "Very good",
"count": 680,
"value": "8.0",
"color": "colorMonteverde"
},
"reviewSummary": {
"description": "Very good",
"count": 680,
"formatCount": "680",
"value": "4.0",
"formatValue": "4,0",
"color": "colorMonteverde",
"taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.0-64600-4.png",
"confidenceBadge": {
"type": "location",
"score": 4.5,
"icon": "thumbs-up",
"color": {
"light": "colorMonteverde",
"dark": "colorMonteverde"
},
"message": "Hotel location is rated 4.5/5"
}
},
"cheapestOffer": "meta",
"offerTypes": "meta",
"guestType": null,
"exclusiveDealLabel": null,
"pricesFrom": "1 price",
"images": [
"https://d2xf5gjipzd8cd.cloudfront.net/available/776543855/776543855_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/885520318/885520318_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/677039326/677039326_WxH.jpg"
],
"otherRates": [],
"priceDescription": "295 € a night",
"taxPolicy": "All taxes and fees included",
"rateFeatures": [],
"cheapestOfferPartnerName": "Trip.com"
},
{
"hotelId": "46965268",
"heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/685200851/685200851_WxH.jpg",
"name": "Airporthotel Berlin-Adlershof",
"stars": 3,
"brandIds": [],
"distance": "12,88 km from city centre",
"relevantPoiDistance": null,
"coordinates": [
13.5346519,
52.4323981
],
"price": "639 €",
"cheapestOfferPartnerId": "h_hc",
"cheapestOfferRateId": null,
"rawPrice": 639,
"rating": {
"description": "Good",
"count": 128,
"value": "7.0",
"color": "colorKolkata"
},
"reviewSummary": {
"description": "Good",
"count": 128,
"formatCount": "128",
"value": "3.5",
"formatValue": "3,5",
"color": "colorKolkata",
"taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/3.5-64600-4.png",
"confidenceBadge": {
"type": "cleanliness",
"score": 4.5,
"icon": "thumbs-up",
"color": {
"light": "colorAbisko",
"dark": "colorValensole"
},
"message": "Hotel cleanliness is rated 4.5/5"
}
},
"cheapestOffer": "meta",
"offerTypes": "meta",
"guestType": null,
"exclusiveDealLabel": null,
"pricesFrom": "6 prices from",
"images": [
"https://d2xf5gjipzd8cd.cloudfront.net/available/685200851/685200851_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/685200722/685200722_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/685200821/685200821_WxH.jpg"
],
"otherRates": [
{
"partnerId": "h_ad",
"partnerName": "Agoda",
"rawPrice": 652,
"price": "652 €"
},
{
"partnerId": "h_ct",
"partnerName": "Trip.com",
"rawPrice": 709,
"price": "709 €"
},
{
"partnerId": "h_bc",
"partnerName": "Booking.com",
"rawPrice": 740,
"price": "740 €"
},
{
"partnerId": "h_io",
"partnerName": "Opodo",
"rawPrice": 740,
"price": "740 €"
},
{
"partnerId": "h_zh",
"partnerName": "ZenHotels",
"rawPrice": 758,
"price": "758 €"
}
],
"priceDescription": "213 € a night",
"taxPolicy": "All taxes and fees included",
"rateFeatures": [],
"cheapestOfferPartnerName": "Hotels.com"
},
{
"hotelId": "129852394",
"heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/578592363/578592363_WxH.jpg",
"name": "Qbe Hotel Heizhaus Berlin",
"stars": 3,
"brandIds": [],
"distance": "7,68 km from city centre",
"relevantPoiDistance": "2.89 km from Dong Xuan Center",
"coordinates": [
13.52618,
52.51459
],
"price": "628 €",
"cheapestOfferPartnerId": "h_ad",
"cheapestOfferRateId": null,
"rawPrice": 628,
"rating": {
"description": "Good",
"count": 117,
"value": "7.0",
"color": "colorKolkata"
},
"reviewSummary": {
"description": "Good",
"count": 117,
"formatCount": "117",
"value": "3.5",
"formatValue": "3,5",
"color": "colorKolkata",
"taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/3.5-64600-4.png"
},
"cheapestOffer": "meta",
"offerTypes": "meta",
"guestType": null,
"exclusiveDealLabel": null,
"pricesFrom": "3 prices from",
"images": [
"https://d2xf5gjipzd8cd.cloudfront.net/available/578592363/578592363_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/578592370/578592370_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/578592341/578592341_WxH.jpg"
],
"otherRates": [
{
"partnerId": "h_bc",
"partnerName": "Booking.com",
"rawPrice": 698,
"price": "698 €"
},
{
"partnerId": "h_io",
"partnerName": "Opodo",
"rawPrice": 698,
"price": "698 €"
}
],
"priceDescription": "210 € a night",
"taxPolicy": "All taxes and fees included",
"rateFeatures": [],
"cheapestOfferPartnerName": "Agoda"
},
{
"hotelId": "47005674",
"heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/468174153/468174153_WxH.jpg",
"name": "Best Western Hotel am Spittelmarkt Berlin",
"stars": 3,
"brandIds": [
"90718297"
],
"distance": "1,40 km from city centre",
"relevantPoiDistance": "2.92 km from Berlin Central Station",
"coordinates": [
13.40554,
52.51001
],
"price": "743 €",
"cheapestOfferPartnerId": "h_ct",
"cheapestOfferRateId": null,
"rawPrice": 743,
"rating": {
"description": "Very good",
"count": 2104,
"value": "8.0",
"color": "colorMonteverde"
},
"reviewSummary": {
"description": "Very good",
"count": 2104,
"formatCount": "2.104",
"value": "4.0",
"formatValue": "4,0",
"color": "colorMonteverde",
"taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.0-64600-4.png",
"confidenceBadge": {
"type": "cleanliness",
"score": 4.5,
"icon": "thumbs-up",
"color": {
"light": "colorAbisko",
"dark": "colorValensole"
},
"message": "Hotel cleanliness is rated 4.5/5"
},
"cleanliness": {
"score": 4.5,
"text": "Cleanliness 4,5",
"color": {
"light": "colorAbisko",
"dark": "colorValensole"
}
}
},
"cheapestOffer": "meta",
"offerTypes": "meta",
"guestType": null,
"exclusiveDealLabel": null,
"pricesFrom": "5 prices from",
"images": [
"https://d2xf5gjipzd8cd.cloudfront.net/available/468174153/468174153_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/540318893/540318893_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/678730280/678730280_WxH.jpg"
],
"otherRates": [
{
"partnerId": "h_hc",
"partnerName": "Hotels.com",
"rawPrice": 767,
"price": "767 €"
},
{
"partnerId": "h_bc",
"partnerName": "Booking.com",
"rawPrice": 770,
"price": "770 €"
},
{
"partnerId": "h_io",
"partnerName": "Opodo",
"rawPrice": 770,
"price": "770 €"
},
{
"partnerId": "h_ad",
"partnerName": "Agoda",
"rawPrice": 770,
"price": "770 €"
}
],
"priceDescription": "248 € a night",
"taxPolicy": "All taxes and fees included",
"rateFeatures": [],
"cheapestOfferPartnerName": "Trip.com"
},
{
"hotelId": "46991985",
"heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/776354322/776354322_WxH.jpg",
"name": "Hotel Atrium Charlottenburg",
"stars": 3,
"brandIds": [],
"distance": "7,72 km from city centre",
"relevantPoiDistance": "2.42 km from Tierpark",
"coordinates": [
13.3022,
52.506
],
"price": "603 €",
"cheapestOfferPartnerId": "h_bc",
"cheapestOfferRateId": null,
"rawPrice": 603,
"rating": {
"description": "Good",
"count": 260,
"value": "7.0",
"color": "colorKolkata"
},
"reviewSummary": {
"description": "Good",
"count": 260,
"formatCount": "260",
"value": "3.5",
"formatValue": "3,5",
"color": "colorKolkata",
"taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/3.5-64600-4.png"
},
"cheapestOffer": "meta",
"offerTypes": "meta",
"guestType": null,
"exclusiveDealLabel": null,
"pricesFrom": "3 prices from",
"images": [
"https://d2xf5gjipzd8cd.cloudfront.net/available/776354322/776354322_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/756793262/756793262_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/716071100/716071100_WxH.jpg"
],
"otherRates": [
{
"partnerId": "h_io",
"partnerName": "Opodo",
"rawPrice": 603,
"price": "603 €"
},
{
"partnerId": "h_ad",
"partnerName": "Agoda",
"rawPrice": 603,
"price": "603 €"
}
],
"priceDescription": "201 € a night",
"taxPolicy": "All taxes and fees included",
"rateFeatures": [],
"cheapestOfferPartnerName": "Booking.com"
},
{
"hotelId": "114941752",
"heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/884122288/884122288_WxH.jpg",
"name": "Seminaris CampusHotel Berlin",
"stars": 4,
"brandIds": [],
"distance": "10,88 km from city centre",
"relevantPoiDistance": "0.17 km from Free University of Berlin",
"coordinates": [
13.29475,
52.45566
],
"price": "785 €",
"cheapestOfferPartnerId": "h_ad",
"cheapestOfferRateId": null,
"rawPrice": 785,
"rating": {
"description": "With honours",
"count": 5,
"value": "10.0",
"color": "colorMonteverde"
},
"reviewSummary": {
"description": "With honours",
"count": 5,
"formatCount": "5",
"value": "5.0",
"formatValue": "5,0",
"color": "colorMonteverde",
"taImage": null,
"confidenceBadge": {
"type": "cleanliness",
"score": 5,
"icon": "thumbs-up",
"color": {
"light": "colorAbisko",
"dark": "colorValensole"
},
"message": "Hotel cleanliness is rated 5/5"
}
},
"cheapestOffer": "meta",
"offerTypes": "meta",
"guestType": null,
"exclusiveDealLabel": null,
"pricesFrom": "6 prices from",
"images": [
"https://d2xf5gjipzd8cd.cloudfront.net/available/884122288/884122288_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/685242731/685242731_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/797666910/797666910_WxH.jpg"
],
"otherRates": [
{
"partnerId": "h_hc",
"partnerName": "Hotels.com",
"rawPrice": 806,
"price": "806 €"
},
{
"partnerId": "h_zh",
"partnerName": "ZenHotels",
"rawPrice": 880,
"price": "880 €"
},
{
"partnerId": "h_ct",
"partnerName": "Trip.com",
"rawPrice": 925,
"price": "925 €"
},
{
"partnerId": "h_bc",
"partnerName": "Booking.com",
"rawPrice": 987,
"price": "987 €"
},
{
"partnerId": "h_io",
"partnerName": "Opodo",
"rawPrice": 987,
"price": "987 €"
}
],
"priceDescription": "262 € a night",
"taxPolicy": "All taxes and fees included",
"rateFeatures": [
{
"key": "breakfast_included",
"text": "Breakfast included",
"color": {
"light": "colorMonteverde",
"dark": "colorMonteverde"
}
}
],
"cheapestOfferPartnerName": "Agoda"
},
{
"hotelId": "47026369",
"heroImage": "https://d2xf5gjipzd8cd.cloudfront.net/available/884124234/884124234_WxH.jpg",
"name": "Mövenpick Hotel Berlin",
"stars": 4,
"brandIds": [],
"distance": "2,99 km from city centre",
"relevantPoiDistance": "2.46 km from Berlin Central Station",
"coordinates": [
13.3804410696,
52.5037399316
],
"price": "1.214 €",
"cheapestOfferPartnerId": "h_ct",
"cheapestOfferRateId": null,
"rawPrice": 1214,
"rating": {
"description": "Excellent",
"count": 2839,
"value": "9.0",
"color": "colorMonteverde"
},
"reviewSummary": {
"description": "Excellent",
"count": 2839,
"formatCount": "2.839",
"value": "4.5",
"formatValue": "4,5",
"color": "colorMonteverde",
"taImage": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.5-64600-4.png",
"confidenceBadge": {
"type": "cleanliness",
"score": 4.5,
"icon": "thumbs-up",
"color": {
"light": "colorAbisko",
"dark": "colorValensole"
},
"message": "Hotel cleanliness is rated 4.5/5"
},
"cleanliness": {
"score": 4.5,
"text": "Cleanliness 4,5",
"color": {
"light": "colorAbisko",
"dark": "colorValensole"
}
}
},
"cheapestOffer": "meta",
"offerTypes": "meta",
"guestType": null,
"exclusiveDealLabel": null,
"pricesFrom": "7 prices from",
"images": [
"https://d2xf5gjipzd8cd.cloudfront.net/available/884124234/884124234_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/754872707/754872707_WxH.jpg",
"https://d2xf5gjipzd8cd.cloudfront.net/available/884124409/884124409_WxH.jpg"
],
"otherRates": [
{
"partnerId": "h_ad",
"partnerName": "Agoda",
"rawPrice": 1227,
"price": "1.227 €"
},
{
"partnerId": "h_zh",
"partnerName": "ZenHotels",
"rawPrice": 1250,
"price": "1.250 €"
},
{
"partnerId": "h_hc",
"partnerName": "Hotels.com",
"rawPrice": 1284,
"price": "1.284 €"
},
{
"partnerId": "h_pi",
"partnerName": "Prestigia",
"rawPrice": 1284,
"price": "1.284 €"
},
{
"partnerId": "h_bc",
"partnerName": "Booking.com",
"rawPrice": 1288,
"price": "1.288 €"
},
{
"partnerId": "h_io",
"partnerName": "Opodo",
"rawPrice": 1288,
"price": "1.288 €"
}
],
"priceDescription": "405 € a night",
"taxPolicy": "All taxes and fees included",
"rateFeatures": [],
"cheapestOfferPartnerName": "Trip.com"
}
],
"nightsForPrice": "For 3 nights",
"resultsSummary": "232 results sorted by Best",
"closedUserGroupDeals": [
"general"
],
"pricePolicy": "All taxes and fees included",
"mapBoundary": {
"n_e_lat": 52.539137808999996,
"s_w_lat": 52.4111463201,
"n_e_lng": 13.5805212,
"s_w_lng": 13.283758800000001
},
"hotelPivot": null,
"medianMinPrice": 1057.5,
"entity": {
"name": "Berlin",
"entity_id": "27547053",
"centroid": {
"type": "Point",
"coordinates": [
13.4245185552,
52.4865621581
]
},
"entity_type": "City",
"official_center": {
"type": "Point",
"coordinates": [
13.413333,
52.521667
]
},
"levelOfEntityType": "PoliticalTypes"
},
"location": [
{
"entity_type": "FirstLevelNationAdministrativeDivision",
"name": "Berlin",
"entity_id": "44293353"
},
{
"entity_type": "Nation",
"name": "Germany",
"entity_id": "29475381"
}
],
"priceType": "total",
"localCurrency": "EUR",
"hotelsRegion": {
"latitude": 52.50804,
"longitude": 13.38063,
"longitudeDelta": 0.16145999999999905,
"latitudeDelta": 0.0490399999999953
},
"totalHotels": 232,
"totalHotelsFiltered": 232,
"pois": [
{
"type": "Transportation",
"coordinate": [
13.50333,
52.366667
],
"sub_poi_type": "Airport",
"name": "Berlin Brandenburg",
"image_url": null,
"is_extend": null,
"id": 95673383
},
{
"type": "Transportation",
"coordinate": [
13.3699998498,
52.5249761108
],
"sub_poi_type": "TrainStation",
"name": "Berlin Central Station",
"image_url": null,
"is_extend": null,
"id": 207975909
},
{
"type": "Landmark",
"coordinate": [
13.40568,
52.57838
],
"sub_poi_type": "TouristAttraction",
"name": "Schloss Schoenhausen",
"image_url": null,
"is_extend": null,
"id": 206563816
},
{
"type": "Landmark",
"coordinate": [
13.3777041,
52.5162746
],
"sub_poi_type": "TouristAttraction",
"name": "Brandenburg Gate",
"image_url": "https://d2xf5gjipzd8cd.cloudfront.net/POI/206569366/1737748/1737748_WxH.jpg",
"is_extend": null,
"id": 206569366
},
{
"type": "Shopping",
"coordinate": [
13.412396,
52.522513000000004
],
"sub_poi_type": "ShoppingMall",
"name": "Alexanderplatz",
"image_url": "https://d2xf5gjipzd8cd.cloudfront.net/POI/207971440/2870212/2870212_WxH.jpg",
"is_extend": null,
"id": 207971440
}
],
"discountAnalysis": {
"couponHotels": [],
"couponRanks": [],
"couponAmounts": [],
"discountPercentage": null,
"couponType": null,
"hasCugDeal": false
},
"outBoundIndex": -1,
"partners": [
"Booking.com",
"Trip.com",
"Hotels.com",
"Hyatt",
"IHG"
],
"requestId": "a291aaaf-a27a-424d-8473-d0065fc3e79d",
"searchByCurrentLocation": false,
"context": {
"completionPercentage": 100,
"status": "complete",
"searchId": "2ac8530ee8eb3378b229b5591e763c1eb5f8e004217af51ab2576cb4b9217b0f"
}
}
}
Search car rentals
Return available car rentals.
Example API Request:
https://app.goflightlabs.com/search-rent-a-car?access_key=YOUR_ACCESS_KEY&pickupId=27547053&pickupDate=2023-06-06&pickupTime=10:30&returnDate=2023-06-11&returnTime=13:00
API request example with search parameter
https://app.goflightlabs.com/search-rent-a-car?access_key=YOUR_ACCESS_KEY&pickupId=27547053&pickupDate=2023-06-06&pickupTime=10:30&returnDate=2023-06-11&returnTime=13:00
HTTP GET Request Parameters:
Object | Description |
---|---|
access_key |
[Required] Your API access key, which can be found in your acccount dashboard. |
pickupId |
[Required] pickup location, location id - it can be obtained via get-location-data. |
pickupDate |
[Required] pickup date, format YYYY-MM-DD. |
pickupTime |
[Required] pickup time, format HH:mm. |
returnDate |
[Required] return date, format YYYY-MM-DD. |
returnTime |
[Required] return time, format HH:mm. |
returnId |
[Optional] return location, location id - it can be obtained via get-location-data - if omitted, car is returned to pickup location. |
driverAge |
[Optional] enter if the driver is less than 25 or over 75 years old. |
currency |
[Optional] currency of hotel prices, default: EUR. |
Examples
PHP cURL
$queryString = http_build_query([
"access_key" => "YOUR_ACCESS_KEY"
]);
$ch = curl_init(sprintf("%s?%s", "http://app.goflightlabs.com/flights", $queryString));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$json = curl_exec($ch);
curl_close($ch);
$api_result = json_decode($json, true);
return $api_result;
Python
import requests
params = {
'access_key': 'YOUR_ACCESS_KEY'
}
api_result = requests.get('https://app.goflightlabs.com/flights', params)
api_response = api_result.json()