Adónde

Add one item to one day through the same placing code as place_picks. Give a menu id, or a name to match against this trip's menu. Existing picks on that date stay.

add_stop

The candidate menu for a trip: real tours (bookable), sights, free ideas and food, each with an id, rating, price and duration, plus a rules block to follow when picking. Pick only by these ids and pass them to place_picks.

get_menu

Guest trips live 7 days. Give the traveller's email and we send a link; when they open it the trip moves into their Adonde account. If they connected their Adonde account it is already theirs and this says so.

keep_trip

Fallback when you do not want to choose: our AI picks from the same menu under the same rules and places the days. Runs in the background; call get_trip to read progress. Uses the traveller's AI allowance.

build_trip

The trips belonging to this connection (the signed-in account, or this guest session), newest first.

list_trips

Put chosen menu items on specific days. Every id is checked against this trip's menu (unknown ids are refused by name), tours are checked against the operator's published schedule, and our packer sets the clock. Replaces earlier picks on the dates you send. Returns the placed days and anything dropped, with the reason.

place_picks

The trip as it stands: days and stops in order, any bookings and documents on file, build progress, and links.

get_trip

Flights between two airports (IATA codes), cheapest first, top 6. Omit return for one way. total_minutes is the whole itinerary, both directions when a return is given; outbound_minutes and return_minutes are each direction when the fare states them. Each flight's book_link opens the Adonde flight search for those airports and dates and that fare's booking page when it is still offered.

search_flights

Real bookable hotels for a city and dates, top 10: nearest the place asked for first (distance_km is from its centre), then guest score weighted by review count, then price, with the whole-stay price. A stay needs at least one night: check_out must be after check_in. Each stay's book_link opens THAT hotel in the Adonde app (or on the web) on its room list for those dates; nothing is booked by searching.

search_stays

Bookable tours and experiences for a city, best first, top 8. With a date, tours the operator does not run that day are left out and departure times are shown. Each tour's book_link opens that tour in the Adonde app (or on the web) for the date given.

search_tours