Search itineraries
search_itinerariesRead-onlyIdempotent
Use this when someone describes the trip they want, such as "romantic weekend in October", "museums with kids", or "Christmas markets", and needs matching public itineraries across cities. Ranks by the words they used, who it is for, and season fit. Pass a city to stay in one city. Do not use it to create or save a trip; it only reads published guides.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City name or WonderKit city key, such as "Paris" or "paris-france". | |
| limit | No | How many results to return, up to 8. | |
| month | No | Travel month, 1-12. Boosts plans whose peak months include it. Wins over season. | |
| query | No | What they want, in their words, such as "romantic weekend", "museums with kids", or "fall foliage". Plurals match singulars. | |
| shape | No | day-plan for a day-by-day plan, places-guide for a themed list of places. | |
| season | No | Season they are travelling in. "now" means the current month. Northern-hemisphere seasons. | |
| audience | No | Who the plan is for: families, friends, or couples. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | ||
| hint | No | ||
| note | Yes | Read-only reminder; not user content | |
| found | No | false when the lookup did not resolve | |
| reason | No | unknown_city, region_not_city, no_city_guide, no_itineraries_for_city, ambiguous_city, no_published_guide, no_matches, unknown_itinerary, lookup_failed, … | |
| region | No | The state, country, or area the city ask was read as | |
| cityKey | No | ||
| matches | No | Candidate cities when the name is ambiguous | |
| nearest | No | Covered cities in or near the asked-for area. Not the city that was asked for | |
| planUrl | No | Guest planner link for the destination as asked; it plans any city | |
| rankedFor | No | The month or season used for the season-fit ranking | |
| truncated | No | ||
| itineraries | No | Best match first | |
| suggestions | No | Near-miss spellings, or same-name cities elsewhere, when the name is unknown | |
| itinerariesUrl | No | WonderKit itineraries for this city | |
| planDescription | No | One line saying what planUrl opens |