long-events

Search Events

Search for events near a location with optional filters. Every event returns a description: the organizer's own copy when the source published one, otherwise a factual summary generated from the listing (venue, local date and time, category, organizer, lineup). Also returns `lineup`, the performers in billing order with the headliner first. Use this to help users find events in a city or near coordinates.

Get Event Details

Get full details for a specific event by its ID. Returns the complete, untruncated description, venue details, local timezone, lineup, and ticket URL.

Get Event Weeks

List upcoming conference weeks, festivals, and multi-day event series (like ETH Denver, Devconnect, Token2049). Use this to help users plan trips around major conferences.

Get Event Week Details

Get full details for a conference week including all its side events. Use this to help users see everything happening during a major conference.

Search Event Weeks

Search event weeks by name, description, or city. Use this to find specific conferences or festivals.

Get Event Week Cities

List cities that have upcoming event weeks with their counts. Use this to discover where major conferences are happening.

Get Event Week Tags

List all tags used in event weeks with their counts. Use this to discover types of conferences available.

Get Cities

List cities that have events, with statistics like total events and recent activity. Use this to help users discover active event scenes.

Get Venues

List venues in a city with their event history. Use this to help users find popular venues or discover new spots.

Get Event Schedule

Get the DJ/artist schedule for a festival or party event. Returns set times, stages, and artists. Use this to answer questions like 'What time does ANOTR play?' or 'What's happening at AYA on New Year's Eve?'

Get Now Playing

Get what's currently playing at festival/party events. Returns live stage information with current artists. Use this to answer 'What's on now?' or 'Who's playing right now at AYA?'

Search Artists

Search artists by name and get every performance we know about, across all sources. Artist records include nullable mbid and cross-provider-verified spotify_id fields for stable matching. Use this to find when and where a specific artist is playing. Great for answering 'When does Bonobo play?', 'Where can I see Tale of Us?', or 'Which cities is Nina Kraviz touring?'

Get Artist

Get one artist's profile, nullable mbid and verified spotify_id, upcoming dates, and recent history. Provide artist_id, slug, or name. Use this to answer 'Tell me about Tale of Us' or 'What is Objekt up to?'

Get Artist Events

List one artist's stable identity and performances with filtering and pagination. The artist includes nullable mbid and verified spotify_id. Use this to answer 'Where is Peggy Gou playing in Europe next month?' or to page through a touring artist's full schedule. Each performance carries ticket_url, the resolved closest-to-purchase link, alongside the source page url.

List Artists

Browse artists with nullable mbid and verified spotify_id fields, optionally scoped to a city or country. Ordered by how many performances we track. Use this to answer 'Who is playing in Berlin this month?' or 'Which artists tour most?'

Search Organizers

Search organizer profiles enriched from event data. Returns organizer names, source, website/contact details, Instagram profile URL plus handle, and scrape status.