Airpremia APIairpremia.com ↗

Search for the lowest available fares across Air Premia flight routes and discover current promotions to find the best deals on your next flight. Browse real-time pricing for specific sectors and stay updated on limited-time offers to maximize your savings.

This API takes change requests — .

Endpoint health

monitored

get_sector_fares

list_promotions

Checks pendingself-healing

Endpoints

Updated

4h ago

This call costs1 credit / call— charged only on success

Try it

adults

Number of adult passengers.

origin

3-letter IATA airport code for departure (e.g. ICN, LAX, NRT).

infants

Number of infant passengers.

children

Number of child passengers.

end_date

End date for fare search in YYYY-MM-DD format. Defaults to 57 days from today.

trip_type

Trip type for fare lookup.

begin_date

Start date for fare search in YYYY-MM-DD format. Must be today or later. Defaults to today.

destination

3-letter IATA airport code for arrival (e.g. LAX, NRT, HKG, SFO, EWR, HNL, BKK, IAD).

→ api.parse.bot/scraper/2b9336e1-2c30-459b-819c-5168290ff518/<endpoint>

Ready to send

Fill in the parameters and hit sign in to send to see live response data here.

Call it over HTTPgrab a free API key at signup

curl -X GET 'https://api.parse.bot/scraper/2b9336e1-2c30-459b-819c-5168290ff518/get_sector_fares?adults=1&origin=ICN&infants=0&children=0&end_date=2026-09-30&trip_type=OW&begin_date=2026-08-04&destination=LAX' \
  -H 'X-API-Key: $PARSE_API_KEY'

Python SDK · recommended

Typed, relational, agent-ready

A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.

Fully typed · autocompletes
Objects link to objects
Typed errors & pagination

Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:

uv add parse-sdk
uv run parse init
uv run parse add --marketplace airpremia-com-api

uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.

"""Walkthrough: Air Premia SDK — bounded, re-runnable; every call capped."""
from parse_apis.airpremia_com_api import AirPremia, TripType, InvalidInput

client = AirPremia()

# Search lowest fares for ICN → LAX sector
calendar = client.fare_calendars.search(origin="ICN", destination="LAX", trip_type=TripType.ONE_WAY)
for route in calendar.results[:3]:
    for day in route.daily_fares[:3]:
        if day.fares:
            print(day.date, day.fares[0].total_fare, day.fares[0].cabin_class)

# Browse current promotions
for promo in client.promotions.list(limit=3):
    print(promo.id, promo.name, promo.is_in_progress)

# Typed error handling
try:
    client.fare_calendars.search(origin="ZZZ", destination="LAX")
except InvalidInput as e:
    print("invalid input:", e)

print("exercised: fare_calendars.search, promotions.list")

All endpoints · 2 totalmissing one? ·

Retrieve the lowest daily fare calendar for a given Air Premia route (origin-destination pair) over a date range. Returns per-day availability with fares broken down by cabin class (Economy and Premium Economy), including base fare, taxes, and total. Dates with no availability are marked as sold out. The API supports a maximum date span of approximately two months from today.

Input

Param	Type	Description
adults	string	Number of adult passengers.
origin	string	3-letter IATA airport code for departure (e.g. ICN, LAX, NRT).
infants	string	Number of infant passengers.
children	string	Number of child passengers.
end_date	string	End date for fare search in YYYY-MM-DD format. Defaults to 57 days from today.
trip_type	string	Trip type for fare lookup.
begin_date	string	Start date for fare search in YYYY-MM-DD format. Must be today or later. Defaults to today.
destination	string	3-letter IATA airport code for arrival (e.g. LAX, NRT, HKG, SFO, EWR, HNL, BKK, IAD).

Response

{
  "type": "object",
  "fields": {
    "origin": "string — departure airport code",
    "results": "array of route fare results with daily_fares",
    "end_date": "string — end date of the fare calendar",
    "trip_type": "string — OW or RT",
    "begin_date": "string — start date of the fare calendar",
    "destination": "string — arrival airport code"
  },
  "sample": {
    "data": {
      "origin": "ICN",
      "results": [
        {
          "origin": "ICN",
          "daily_fares": [
            {
              "date": "2026-08-04",
              "fares": [],
              "sold_out": true,
              "no_flights": false
            },
            {
              "date": "2026-08-05",
              "fares": [
                {
                  "base_fare": 1625000,
                  "total_fare": 1875600,
                  "cabin_class": "EY",
                  "product_class": "YS",
                  "taxes_and_fees": 250600,
                  "available_count": 1
                },
                {
                  "base_fare": 2015000,
                  "total_fare": 2265600,
                  "cabin_class": "PE",
                  "product_class": "PS",
                  "taxes_and_fees": 250600,
                  "available_count": 4
                }
              ],
              "sold_out": false,
              "no_flights": false
            }
          ],
          "destination": "LAX"
        }
      ],
      "end_date": "2026-09-30",
      "trip_type": "OW",
      "begin_date": "2026-08-04",
      "destination": "LAX"
    },
    "status": "success"
  }
}

About the Airpremia API

The Airpremia API on Parse exposes 2 endpoints for the publicly available data on airpremia.com. Calls return JSON over HTTPS and are billed per successful response.

Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.