Kiwi Com Scraper

ENDPOINTS
GET/prices/table

Round-Trip Price for Dates

Get the round-trip price for one departure and return date pair, 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

Departure date as YYYY-MM-DD (today or later).

Default: tomorrow

Return date as YYYY-MM-DD, on or after date.

Default: a week after date

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": "2026-11-11",
  "return_date": "2026-11-18",
  "passengers": {
    "adults": 1,
    "children": 0,
    "infants": 0,
    "hand_bags": 0,
    "checked_bags": 0,
    "cabin_class": "economy"
  },
  "currency": "USD",
  "legend": {
    "cheap_below": {
      "amount": 0,
      "currency": "USD"
    },
    "average_below": {
      "amount": 0,
      "currency": "USD"
    },
    "expensive_above": {
      "amount": 0,
      "currency": "USD"
    }
  },
  "count": 1,
  "prices": [
    {
      "date": "2026-11-11",
      "return_date": "2026-11-18",
      "price": {
        "amount": 873,
        "currency": "USD"
      },
      "rating": "average"
    }
  ]
}