Trovr

Returns one artist in depth: genre, fan count, the sound of their music as heard in their previews (energy, danceability, tempo, vocals, moods, styles, instruments, a 'sounds like' line; approximate), up to 8 tracks with 30-second preview URLs, and their upcoming shows in the New York area. Takes an artist ID from search results, or an artist name.

get_artist

Returns the card data (images, preview clips, ticket links) for shows already displayed as cards. Used by the cards display.

get_cards

Searches upcoming live-music shows in the New York metro area (Trovr covers only live music, only there), each with a music preview of the artist, by dates, genres, venue types, place, price, mood, the kind of place, or a named artist, event or venue. Returns up to 16 shows ranked by fit, with the reasons each fits, and today's date in New York. Each show carries its lineup (with artist IDs), the headliner's best-known tracks, the venue's type and capacity, what the venue is like when known (vibe tags such as Wine bar, Rooftop, Seated, Big hall, and one line), a one-line summary, and, when available, how the headliner's music sounds (energy and danceability 1-5, tempo, moods, styles, a 'sounds like' line). Dates are ISO strings in New York time; without dates the search covers the next 14 days. A place outside the New York area, or an ask for events that aren't music, returns an outOfScope message and no shows.

search_events

Displays 1 to 10 shows as playable cards: image, venue, date, a preview of the artist and a ticket link. Takes event IDs from search results, each with a one-line reason for the pick.

show_events