Kiwi Com Scraper

ENDPOINTS
GET/prices/return-calendar

Round-Trip Price Calendar

Get the cheapest round-trip fare for every departure day at a set stay length, rated cheap, average or expensive.

QUERY PARAMS

Departure airport, city or country. Pass an IATA airport or city code, a Kiwi place id, a kiwi.com place slug (or a kiwi.com link containing it) or a plain place name; the form is detected for you, so no lookup call is needed first.

Examples:

  • Airport: JFK
  • City (all its airports): NYC
  • Kiwi id: City:new-york-city_ny_us
  • Slug: new-york-city-new-york-united-states
  • Name: new york

Arrival airport, city or country. Pass an IATA airport or city code, a Kiwi place id, a kiwi.com place slug (or a kiwi.com link containing it) or a plain place name; the form is detected for you, so no lookup call is needed first.

Examples:

  • Airport: JFK
  • City (all its airports): NYC
  • Kiwi id: City:new-york-city_ny_us
  • Slug: new-york-city-new-york-united-states
  • Name: new york

First departure date to price, as YYYY-MM-DD.

Default: today

Last departure date to price, as YYYY-MM-DD, at most 92 days after date_from.

Default: 30 days after date_from

Shortest stay in nights.

Default: 7

Allowed values: 0-365

Longest stay in nights.

Default: nights_min

Allowed values: 0-365

Adult passengers.

Default: 1

Allowed values: 1-9

Child passengers aged 2-11.

Default: 0

Allowed values: 0-8

Infants under 2 travelling on a lap, at most one per adult.

Default: 0

Allowed values: 0-4

Cabin class to search.

Default: economy

Allowed values: economy, premium_economy, business, first

Cabin bags per passenger to price in. Fares that charge for a cabin bag include that fee in price.

Default: 0

Allowed values: 0-1

Checked bags per passenger to price in. Fares that charge for checked bags include those fees in price.

Default: 0

Allowed values: 0-2

3-letter currency for every price.

Default: USD

Allowed values: any ISO 4217 code (USD, EUR, GBP, CAD, INR, ...)

Language of airport, city and country names.

Default: en

Allowed values: any ISO 639-1 code (en, es, de, fr, it, ...)

2-letter country of the Kiwi.com storefront whose fares and booking rules apply.

Default: US

Allowed values: any ISO 3166-1 alpha-2 code (US, GB, CA, DE, IN, ...)

