Find cheap multi-country trips
find_tripsRead-onlyIdempotent
Finds cheap trips through several cities and countries in Europe or Southeast Asia, strung from non-stop one-way fares seen in the last few days: you give a start city (or a home airport outside the region: the trip then starts with a flight from the nearest big airport we have fares from), a window for the first flight, how many places and nights in each, and a flight budget, and optionally the kinds of place (beaches, islands, capitals ...), countries to keep to or skip and cities per country; it picks the cities. Returns the cheapest three trips, each with its flights, fare ages, cabin-bag notes and a link to the trip on faredice.com.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | home: the last flight returns to the start city (with home, to the airport the trip flew in through). Default anywhere. | |
| from | No | Start city: a name ("Lisbon") or IATA city code ("LIS"), "anywhere" to start in any of the region's busiest cities, or a country ("anywhere in Germany", "Spain") to start in any of its cities. Needed unless home is given. | |
| home | No | The traveller's home airport when it is outside the region: a town ("Calgary", "London, Ontario") or IATA code ("YYC"). Trips then start with a flight in from the nearest big airport we have fares from (Toronto, New York, Sydney ...), usually with a stop, and from there it's the same trip. The budget covers that flight; getting from home to that airport isn't in the prices. With home, from is used only when we can't fly from that home. | |
| start | No | Earliest day for the first flight, YYYY-MM-DD. Fares cover about the next 90 days. Default: a week from today. | |
| until | No | Latest day for the first flight, YYYY-MM-DD. Default: two weeks after start. | |
| region | No | Where the trip goes. Default europe. | |
| cabin_bag | No | true: the traveller takes a cabin bag (the wheeled one for the overhead locker), so the budget and the ranking count each flight's usual price for one where we know it; a flight whose bag price we don't know counts €35, the dearest bag price we know, so the total is an estimate (see unpriced_cabin_bags). Default false: fares alone. | |
| countries | No | ISO country codes ("ES", "PT"): every stop is in one of these. | |
| passports | No | ISO country codes of the traveller's passports ("US", "IN"): countries that need a visa in advance are left out. | |
| visa_free | No | With passports: only countries that need no visa of any kind, leaving out e-visas, ETAs and visas on arrival as well as visas needed before flying. | |
| budget_eur | No | Most to spend on all the flights, in euros, for all the travellers together (up to 5,000 each). | |
| held_visas | No | Valid visas the traveller already holds, with passports: "schengen" opens the Schengen area (its days counted against 90 in any 180) and the countries outside it that admit Schengen visa holders; "uk" and "us" open the countries that admit holders of those. The traveller still checks the visa's own dates and entries. | |
| nights_max | No | Most nights in each place. | |
| nights_min | No | Fewest nights in each place. | |
| places_max | No | Most places to stay in. Default 12, any number. | |
| places_min | No | Fewest places to stay in. Default 4. | |
| travellers | No | How many adults travel together. Default 1. Every price in the answer, and the budget, is then for all of them. | |
| warm_min_c | No | Only places whose typical daytime high for the month of the stay is at least this many °C, from long-term weather station averages (a place without them is left out). For winter sun in Europe. | |
| then_region | No | With home: after region, fly on to this other region and home from there, in one trip (europe then southeast-asia, or the reverse). Three long flights: home into region, one across (from or to London or Paris), and home from then_region; each a separate ticket, all in the total and the budget. Homes: Vancouver or Los Angeles, or an airport within 1,000 km of them. The trip always ends home; places_min splits between the regions. A budget of about 2,000 euros fits most. | |
| kinds_of_place | No | Kinds of place, from our notes on each city: per kind, "only" (every stop is one), "none" (no stop is one) or at least n stops of it (1-4), e.g. {"beaches": 2, "capitals": "none"}. One kind can be "only". Ski counts only from December to mid-April, and only in Europe. The start and the return don't count as stops. | |
| skip_countries | No | ISO country codes to leave out of the trip. | |
| cities_per_country | No | Most cities in any one country. Default 1; 0 for any number (answers write it "any"). |