search
Search everything by name
Search venues, travel destinations and places inside destinations by name or keyword. Returns results of id, title and url; pass an id to fetch for the full page. For filters use search_venues, search_menus or destination_listings.
Parametersqueryrequired
fetch
Fetch a search result
Read a search result's full page: a restaurant's menu, dietary options, hours and events, or a destination's. Returns Markdown text with its citable url. Ids look like "venue:acme-bistro", "venue:acme-bistro:menu", "destination:los-cabos" or "listing:los-cabos:1234".
Parametersidrequired
search_venues
Search venues
Find restaurants and bars by city, cuisine, opening time or features. Filters are HARD, prefer_* and avoid are SOFT (rank only), and query is a name, a keyword or a short description. Each result has slug, capabilities, open_now and distance_km; a place inside a destination is not here, use destination_listings.
Parametersatcitynearavoidlimitquerycursorfacetscuisineopen_onopen_nowradius_km+6 more
List the cities that have published restaurants and bars. Travel destinations such as Los Cabos are not cities here; read one with destination_overview.
Parameterslimitcursor
send_feedback
Send feedback to Yenta
Send Yenta a report: data that is missing or looks wrong, a tool that was hard to use, or anything else. Stored for Yenta's team and never shown publicly; the answer carries a reference. Leave out personal details.
Parameterscitykindrequiredtoolmodelclientmessagerequiredpurposesubject
venue_profile
Venue profile by name or slug
Get a venue's hours, address, map, phone, booking and links by name or slug, e.g. venue="Acme Bistro". It also holds cuisine, attributes, menu_summary and capabilities (the other venue_* tools that answer for it); hours_summary is ready to quote.
Parameterscityvenuerequired
venue_faq
Venue FAQ by name
Answer a question about a named venue from its published FAQs; omit query to read them all. If not available, check the capabilities venue_profile lists; the venue may not publish this.
Parameterscitylimitqueryvenuerequiredcursor
venue_events
Search a venue's events by name
Find what is on at a named venue: dated events from its local today onwards. Filter by exact event_type if you know it. If not available, check the capabilities venue_profile lists; the venue may not publish this.
Parameterscitylimitvenuerequiredcursorto_datefrom_dateevent_type
destination_overview
Destination overview by name or slug
One call answers what a destination offers and what's on: counts, a few places, next events and guide topics. It counts offers, seasonality and FAQs too, and names the categories and areas listings, events and offers filter by. preview.complete is false when destination_listings / destination_events hold more.
Parametersdestinationrequired
destination_listings
Search a destination's listings by name
Find places to stay, eat and visit in a named destination by text, category, area or tags. Every query word matches, in any order; each business appears once (also_listed_as) with a snippet and map_url, so call it again with listing_id for the full text. An unknown filter value's reason lists the valid ones.
Parametersareatagslimitquerycursorcategorylanguageradius_kmlisting_iddestinationrequirednear_listing_id
destination_events
Search a destination's events by name
Find what is on in a named destination: events from today onwards. A recurring event's dates are its series span, so read its recurrence. Results carry booking_url, the partner's booking page when present, and canonical_url, the destination's page.
Parametersarealimitquerycursorto_datecategoryfrom_datedestinationrequired
destination_guide
Destination guides by name
Read a named destination's travel guides: weather, getting here, transport, entry requirements, safety and more. Pass topic (from destination_overview guide_topics) to read one subject; page with cursor.
Parameterslimitquerytopiccursordestinationrequired
destination_faq
Destination FAQ by name
Answer a question about a named destination from its published FAQs; omit query to read them all.
Parameterslimitquerycursordestinationrequired
destination_offers
Search a destination's offers by name
Find a named destination's current deals and packages, with the partner booking link. Only offers valid on valid_on (today by default) are returned. Results carry booking_url, the partner's booking page when present, and canonical_url, the destination's page.
Parametersarealimitcursorcategoryvalid_ondestinationrequired
destination_seasonality
Destination seasonality by name
Get a named destination's best time to visit, weather and wildlife seasons (e.g. whale watching), month by month.
Parametersmonthinterestdestinationrequired