LONG 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` (performers, headliner first), a catalog `rank` from 0-100, `predicted_end_time` when the listing omitted an end and a later source statement fills it, and `ticket_offer` when a verified price or availability is still fresh. Use this to help users find events in a city or near coordinates.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name like 'Berlin', 'New York', 'London'"
    },
    "country": {
      "type": "string",
      "description": "Country name to filter by"
    },
    "latitude": {
      "type": "number",
      "description": "Latitude for location-based search"
    },
    "longitude": {
      "type": "number",
      "description": "Longitude for location-based search"
    },
    "radius_km": {
      "type": "number",
      "description": "Search radius in kilometers (default 50)",
      "default": 50
    },
    "start_date": {
      "type": "string",
      "description": "Start date filter in ISO format (YYYY-MM-DD)"
    },
    "end_date": {
      "type": "string",
      "description": "End date filter in ISO format (YYYY-MM-DD)"
    },
    "category": {
      "type": "string",
      "description": "Event category like 'electronic', 'rock', 'tech', 'crypto'"
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of events to return (default 20, max 100)",
      "default": 20
    }
  }
}

Get full details for a specific event by its ID. Returns the complete, untruncated description, venue details, local timezone, lineup, ticket URL, catalog rank, predicted end time when the listing omitted one, and a publishable ticket offer.

{
  "type": "object",
  "properties": {
    "event_id": {
      "type": "string",
      "description": "The UUID of the event to retrieve"
    }
  },
  "required": [
    "event_id"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "Filter by city name"
    },
    "country": {
      "type": "string",
      "description": "Filter by country name"
    },
    "tag": {
      "type": "string",
      "description": "Filter by tag (e.g., 'crypto', 'music', 'tech')"
    },
    "include_past": {
      "type": "boolean",
      "description": "Include past event weeks (default false)",
      "default": false
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of event weeks to return",
      "default": 10
    }
  }
}

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

{
  "type": "object",
  "properties": {
    "week_id": {
      "type": "string",
      "description": "The UUID of the event week to retrieve"
    },
    "event_week_id": {
      "type": "string",
      "description": "Alias for week_id"
    },
    "slug": {
      "type": "string",
      "description": "The slug of the event week (alternative to week_id)"
    }
  }
}

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

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query to match against name, description, or city"
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of results to return",
      "default": 20
    }
  },
  "required": [
    "query"
  ]
}

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

{
  "type": "object",
  "properties": {}
}

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

{
  "type": "object",
  "properties": {}
}

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

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "Filter by country name"
    },
    "min_events": {
      "type": "number",
      "description": "Minimum number of total events"
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of cities to return",
      "default": 20
    }
  }
}

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

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name to search venues in"
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of venues to return",
      "default": 20
    }
  },
  "required": [
    "city"
  ]
}

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?'

{
  "type": "object",
  "properties": {
    "event_id": {
      "type": "string",
      "description": "UUID of the event to get schedule for"
    },
    "event_name": {
      "type": "string",
      "description": "Name of the event to search for (if event_id not known)"
    },
    "stage": {
      "type": "string",
      "description": "Filter by stage name"
    },
    "artist": {
      "type": "string",
      "description": "Search for specific artist in the schedule"
    }
  }
}

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?'

{
  "type": "object",
  "properties": {
    "event_week_id": {
      "type": "string",
      "description": "Filter to specific event week/festival"
    },
    "event_id": {
      "type": "string",
      "description": "Filter to specific event"
    },
    "city": {
      "type": "string",
      "description": "Filter by city"
    }
  }
}

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?'

{
  "type": "object",
  "properties": {
    "artist_name": {
      "type": "string",
      "description": "Artist name to search for"
    },
    "city": {
      "type": "string",
      "description": "Filter performances by city"
    },
    "country": {
      "type": "string",
      "description": "Filter performances by country"
    },
    "start_date": {
      "type": "string",
      "description": "Start date filter (YYYY-MM-DD)"
    },
    "end_date": {
      "type": "string",
      "description": "End date filter (YYYY-MM-DD)"
    },
    "upcoming_only": {
      "type": "boolean",
      "description": "Only return future performances (default true)",
      "default": true
    },
    "limit": {
      "type": "number",
      "description": "Maximum artists to return (default 20, max 100)",
      "default": 20
    }
  },
  "required": [
    "artist_name"
  ]
}

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?'

{
  "type": "object",
  "properties": {
    "artist_id": {
      "type": "string",
      "description": "Artist UUID"
    },
    "slug": {
      "type": "string",
      "description": "Artist slug, as used by /artist/:slug"
    },
    "name": {
      "type": "string",
      "description": "Exact artist name"
    }
  }
}

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.

{
  "type": "object",
  "properties": {
    "artist_id": {
      "type": "string",
      "description": "Artist UUID"
    },
    "slug": {
      "type": "string",
      "description": "Artist slug"
    },
    "name": {
      "type": "string",
      "description": "Exact artist name"
    },
    "city": {
      "type": "string",
      "description": "Filter by city"
    },
    "country": {
      "type": "string",
      "description": "Filter by country"
    },
    "start_date": {
      "type": "string",
      "description": "Start date filter (YYYY-MM-DD)"
    },
    "end_date": {
      "type": "string",
      "description": "End date filter (YYYY-MM-DD)"
    },
    "upcoming_only": {
      "type": "boolean",
      "description": "Only return future performances (default true)",
      "default": true
    },
    "limit": {
      "type": "number",
      "description": "Maximum events to return (default 20, max 100)",
      "default": 20
    },
    "offset": {
      "type": "number",
      "description": "Pagination offset",
      "default": 0
    }
  }
}

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?'

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Filter by partial artist name"
    },
    "city": {
      "type": "string",
      "description": "Only artists performing in this city"
    },
    "country": {
      "type": "string",
      "description": "Only artists performing in this country"
    },
    "source": {
      "type": "string",
      "description": "Only artists seen on this event source (e.g. ra, edmtrain)"
    },
    "min_events": {
      "type": "number",
      "description": "Minimum tracked performances"
    },
    "upcoming_only": {
      "type": "boolean",
      "description": "Only count future performances when a city or country filter is used (default true)",
      "default": true
    },
    "limit": {
      "type": "number",
      "description": "Maximum artists to return (default 20, max 100)",
      "default": 20
    },
    "offset": {
      "type": "number",
      "description": "Pagination offset",
      "default": 0
    }
  }
}

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

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search by organizer name, website, email, or Instagram handle"
    },
    "source": {
      "type": "string",
      "description": "Filter by event source (e.g., facebook, eventbrite, lu.ma)"
    },
    "missing_contacts_only": {
      "type": "boolean",
      "description": "Only return organizers missing website, email, phone, or Instagram (default false)",
      "default": false
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of organizers to return (default 20, max 100)",
      "default": 20
    }
  }
}