Kiwi Com Scraper

ENDPOINTS
GET/prices/map

Price Map

Get the cheapest fare to up to 25 cities inside a map box from one origin: ranked, with city details and coordinates.

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

Map box to price, as sw_lat,sw_lng,ne_lat,ne_lng (south-west corner, then north-east corner). Kiwi.com returns up to 25 cities per box, so split a large area into tiles for more.

Default: the whole world

Example: 35,-10,60,30 (Europe)

Earliest departure date as YYYY-MM-DD.

Default: tomorrow

Latest departure date as YYYY-MM-DD, at most 365 days after date_from.

Default: 30 days after date_from

Round trips: earliest return date as YYYY-MM-DD. Without a return window, nights_min or return_anytime, prices are one-way.

Round trips: latest return date as YYYY-MM-DD, with return_from.

Default: 30 days after return_from

Round trips, instead of return dates: shortest stay in nights.

Allowed values: 0-365

Round trips: longest stay in nights.

Default: nights_min

Allowed values: 0-365

Set true for round-trip prices with any return date.

Default: false

Allowed values: true, false

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"
    }
  },
  "trip_type": "one_way",
  "date_from": "2026-11-11",
  "date_to": "2026-12-11",
  "return_from": null,
  "return_to": null,
  "nights": null,
  "is_return_anytime": false,
  "bounds": {
    "sw_lat": -90.0,
    "sw_lng": -180.0,
    "ne_lat": 90.0,
    "ne_lng": 180.0
  },
  "passengers": {
    "adults": 1,
    "children": 0,
    "infants": 0,
    "hand_bags": 0,
    "checked_bags": 0,
    "cabin_class": "economy"
  },
  "currency": "USD",
  "count": 25,
  "destinations": [
    {
      "city": {
        "id": "City:fort-lauderdale_fl_us",
        "name": "Fort Lauderdale",
        "code": "FLL",
        "slug": "fort-lauderdale-florida-united-states",
        "country": {
          "code": "US",
          "name": "United States"
        },
        "region": {
          "name": "Northern America",
          "slug": "northern-america"
        },
        "timezone": "America/New_York",
        "airports_count": 1,
        "tags": [
          "beach",
          "events",
          "family fun",
          "nightlife",
          "surfing"
        ],
        "gps": {
          "lat": 26.1224386,
          "lng": -80.13731740000001
        }
      },
      "price": {
        "amount": 57,
        "currency": "USD"
      },
      "rank": 10
    },
    {
      "city": {
        "id": "City:atlanta_ga_us",
        "name": "Atlanta",
        "code": "ATL",
        "slug": "atlanta-georgia-united-states",
        "country": {
          "code": "US",
          "name": "United States"
        },
        "region": {
          "name": "Northern America",
          "slug": "northern-america"
        },
        "timezone": "America/New_York",
        "airports_count": 1,
        "tags": [
          "nightlife",
          "sightseeing",
          "sports"
        ],
        "gps": {
          "lat": 33.7489954,
          "lng": -84.3879824
        }
      },
      "price": {
        "amount": 95,
        "currency": "USD"
      },
      "rank": 6
    },
    {
      "city": {
        "id": "City:orlando_fl_us",
        "name": "Orlando",
        "code": "ORL",
        "slug": "orlando-florida-united-states",
        "country": {
          "code": "US",
          "name": "United States"
        },
        "region": {
          "name": "Northern America",
          "slug": "northern-america"
        },
        "timezone": "America/New_York",
        "airports_count": 2,
        "tags": [
          "activities",
          "family fun"
        ],
        "gps": {
          "lat": 28.538335499999995,
          "lng": -81.3792365
        }
      },
      "price": {
        "amount": 96,
        "currency": "USD"
      },
      "rank": 2
    },
    {
      "city": {
        "id": "City:aruba_aw",
        "name": "Aruba",
        "code": "AUA",
        "slug": "aruba-aruba",
        "country": {
          "code": "AW",
          "name": "Aruba"
        },
        "region": {
          "name": "Caribbean",
          "slug": "caribbean"
        },
        "timezone": "America/Puerto_Rico",
        "airports_count": 1,
        "tags": [
          "beach",
          "family fun"
        ],
        "gps": {
          "lat": 12.521109999999998,
          "lng": -69.968338
        }
      },
      "price": {
        "amount": 130,
        "currency": "USD"
      },
      "rank": 90
    },
    {
      "city": {
        "id": "City:west-palm-beach_fl_us",
        "name": "West Palm Beach",
        "code": "PBI",
        "slug": "west-palm-beach-florida-united-states",
        "country": {
          "code": "US",
          "name": "United States"
        },
        "region": {
          "name": "Northern America",
          "slug": "northern-america"
        },
        "timezone": "America/New_York",
        "airports_count": 1,
        "tags": [
          "activities",
          "beach",
          "nightlife"
        ],
        "gps": {
          "lat": 26.715342399999997,
          "lng": -80.0533746
        }
      },
      "price": {
        "amount": 153,
        "currency": "USD"
      },
      "rank": 142
    },
    {
      "city": {
        "id": "City:punta-cana_do",
        "name": "Punta Cana",
        "code": "PUJ",
        "slug": "punta-cana-dominican-republic",
        "country": {
          "code": "DO",
          "name": "Dominican Republic"
        },
        "region": {
          "name": "Caribbean",
          "slug": "caribbean"
        },
        "timezone": "America/Santo_Domingo",
        "airports_count": 1,
        "tags": [
          "diving&snorkeling",
          "sports"
        ],
        "gps": {
          "lat": 18.582010099999998,
          "lng": -68.40547289999999
        }
      },
      "price": {
        "amount": 149,
        "currency": "USD"
      },
      "rank": 62
    },
    {
      "city": {
        "id": "City:tampa_fl_us",
        "name": "Tampa",
        "code": "TPA",
        "slug": "tampa-florida-united-states",
        "country": {
          "code": "US",
          "name": "United States"
        },
        "region": {
          "name": "Northern America",
          "slug": "northern-america"
        },
        "timezone": "America/New_York",
        "airports_count": 2,
        "tags": [
          "family fun",
          "sightseeing"
        ],
        "gps": {
          "lat": 27.950574999999994,
          "lng": -82.4571776
        }
      },
      "price": {
        "amount": 131,
        "currency": "USD"
      },
      "rank": 16
    },
    {
      "city": {
        "id": "City:cancun_mx",
        "name": "Cancún",
        "code": "CUN",
        "slug": "cancun-mexico",
        "country": {
          "code": "MX",
          "name": "Mexico"
        },
        "region": {
          "name": "Central America",
          "slug": "central-america"
        },
        "timezone": "America/Cancun",
        "airports_count": 1,
        "tags": [
          "beach",
          "sightseeing"
        ],
        "gps": {
          "lat": 21.161908000000004,
          "lng": -86.8515279
        }
      },
      "price": {
        "amount": 173,
        "currency": "USD"
      },
      "rank": 11
    },
    {
      "city": {
        "id": "City:dallas_tx_us",
        "name": "Dallas",
        "code": "DFW",
        "slug": "dallas-texas-united-states",
        "country": {
          "code": "US",
          "name": "United States"
        },
        "region": {
          "name": "Northern America",
          "slug": "northern-america"
        },
        "timezone": "America/Chicago",
        "airports_count": 2,
        "tags": [
          "family fun",
          "nightlife",
          "sightseeing"
        ],
        "gps": {
          "lat": 32.7766642,
          "lng": -96.79698789999999
        }
      },
      "price": {
        "amount": 177,
        "currency": "USD"
      },
      "rank": 6
    },
    {
      "city": {
        "id": "City:santo-domingo_do",
        "name": "Santo Domingo",
        "code": "SDQ",
        "slug": "santo-domingo-dominican-republic",
        "country": {
          "code": "DO",
          "name": "Dominican Republic"
        },
        "region": {
          "name": "Caribbean",
          "slug": "caribbean"
        },
        "timezone": "America/Santo_Domingo",
        "airports_count": 2,
        "tags": [
          "activities",
          "beach",
          "family fun",
          "hidden gems",
          "nightlife"
        ],
        "gps": {
          "lat": 18.486057499999994,
          "lng": -69.93121169999999
        }
      },
      "price": {
        "amount": 181,
        "currency": "USD"
      },
      "rank": 56
    },
    {
      "city": {
        "id": "City:miami_fl_us",
        "name": "Miami",
        "code": "MIA",
        "slug": "miami-florida-united-states",
        "country": {
          "code": "US",
          "name": "United States"
        },
        "region": {
          "name": "Northern America",
          "slug": "northern-america"
        },
        "timezone": "America/New_York",
        "airports_count": 2,
        "tags": [
          "beach",
          "family fun",
          "sightseeing"
        ],
        "gps": {
          "lat": 25.7616798,
          "lng": -80.1917902
        }
      },
      "price": {
        "amount": 150,
        "currency": "USD"
      },
      "rank": 5
    },
    {
      "city": {
        "id": "City:las-vegas_nv_us",
        "name": "Las Vegas",
        "code": "LAS",
        "slug": "las-vegas-nevada-united-states",
        "country": {
          "code": "US",
          "name": "United States"
        },
        "region": {
          "name": "Northern America",
          "slug": "northern-america"
        },
        "timezone": "America/Los_Angeles",
        "airports_count": 1,
        "tags": [
          "famous cities",
          "food&drink",
          "music",
          "nightlife",
          "romance"
        ],
        "gps": {
          "lat": 36.1699412,
          "lng": -115.13982960000001
        }
      },
      "price": {
        "amount": 185,
        "currency": "USD"
      },
      "rank": 9
    },
    {
      "city": {
        "id": "City:san-juan_pr_pr",
        "name": "San Juan",
        "code": "SJU",
        "slug": "san-juan-puerto-rico-united-states",
        "country": {
          "code": "US",
          "name": "United States"
        },
        "region": {
          "name": "Caribbean",
          "slug": "caribbean"
        },
        "timezone": "America/Puerto_Rico",
        "airports_count": 2,
        "tags": [
          "culture",
          "music",
          "sightseeing"
        ],
        "gps": {
          "lat": 18.4655394,
          "lng": -66.1057355
        }
      },
      "price": {
        "amount": 215,
        "currency": "USD"
      },
      "rank": 32
    },
    {
      "city": {
        "id": "City:santiago-de-los-caballeros_do",
        "name": "Santiago de los Caballeros",
        "code": "STI",
        "slug": "santiago-de-los-caballeros-dominican-republic",
        "country": {
          "code": "DO",
          "name": "Dominican Republic"
        },
        "region": {
          "name": "Caribbean",
          "slug": "caribbean"
        },
        "timezone": "America/Santo_Domingo",
        "airports_count": 1,
        "tags": [
          "sightseeing"
        ],
        "gps": {
          "lat": 19.479196299999998,
          "lng": -70.6930568
        }
      },
      "price": {
        "amount": 229,
        "currency": "USD"
      },
      "rank": 173
    },
    {
      "city": {
        "id": "City:phoenix_az_us",
        "name": "Phoenix",
        "code": "PHX",
        "slug": "phoenix-arizona-united-states",
        "country": {
          "code": "US",
          "name": "United States"
        },
        "region": {
          "name": "Northern America",
          "slug": "northern-america"
        },
        "timezone": "America/Phoenix",
        "airports_count": 2,
        "tags": [
          "mountains",
          "sightseeing"
        ],
        "gps": {
          "lat": 33.4483771,
          "lng": -112.0740373
        }
      },
      "price": {
        "amount": 212,
        "currency": "USD"
      },
      "rank": 13
    },
    {
      "city": {
        "id": "City:los-angeles_ca_us",
        "name": "Los Angeles",
        "code": "LAX",
        "slug": "los-angeles-california-united-states",
        "country": {
          "code": "US",
          "name": "United States"
        },
        "region": {
          "name": "Northern America",
          "slug": "northern-america"
        },
        "timezone": "America/Los_Angeles",
        "airports_count": 1,
        "tags": [
          "activities",
          "beach",
          "family fun",
          "food&drink",
          "nightlife",
          "sightseeing"
        ],
        "gps": {
          "lat": 34.0522342,
          "lng": -118.2436849
        }
      },
      "price": {
        "amount": 237,
        "currency": "USD"
      },
      "rank": 1
    },
    {
      "city": {
        "id": "City:mexico-city_mx",
        "name": "Mexico City",
        "code": "MEX",
        "slug": "mexico-city-mexico",
        "country": {
          "code": "MX",
          "name": "Mexico"
        },
        "region": {
          "name": "Central America",
          "slug": "central-america"
        },
        "timezone": "America/Mexico_City",
        "airports_count": 2,
        "tags": [
          "adventure",
          "food&drink",
          "nightlife",
          "sightseeing"
        ],
        "gps": {
          "lat": 19.2464696,
          "lng": -99.1013498
        }
      },
      "price": {
        "amount": 249,
        "currency": "USD"
      },
      "rank": 0
    },
    {
      "city": {
        "id": "City:madrid_es",
        "name": "Madrid",
        "code": "MAD",
        "slug": "madrid-spain",
        "country": {
          "code": "ES",
          "name": "Spain"
        },
        "region": {
          "name": "Southern Europe",
          "slug": "southern-europe"
        },
        "timezone": "Europe/Madrid",
        "airports_count": 1,
        "tags": [
          "family fun",
          "famous cities",
          "nightlife",
          "romance",
          "sightseeing"
        ],
        "gps": {
          "lat": 40.4167754,
          "lng": -3.7037902
        }
      },
      "price": {
        "amount": 254,
        "currency": "USD"
      },
      "rank": 12
    },
    {
      "city": {
        "id": "City:london_gb",
        "name": "London",
        "code": "LON",
        "slug": "london-united-kingdom",
        "country": {
          "code": "GB",
          "name": "United Kingdom"
        },
        "region": {
          "name": "Northern Europe",
          "slug": "northern-europe"
        },
        "timezone": "Europe/London",
        "airports_count": 6,
        "tags": [
          "activities",
          "city break",
          "events",
          "famous cities",
          "sightseeing"
        ],
        "gps": {
          "lat": 51.5073509,
          "lng": -0.1277583
        }
      },
      "price": {
        "amount": 256,
        "currency": "USD"
      },
      "rank": 8
    },
    {
      "city": {
        "id": "City:san-francisco_ca_us",
        "name": "San Francisco",
        "code": "SFO",
        "slug": "san-francisco-california-united-states",
        "country": {
          "code": "US",
          "name": "United States"
        },
        "region": {
          "name": "Northern America",
          "slug": "northern-america"
        },
        "timezone": "America/Los_Angeles",
        "airports_count": 1,
        "tags": [
          "activities",
          "beach",
          "sightseeing"
        ],
        "gps": {
          "lat": 37.7749295,
          "lng": -122.41941550000001
        }
      },
      "price": {
        "amount": 263,
        "currency": "USD"
      },
      "rank": 4
    },
    {
      "city": {
        "id": "City:paris_fr",
        "name": "Paris",
        "code": "PAR",
        "slug": "paris-france",
        "country": {
          "code": "FR",
          "name": "France"
        },
        "region": {
          "name": "Western Europe",
          "slug": "western-europe"
        },
        "timezone": "Europe/Paris",
        "airports_count": 4,
        "tags": [
          "city break",
          "culture",
          "famous cities",
          "romance",
          "sightseeing"
        ],
        "gps": {
          "lat": 48.85661400000001,
          "lng": 2.3522219
        }
      },
      "price": {
        "amount": 256,
        "currency": "USD"
      },
      "rank": 17
    },
    {
      "city": {
        "id": "City:dubai_ae",
        "name": "Dubai",
        "code": "DXB",
        "slug": "dubai-united-arab-emirates",
        "country": {
          "code": "AE",
          "name": "United Arab Emirates"
        },
        "region": {
          "name": "Western Asia",
          "slug": "western-asia"
        },
        "timezone": "Asia/Dubai",
        "airports_count": 3,
        "tags": [
          "activities",
          "beach",
          "famous cities",
          "food&drink",
          "sightseeing"
        ],
        "gps": {
          "lat": 25.204849300000003,
          "lng": 55.2707828
        }
      },
      "price": {
        "amount": 378,
        "currency": "USD"
      },
      "rank": 25
    },
    {
      "city": {
        "id": "City:tel-aviv_il",
        "name": "Tel Aviv",
        "code": "TLV",
        "slug": "tel-aviv-israel",
        "country": {
          "code": "IL",
          "name": "Israel"
        },
        "region": {
          "name": "Western Asia",
          "slug": "western-asia"
        },
        "timezone": "Asia/Jerusalem",
        "airports_count": 1,
        "tags": [
          "famous cities",
          "sightseeing"
        ],
        "gps": {
          "lat": 32.0852999,
          "lng": 34.7817676
        }
      },
      "price": {
        "amount": 441,
        "currency": "USD"
      },
      "rank": 19
    },
    {
      "city": {
        "id": "City:tokyo_jp",
        "name": "Tokyo",
        "code": "TYO",
        "slug": "tokyo-japan",
        "country": {
          "code": "JP",
          "name": "Japan"
        },
        "region": {
          "name": "Eastern Asia",
          "slug": "eastern-asia"
        },
        "timezone": "Asia/Tokyo",
        "airports_count": 2,
        "tags": [
          "activities",
          "family fun",
          "famous cities"
        ],
        "gps": {
          "lat": 35.6894875,
          "lng": 139.6917064
        }
      },
      "price": {
        "amount": 546,
        "currency": "USD"
      },
      "rank": 5
    },
    {
      "city": {
        "id": "City:mumbai_in",
        "name": "Mumbai",
        "code": "BOM",
        "slug": "mumbai-india",
        "country": {
          "code": "IN",
          "name": "India"
        },
        "region": {
          "name": "Southern Asia",
          "slug": "southern-asia"
        },
        "timezone": "Asia/Kolkata",
        "airports_count": 1,
        "tags": [
          "family fun",
          "nightlife"
        ],
        "gps": {
          "lat": 19.0759837,
          "lng": 72.8776559
        }
      },
      "price": {
        "amount": 599,
        "currency": "USD"
      },
      "rank": 35
    }
  ]
}