List upcoming events in one city
list_upcomingRead-onlyIdempotent
Browse the next N days of events in one What's Up In city, day by day, with no search words. by_day counts every match per date, and when more events match than limit the rows are spread evenly across the days, so each day is represented. Use it for overviews like "what's happening in this week"; for search words, free-only, a town or exact from/to dates use search_events, and for one event's details get_event. Optional filters: one category or topic, and a place: neighborhood keeps events inside a named area (radius_km widens it past the boundary), near ranks events by distance from a place or "lat,lon" within radius_km. get_city lists valid neighborhood names. No sign-in; each client gets 30 calls a minute and 2,500 event rows an hour.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | Yes | Which city (name or slug): 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. list_cities has the full list. | |
| days | No | Window in days (default 7) | |
| near | No | Events within radius_km of a place in the city: a neighborhood, a town, a venue name, or "lat,lon". Results get distance_km, nearest first within each day. | |
| limit | No | Max rows (default 50) | |
| topic | No | ||
| category | No | ||
| radius_km | No | Distance for near (default 1.5, max 50), or how far neighborhood reaches past its boundary (default 0) | |
| neighborhood | No | Only events in this neighborhood or town of the city, e.g. 'Capitol Hill', 'Silver Lake', 'Cambridge'. Events whose venue isn't mapped can't be placed and are left out (place.unplaced_events counts them). | |
| changed_since | No | Only events added or changed (title, date or time, venue, link, price, sold out, status) at or after this moment: YYYY-MM-DD (the city's local date) or an ISO date-time. To follow up later, pass the previous result's changes.synced_at; changes.removed then lists events taken down since. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | Yes | ||
| note | No | ||
| site | No | ||
| count | Yes | Events that matched in total | |
| place | No | ||
| shown | Yes | Events returned (at most limit) | |
| by_day | No | Matches per date (YYYY-MM-DD), all of them, not just the rows shown | |
| events | Yes | ||
| changes | No | Only with changed_since | |
| coverage | No | Coverage and accuracy page | |
| attribution | No | ||
| briefing_url | No | The dated weekly briefing for this week or next (counts plus picks per kind of event, #lane when the filters match one); null further out. Cite it for "what's on this week" | |
| data_generated | No | When this city's data was last published |