Just Travel

Search Google Places and return grounded place IDs and provider location facts.

find_places

Retrieve provider details for the exact provider and hotel ID returned by search.

get_hotel_details

Check date-specific room availability for the exact provider hotel ID.

get_hotel_rooms

Load a complete saved itinerary owned by the authenticated user.

get_saved_trip

Save an itinerary to the user's Just Travel trips when they ask to save it. Pass the itinerary_id from the latest create_itinerary call for that plan. If the plan has no itinerary_id yet, or the tool reports itinerary_not_found, call create_itinerary first and use the itinerary_id it returns. Saving the same itinerary_id again returns the trip already saved. The trip appears in the user's Just Travel trips with every day and place; share the returned trip_url so they can open it there.

save_trip

Search current flight offers. Pass IATA codes for origin and destination when you know them; for a place you are unsure of, pass its name and Just Travel resolves the airport (check resolved_route). Put every constraint the user states into the filter inputs (stops, layover length, connection city via/avoid_via, airline, departure time, duration, bags) instead of filtering the results yourself: filters run over every offer found, not only the ones returned. Each offer's route_summary lists its stops, connection airports and layover minutes. If matched_count is 0, say nothing matched rather than showing other offers. Preserve returned provider IDs and cache handles for follow-up calls.

search_flights

Search hotels and homes for bounded dates and occupancy. Put every preference the user states into the filter inputs instead of filtering the results yourself: stay_type ('homes' for apartments, Airbnb or a whole place), amenities, meal_plan, accessibility, nightly price, min_stars, min_review_score, near_latitude/near_longitude (from find_places, for a landmark or neighborhood), and review_theme for qualities guests describe, such as 'comfy beds' or 'quiet rooms'. Filters run over every stay found, not only the ones returned. A review_theme match carries review_quote, a real guest quote to cite. If matched_count is 0, say nothing matched rather than showing other stays. Partial provider results are identified as partial.

search_hotels

Call this whenever you present a day-by-day itinerary. It checks the plan you composed, orders and numbers the days, and holds it so it can be saved. Required: trip_name, destination, start_date, end_date and days, each day with a date and events that each have an event_type. If the user gave only a month, pick concrete dates and say so. Use place names and place_ids from find_places. Returns an itinerary_id. After showing the itinerary, ask whether the user wants changes, flight or hotel searches for these dates, or to save it to their Just Travel trips; call save_trip with the itinerary_id only when they ask to save. After any change, call this again for a new itinerary_id.

create_itinerary