Route historical data range

Endpoints for accessing historical demand data between specific origin-destination pairs.

Get Route Demand History

get

https://api.zytlyn.comhttps://api.dev.zytlyn.com

/traveldemand/{product_dimension}/routes/history/{time_resolution}/{origin}/{destination}

Retrieves historical data for a specific flight route based on product dimension and time resolution.

This endpoint focuses on providing historical data for a specified route, identified by its origin and destination. The data is filtered by the given product dimension (e.g., search date or travel date) and the specified time resolution (e.g., weekly, monthly).

Parameters

• product_dimension: Specifies the type of date (search_date or travel_date) for which the historical data is retrieved.

• time_resolution: The granularity of the historical data, such as weekly or monthly.

• origin: The 3-letter IATA code representing the city of origin.

• destination: The 3-letter IATA code representing the city of destination.

Returns

• RouteHistoryResponse: A response object containing the historical data for the specified route.

Authorizations

APIKeyHeader

x-api-keystringRequired

Path parameters

product_dimensionstring · enumRequired

Defines the target product dimension for history and prediction data points.

Attributes

SEARCH : str Represents the 'search_date' dimension, indicating interest in the period when travelers are searching for their flights.

TRAVEL : str Represents the 'travel_date' dimension, indicating interest in the period when travelers will board their flights.

Possible values:

time_resolutionstring · enumRequired

Defines the granularity of time for predictions or historical data.

Attributes

MONTHLY : str Represents a monthly granularity, providing predictions or historical data aggregated on a monthly basis.

WEEKLY : str Represents a weekly granularity, offering predictions or historical data aggregated on a weekly basis.

Possible values:

originstring · min: 3 · max: 3RequiredPattern: [A-Z]{3}

destinationstring · min: 3 · max: 3RequiredPattern: [A-Z]{3}

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/traveldemand/{product_dimension}/routes/history/{time_resolution}/{origin}/{destination}

HTTPcURLJavaScriptPython

GET /traveldemand/{product_dimension}/routes/history/{time_resolution}/{origin}/{destination} HTTP/1.1
Host: api.zytlyn.com
x-api-key: YOUR_API_KEY
Accept: */*

{
  "query": {
    "product_dimension": "search_date",
    "time_resolution": "monthly"
  },
  "history": [
    {
      "target": {
        "origin": "text",
        "destination": "text"
      },
      "period": {
        "start": "2026-02-13",
        "end": "2026-02-13"
      },
      "strategic_insights": {
        "zytlyn_demand": 1,
        "year_over_2019_growth": 1,
        "year_over_year_growth": 1,
        "demand_to_realisation_ratio": 1,
        "realised_demand_length_of_stay": {
          "ANY_ADDITIONAL_PROPERTY": 1
        },
        "realised_demand_percentage_one_way": 1,
        "realised_demand_percentage_round_trip": 1,
        "demand_percentage_one_way": 1,
        "demand_percentage_round_trip": 1,
        "zytlyn_realised_demand": 1,
        "zytlyn_realised_demand_passengers": 1,
        "passenger_per_booking_ratio": 1,
        "cabin_class_distribution": {
          "ANY_ADDITIONAL_PROPERTY": 1
        },
        "realised_demand_multi_city": 1,
        "passenger_per_booking_ratio_multi_city": 1
      },
      "created_on": "2026-02-13T08:46:51.286Z"
    }
  ]
}