{
  "origin": {
    "id": "City:new-york-city_ny_us",
    "type": "city",
    "name": "New York",
    "code": "NYC",
    "slug": "new-york-city-new-york-united-states",
    "city": null,
    "country": {
      "code": "US",
      "name": "United States"
    }
  },
  "destination": {
    "id": "City:london_gb",
    "type": "city",
    "name": "London",
    "code": "LON",
    "slug": "london-united-kingdom",
    "city": null,
    "country": {
      "code": "GB",
      "name": "United Kingdom"
    }
  },
  "trip_type": "round_trip",
  "date_from": "2026-11-10",
  "date_to": "2026-12-10",
  "nights": {
    "min": 7,
    "max": 7
  },
  "passengers": {
    "adults": 1,
    "children": 0,
    "infants": 0,
    "hand_bags": 0,
    "checked_bags": 0,
    "cabin_class": "economy"
  },
  "currency": "USD",
  "legend": {
    "cheap_below": {
      "amount": 640,
      "currency": "USD"
    },
    "average_below": {
      "amount": 770,
      "currency": "USD"
    },
    "expensive_above": {
      "amount": 919,
      "currency": "USD"
    }
  },
  "count": 31,
  "days": [
    {
      "date": "2026-11-10",
      "price": {
        "amount": 879,
        "currency": "USD"
      },
      "rating": "average"
    },
    {
      "date": "2026-11-11",
      "price": {
        "amount": 873,
        "currency": "USD"
      },
      "rating": "average"
    },
    {
      "date": "2026-11-12",
      "price": {
        "amount": 919,
        "currency": "USD"
      },
      "rating": "average"
    },
    {
      "date": "2026-11-13",
      "price": {
        "amount": 900,
        "currency": "USD"
      },
      "rating": "average"
    },
    {
      "date": "2026-11-14",
      "price": {
        "amount": 904,
        "currency": "USD"
      },
      "rating": "average"
    },
    {
      "date": "2026-11-15",
      "price": {
        "amount": 868,
        "currency": "USD"
      },
      "rating": "average"
    },
    {
      "date": "2026-11-16",
      "price": {
        "amount": 814,
        "currency": "USD"
      },
      "rating": "average"
    },
    {
      "date": "2026-11-17",
      "price": {
        "amount": 900,
        "currency": "USD"
      },
      "rating": "average"
    },
    {
      "date": "2026-11-18",
      "price": {
        "amount": 810,
        "currency": "USD"
      },
      "rating": "average"
    },
    {
      "date": "2026-11-19",
      "price": {
        "amount": 916,
        "currency": "USD"
      },
      "rating": "average"
    },
    {
      "date": "2026-11-20",
      "price": {
        "amount": 1055,
        "currency": "USD"
      },
      "rating": "expensive"
    },
    {
      "date": "2026-11-21",
      "price": {
        "amount": 1029,
        "currency": "USD"
      },
      "rating": "expensive"
    },
    {
      "date": "2026-11-22",
      "price": {
        "amount": 954,
        "currency": "USD"
      },
      "rating": "expensive"
    },
    {
      "date": "2026-11-23",
      "price": {
        "amount": 840,
        "currency": "USD"
      },
      "rating": "average"
    },
    {
      "date": "2026-11-24",
      "price": {
        "amount": 782,
        "currency": "USD"
      },
      "rating": "average"
    },
    {
      "date": "2026-11-25",
      "price": {
        "amount": 780,
        "currency": "USD"
      },
      "rating": "average"
    },
    {
      "date": "2026-11-26",
      "price": {
        "amount": 792,
        "currency": "USD"
      },
      "rating": "average"
    },
    {
      "date": "2026-11-27",
      "price": {
        "amount": 684,
        "currency": "USD"
      },
      "rating": "cheap"
    },
    {
      "date": "2026-11-28",
      "price": {
        "amount": 684,
        "currency": "USD"
      },
      "rating": "cheap"
    },
    {
      "date": "2026-11-29",
      "price": {
        "amount": 683,
        "currency": "USD"
      },
      "rating": "cheap"
    },
    {
      "date": "2026-11-30",
      "price": {
        "amount": 689,
        "currency": "USD"
      },
      "rating": "cheap"
    },
    {
      "date": "2026-12-01",
      "price": {
        "amount": 695,
        "currency": "USD"
      },
      "rating": "cheap"
    },
    {
      "date": "2026-12-02",
      "price": {
        "amount": 684,
        "currency": "USD"
      },
      "rating": "cheap"
    },
    {
      "date": "2026-12-03",
      "price": {
        "amount": 660,
        "currency": "USD"
      },
      "rating": "cheap"
    },
    {
      "date": "2026-12-04",
      "price": {
        "amount": 647,
        "currency": "USD"
      },
      "rating": "cheap"
    },
    {
      "date": "2026-12-05",
      "price": {
        "amount": 700,
        "currency": "USD"
      },
      "rating": "cheap"
    },
    {
      "date": "2026-12-06",
      "price": {
        "amount": 735,
        "currency": "USD"
      },
      "rating": "cheap"
    },
    {
      "date": "2026-12-07",
      "price": {
        "amount": 640,
        "currency": "USD"
      },
      "rating": "cheap"
    },
    {
      "date": "2026-12-08",
      "price": {
        "amount": 710,
        "currency": "USD"
      },
      "rating": "cheap"
    },
    {
      "date": "2026-12-09",
      "price": {
        "amount": 765,
        "currency": "USD"
      },
      "rating": "cheap"
    },
    {
      "date": "2026-12-10",
      "price": {
        "amount": 872,
        "currency": "USD"
      },
      "rating": "average"
    }
  ]
}