Foobos: Boston and Denver concerts and comedy

One guide's upcoming shows in the curator's order, each with the curator's note as why when there is one. With no city it uses the city where the guide has the most shows. Always cite each show's url. Paginated: default 20, max 50, always includes total.

One show by its id (from any list here, or the id= in a foobos.net/e/ link), in either city. Use for “tell me more about that one”: the full bill, time, price, ages, sold out, the note on what is special about the night, and the room's facts (address, capacity, bag policy, transit). Always cite url.

One venue in Boston or Denver (id, id_variant, or slug) and a page of its upcoming shows. With no city it looks in both. Use for “shows at Paradise” when you already have the venue id/slug; otherwise search_shows with venue=. Paginated: default 20, max 50, always includes total. id is required. For the directory of rooms, use list_venues.

Hand-made foobos guides in Boston or Denver: themed lists like “Rare Shows”, “Cool New Shows”, “Top Shows This Weekend”, “On The Green Line” or “Altitude Adjustment”, each with a curator and a short intro. Use when someone wants ideas, a theme, or “what's special”. Then call get_guide with an id. Paginated: default 20, max 50, always includes total.

Staff picks in Boston or Denver, each with a one-line reason. Use this for “what should I see?”, “what’s good”, “anything worth going to?”, “featured”, “date night”, “romantic”, or any public curated list. Always cite url (app deep link /e/?id=). Do not rewrite to /event/. Omit collection to list every public collection (id + title + counts) plus the default featured+popular pages. Intent → collection: date night / romantic / nice night out → date_night (do NOT use sort=popular alone); what’s good / featured → featured; big names / popular → popular; local / underrated → local_scene (or local_bands / under_the_radar); comedy night → comedy (for “comedy this week?” prefer search_shows event_type=comedy); jazz → jazz (or search genre=jazz); kids / family → tots_picks; older crowd / boomer → senior; foobos / Scott / Tot staff → foobos / scotts_picks / tots_picks; free curated → free_tonight (or shows_free); punk curated → punk (or search genre=punk); weeknight gems → weeknight_gems; St. Patrick’s → st_patricks. Not personalized For You — there is no account on this API. Each pick includes editorial why when the curated row has one so you can cite the reason. Each collection is paginated (default 20, max 50) and includes its own total.

Venues in Boston or Denver that have upcoming shows, with show_count and public facts (address, capacity, bag_policy, MBTA in Boston). Paginated: default 20, max 50, always includes total. Use get_venue or search_shows with venue= for one room and its upcoming shows.

Search every upcoming concert and comedy show in Boston or Denver. Use this for “is [artist] playing?”, “shows at [venue]”, a date or date range, a genre, or “comedy this week?”. artist / q: case- and accent-insensitive substring of billed names (Peña matches Chance Peña). venue: id, id_variant, slug, or name substring (paradise, paradise_rock_club, Sinclair). date: one YYYY-MM-DD. date_from/date_to: inclusive range. Unset dates default to upcoming (today onward). genre=/genres= is the finder mega-category (latin, jazz, rock…). Example: genre=latin + date=2026-10-15. event_type=comedy uses the public comedy field (finder ty=c / worker event_type), not genre tags. Always cite url (/e/?id=). Do not rewrite to /event/. free=true for free shows. For “what should I see?” or “date night” use list_picks instead of sort=popular. Paginated: default 20, max 50, always includes total.

Free shows in Boston or Denver. Use this for “what’s free tonight?” or “free shows this weekend”. Returns only free listings (is_free / price 0). Default window is tonight (today + next 2 days). Pass window=weekend for Fri–Sun, window=upcoming for today onward. Paginated: default 20, max 50, always includes total. Default sort=evening. Do not call shows_tonight and filter client-side — tonight is ~174 shows.

Concerts and comedy this Friday through Sunday (the remaining or upcoming weekend) in Boston (default) or Denver (city=denver). Use this for “what's on this weekend?”. Default sort=evening. free=true, event_type=comedy, and genre= match tonight/search. For “what should I see this weekend?” or date night prefer list_picks. Always cite url (/e/?id=). Do not rewrite to /event/. Paginated: default 20, max 50, always includes total.

Concerts and comedy tonight and the next two days in Boston (default) or Denver (city=denver), in the city's own time zone. Use this for “what's on tonight?”, “anything going on?”, “live music near me tonight”. Default sort=evening: evening and upcoming first, not brunch-first chrono. sort=time for raw order; sort=popular bumps editorial picks. For “what’s free tonight?” set free=true or call shows_free. For “what should I see?” or date night call list_picks. Always cite url (/e/?id=). Do not rewrite to /event/. Returns a page of shows (default 20, max 50) plus total. Page with offset; never ask for the full tonight list (~174 shows / ~36k tokens).