Price Checker API

The Price Checker API is a cache for GOL API, storing the flight`s prices. Allows to get price history and search lowest price in time period.

Authorization

Use header: Authorization: obtained-user-token

AUTHORIZATIONAPI Key

Key

Authorization

Value

<value>

POSTExact search

https://price-checker-api.cee-systems.com/exact

Get price for exact departure (date from) and arrival (date to). Search in GOL API and contains agency fees.

Input JSON attributes

name	description
origin	IATA destination, supports multiple, e.g. `PRG/VIE`
destination	IATA destination, supports multiple
flightType	`oneway` or `return`
departure	Date in format YYYY-MM-DD
arrival	Date in format YYYY-MM-DD, for return flight use `null` or `undefined`
maximumAgeMinutes	Number between `0` and `43200` (30 days)
golApiUrl	GOL API url
golApiUsername	GOL API username
golApiPassword	GOL API password
resultUrl	Your webhook url or `null` / `undefined`

Output JSON example

The result contains searchId to identify an asynchronise search result with a price

Plain Text

{
    "result": "Success",
    "context": {
        "searchId": "123456..."
    }
}

AUTHORIZATIONAPI Key

This request is using API Key from collectionPrice Checker API

HEADERS

Content-Type

application/json

Bodyraw

{
    "origin": "PRG",
    "destination": "LON",
    "flightType": "return",
    "departure": "2020-12-12",
    "arrival": "2020-12-14",
    "maximumAgeMinutes": 60,
    "golApiUrl": "https://golapi.golibe.com",
    "golApiUsername": "user",
    "golApiPassword": "pass",
    "resultUrl": "https://your-webhook.cz"
}

Example Request

curl

curl --location 'https://price-checker-api.cee-systems.com/exact' \
--header 'Content-Type: application/json' \
--data '{
    "origin": "PRG",
    "destination": "LON",
    "flightType": "return",
    "departure": "2020-12-12",
    "arrival": "2020-12-14",
    "maximumAgeMinutes": 60,
    "golApiUrl": "https://golapi.golibe.com",
    "golApiUsername": "user",
    "golApiPassword": "pass",
    "resultUrl": "https://your-webhook.cz"
}'

Example Response

No response body

This request doesn't return any response body

No response headers

This request doesn't return any response headers

GETExact search webhook

https://your-url.cz?searchId=123456&price=1000 CZK

The search result is send to resultUrl as GET method with parameters searchId and price

AUTHORIZATIONAPI Key

This request is using API Key from collectionPrice Checker API

PARAMS

searchId

123456

price

1000 CZK

Example Request

curl

curl --location 'https://your-url.cz?searchId=123456&price=1000%20CZK'

Example Response

No response body

This request doesn't return any response body

No response headers

This request doesn't return any response headers

POSTHistory

https://price-checker-api.cee-systems.com/history

Get price history for the flight.

Input JSON attributes

name	description
origin	IATA destination, supports multiple, e.g. `PRG/VIE`
destination	IATA destination, supports multiple
flightType	`oneway` or `return`
departure	Date in format YYYY-MM-DD
arrival	Date in format YYYY-MM-DD, for return flight use `null` or `undefined`
maxResults	Number between `0` and `1000`
maximumAgeMinutes	Number between `0` and `43200` (30 days)
maxResultsPerDay	Number between `1` and `1000`, default is `1`
maxTransfers	Number `0`, `1` or `2`, default is `2`

Increasing attribute maximumAgeMinutes has negative effect to response latency.

Output JSON example

The result contains searchId to identify an asynchronise search result with a price. If the price is not provided, search was done without any results.

Plain Text

{
    "result": "Success",
    "context": [
        {
            "created": "2020-01-01T11:57:00.000Z",
            "price": "500 CZK"
        },
        {
            "created": "2020-01-01T11:58:00.000Z"
        },
        {
            "created": "2020-01-01T11:59:00.000Z",
            "price": "600 CZK"
        }
      ]
}

AUTHORIZATIONAPI Key

This request is using API Key from collectionPrice Checker API

Bodyraw (json)

json

{
    "origin": "PRG",
    "destination": "LON",
    "flightType": "return",
    "departure": "2020-12-12",
    "arrival": "2020-12-14",
    "maxResults": 10,
    "maxResultsPerDay": 2,
    "maxTransfers": 1
}

Example Request

curl

curl --location -g '{{url}}/history?origin=PRG&destination=LON&flightType=return&departure=2019-07-01&arrival=2019-07-12'

Example Response

json

{
  "status": "done",
  "results": [
    {
      "created": "2019-07-12 12:00:00",
      "price": "8260 CZK"
    }
  ]
}

No response headers

This request doesn't return any response headers

POSTPeriod search

https://price-checker-api.cee-systems.com/period

Get flights in custom defined time period. Results are sorted by the lowest price.

Input JSON attributes

name	description
origin	IATA destination, supports multiple, e.g. `PRG/VIE`
destination	IATA destination, supports multiple
flightType	`oneway` or `return`
periodStart	Date in format YYYY-MM-DD
periodEnd	Date in format YYYY-MM-DD
maxResults	Number between `0` and `1000`
maxTransfers	Number `0`, `1` or `2`, defalut is `2`

The result contains searchId to identify an asynchronise search result with a price

AUTHORIZATIONAPI Key

This request is using API Key from collectionPrice Checker API

Bodyraw (json)

json

{
    "origin": "PRG",
    "destination": "LON",
    "flightType": "return",
    "periodStart": "2020-10-11",
    "periodEnd": "2020-12-12",
    "maxResults": 2,
    "maxTransfers": 2
}

Example Request

curl

curl --location -g '{{url}}/period' \
--header 'Content-Type: application/json' \
--data '{
    "origin": "PRG",
    "destination": "LON",
    "flightType": "return",
    "periodStart": "2020-10-11",
    "periodEnd": "2020-12-12",
    "maxResults": 2,
    "maxTransfers": 2
}'

Example Response

json

{
  "status": "Success",
  "results": [
    {
      "created": "2021-12-20 12:00:00",
      "price": "20582 CZK",
      "departure": "2021-12-20",
      "arrival": "2021-12-23",
      "detail": {
        "Module": "GALILEO",
        "FlightSegments": [
          {
            "Origin": "PRG",
            "CabinClass": "Unknown",
            "Destination": "IST",
            "DepartureTime": "2021-12-20T12:00:00+01:00",
            "Number": "1768",
            "Plane": "737",
            "OperatingCarrier": "TK",
            "MarketingCarrier": "TK",
            "SegmentGroup": 0,
            "ArrivalTime": "2021-12-20T15:40:00+03:00"
          },
          {
            "Origin": "IST",
            "CabinClass": "Unknown",
            "Destination": "JFK",
            "DepartureTime": "2021-12-20T18:20:00+03:00",
            "Number": "11",
            "Plane": "330",
            "OperatingCarrier": "TK",
            "MarketingCarrier": "TK",
            "SegmentGroup": 0,
            "ArrivalTime": "2021-12-20T21:55:00-05:00"
          },
          {
            "Origin": "JFK",
            "CabinClass": "Unknown",
            "Destination": "IST",
            "DepartureTime": "2021-12-22T12:50:00-05:00",
            "Number": "4",
            "Plane": "330",
            "OperatingCarrier": "TK",
            "MarketingCarrier": "TK",
            "SegmentGroup": 1,
            "ArrivalTime": "2021-12-23T05:40:00+03:00"
          },
          {
            "Origin": "IST",
            "CabinClass": "Unknown",
            "Destination": "PRG",
            "DepartureTime": "2021-12-23T09:20:00+03:00",
            "Number": "1767",
            "Plane": "32S",
            "OperatingCarrier": "TK",
            "MarketingCarrier": "TK",
            "SegmentGroup": 1,
            "ArrivalTime": "2021-12-23T11:05:00+01:00"
          }
        ],
        "Key": "PD01-FO01-FO10",
        "MaxTransfers": 1,
        "BaggageLimit": {
          "Quantity": "1 pc(s)",
          "Weight": "20 kg"
        }
      }
    }
  ]
}

No response headers

This request doesn't return any response headers