Search events across all cities
search_across_citiesSearch upcoming travel-worthy events in every What's Up In city at once: where an artist, band, comedian or team is playing, which cities have a festival, conference or expo, big arena shows, games and races. Only events worth a trip are indexed (named performers, festivals, conferences/expos, arena shows, games, races), not every local listing: for everything in one city (small gigs, classes, meetups) use search_events with its city. Kind residency also searches a worldwide list of residencies (pop-up cities, hacker houses, founder and research residencies, fellowship cohorts; most outside our cities, e.g. Kobe or Goa; in person, hybrid or remote; fixed dates, a start only, or rolling intake), each with its application details. Give a query, at least one of kinds, or a place. Each result names its city and links to the original listing (link) and the event on that city's site (on_site); searched says which cities were included and how fresh each is. No sign-in; each client gets 30 calls a minute and 2,500 event rows an hour.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | YYYY-MM-DD, optional | |
| from | No | YYYY-MM-DD, default today | |
| near | No | "lat,lon": only events within radius_km of it, with distance_km. (search_events also takes place names.) Unmapped venues are left out (place.unplaced_events). | |
| kinds | No | Only these kinds: act = named performers; festival = festival; major = major local festival; conference = conference / expo; big_show = arena or amphitheater show; game = sports game (any level); pro_game = professional sports game (MLB, NFL, NBA, NHL, MLS, WNBA, NWSL); race = race; residency = residency, pop-up city, hacker house or fellowship cohort, worldwide (most are outside our cities); in person, hybrid or remote, fixed dates or rolling intake: see each result's residency.attendance and residency.schedule. | |
| limit | No | Default 50 | |
| query | No | An artist, band, comedian, team, festival or conference name, or words to match in titles/performers/venues, e.g. 'Khruangbin', 'Oktoberfest', 'AI summit'. Optional when `kinds`, `neighborhood` or `near` is given. | |
| cities | No | Only these cities (names or slugs): Boston, Chicago, Los Angeles, Orange County, Sacramento, San Diego, San Francisco, Seattle, Atlanta, Austin, Cancún, Colorado Springs & Pueblo, DC, Denver, Detroit, Dubai, Honolulu, Houston, Las Vegas, London, Mexico City, Miami, New York, Paris, Philadelphia, Phoenix, Portland, Salt Lake City, San Antonio, Tokyo, Toronto. Default: all. | |
| radius_km | No | Radius for near (default 10, max 200) | |
| trip_only | No | Only events worth a special trip (multi-day festivals, festivals on a city's watchlist, arena/amphitheater shows, multi-day conferences, full-distance races). Default: true when there is no query, false when searching a name. | |
| neighborhood | No | Only events in this neighborhood or town (whole words, e.g. 'Silver Lake', 'South End', 'Pasadena'). Events whose venue isn't mapped can't be placed and are left out; place.unplaced_events counts them. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | ||
| from | No | ||
| count | Yes | ||
| place | No | ||
| query | No | ||
| shown | Yes | ||
| events | Yes | ||
| searched | No | Which cities were searched and how fresh each is | |
| in_cities | No | ||
| attribution | No | ||
| looser_matches | No | Weaker matches left out (the query only in a title or venue) | |
| residencies_worldwide | No | The worldwide residencies list the `residency` kind also searches |