kayak.com APIkayak.com ↗
Access Kayak flight price calendars (~300 days), nearby airport lookups, and popular destination suggestions via a simple REST API.
curl -X GET 'https://api.parse.bot/scraper/4e57f69c-c489-4b22-9b45-5f4d0c360e05/get_price_calendar?origin=WAS&trip_type=oneWay&destination=LAX' \ -H 'X-API-Key: $PARSE_API_KEY'
Get flight price prediction calendar for a route. Returns approximately 300 days of average prices with color-coded price levels (green=cheap, orange=moderate, red=expensive) to help find the cheapest travel dates.
| Param | Type | Description |
|---|---|---|
| originrequired | string | Origin airport or city code (e.g., WAS, JFK, LAX) |
| trip_type | string | Trip type: 'roundTrip' or 'oneWay' |
| destinationrequired | string | Destination airport or city code (e.g., LAX, MIA, LHR) |
{
"type": "object",
"fields": {
"origin": "string - origin airport code",
"currency": "string - currency code for prices",
"trip_type": "string - trip type used for the query",
"destination": "string - destination airport code",
"predictions": "array of objects with date, avg_price, and price_level (green/orange/red)",
"total_dates": "integer - number of dates with predictions"
},
"sample": {
"data": {
"origin": "WAS",
"currency": "USD",
"trip_type": "roundTrip",
"destination": "LAX",
"predictions": [
{
"date": "2026-05-15",
"avg_price": 445.65,
"price_level": "red"
},
{
"date": "2026-05-16",
"avg_price": 401.38,
"price_level": "orange"
},
{
"date": "2026-05-17",
"avg_price": 493.27,
"price_level": "red"
}
],
"total_dates": 301
},
"status": "success"
}
}About the kayak.com API
The Kayak API exposes 3 endpoints covering flight price prediction calendars, nearby airport discovery, and popular destination lookups. The get_price_calendar endpoint returns up to ~300 days of average prices for any origin-destination pair, with each date tagged by a color-coded price level (green, orange, or red) so developers can quickly surface the cheapest travel windows without parsing raw fare data.
Price Calendar
The get_price_calendar endpoint accepts an origin and destination airport or city code (e.g., JFK, LHR) along with an optional trip_type of roundTrip or oneWay. It returns a predictions array where each object contains a date, an avg_price in the response's currency, and a price_level string — green for cheap dates, orange for moderate, and red for expensive. The total_dates field tells you exactly how many forecast dates are included, typically around 300.
Nearby Airports
The get_nearby_airports endpoint takes a single code parameter and returns an airports array. Each airport object includes code, name, city, display_name, full_display, distance_miles, popularity, and an is_nearby boolean. The total field gives the count of results. This is useful for building flexible search UIs where travelers might consider flying into or out of an alternative hub to save money.
Popular Destinations
The get_destinations endpoint accepts an origin airport code and an optional limit (up to 50). It returns a destinations array where each item includes airport_code, display_name, city, country, country_code, region, latitude, and longitude. The total field reflects the number of results returned. Geographic coordinates let you plot destinations on a map or calculate distances client-side.
- Build a fare calendar widget that highlights the cheapest departure dates using
price_levelcolor codes. - Suggest alternative departure airports to users based on
distance_milesfrom their primary airport. - Power a destination discovery feature showing popular routes from any origin with geographic coordinates for map rendering.
- Alert users via a price-tracking tool when
avg_pricefor a given date drops to agreenprice level. - Generate flexible date travel recommendations by scanning ~300 days of
predictionsfor low-cost windows. - Pre-populate airport search dropdowns with nearby alternatives ranked by
popularity.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Kayak have an official developer API?+
What does `price_level` in the price calendar mean, and how granular is the pricing data?+
predictions array carries a price_level of green (cheap), orange (moderate), or red (expensive), alongside an avg_price numeric value in the currency returned by the query. The data covers approximately 300 future dates per route. Prices are averages, not guaranteed fares, and do not include a breakdown by airline or cabin class.Does the API return live fare quotes or bookable itineraries?+
get_price_calendar, airport proximity data via get_nearby_airports, and destination metadata via get_destinations. You can fork this API on Parse and revise it to add an endpoint targeting real-time fare search results.Can I filter the price calendar by airline or number of stops?+
get_price_calendar endpoint does not expose airline, stop count, or flight duration filters. Inputs are limited to origin, destination, and trip_type. You can fork the API on Parse and revise it to add stop-count or carrier filtering if those fields become available in the source data.How fresh is the price calendar data?+
predictions objects indicating when a specific average was computed.