Earth Roulette

Cheapest one-way fares seen on one route. Without month: the cheapest fare in each of the coming months, to find the cheapest time to go. With month: the cheapest fare for each day of that month. Prices are the lowest fares observed, not live quotes: say "from". Each fare has a booking_url for its date.

route_prices

List the cheapest one-way fares seen recently from an origin airport or city to anywhere, cheapest first. Prices are the lowest fares observed for the month, not live quotes: say "from" when you show them. Each result has a booking_url and, when known, the destination place with its page url.

cheap_flights

Full profile of one place: a summary and longer description, activity ratings (1-10), cost score, average temperature by month, the current temperature, common questions with answers, how to get there, and the IATA code of the nearest airport for route_prices or cheap_flights. Use it after spin_destination or cheap_flights, or when the user names a place.

get_destination

IATA codes for a city or airport name, with nearby airports and their distance in km. Use it to get the origin or destination code for cheap_flights and route_prices.

find_airport

Well-rated hotels in a place with guest rating (out of 10), review count, a from-price per night, and a booking_url on Booking.com. Prices are from an earlier check and can change: say "from".

hotels

Pick truly random travel destinations (cities and regions) that match optional filters. Use it to break indecision or to suggest places beyond the obvious famous cities. Each place has cost_score (1-10, higher means cheaper), average temperature in °C by month (keys 1-12), a page url, and a hotels_url. Every call draws new places, so call it again for another spin.

spin_destination

Bookable tours and activities in a place, with a short description, a from-price, a rating out of 5 when known, and a booking_url. Prices can change on the booking site.

things_to_do