event-synoptic

Search upcoming Los Angeles events (concerts, parties, theater, family, sport and more). Returns compact JSON with venue, date, price-from, artists and a tickets link. Each event carries `rating` (1-13 composite: data quality plus real demand) and `popularity` (headliner fan count, whether they are charting now, and how many ticket sites list the event) — use them to surface the biggest shows first. Filter by free-text query, category tags, date range, location radius, budget or min_rating. `badge` narrows to audiences no other catalogue indexes: sensory-friendly showings, museum free-admission days, events free or discounted with EBT, dog-friendly events, and 21+ vs all-ages. Tag `#markets` returns flea, vintage and night market days — a category absent from every ticketing feed, because entry is paid at the gate. Those events carry a `market` block (admission tiers with entry times, vendor count, cash-only gate, opening hours, open_now). Every event carries `provenance`: which source it came from, when that source last still listed it (last_seen_at), whether it has since been removed or cancelled there, when the price was captured (price_as_of) and an overall `confidence` (high/medium/low). Prefer high-confidence events and tell the user to verify low-confidence ones.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free text: artist, show or venue name"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Category tags, e.g. [\"#concerts\",\"#jazz\"]. Call get_taxonomy for the full list."
    },
    "date_from": {
      "type": "string",
      "description": "ISO date/datetime, default now"
    },
    "date_to": {
      "type": "string",
      "description": "ISO date/datetime, default +7 days"
    },
    "lat": {
      "type": "number",
      "description": "Latitude for near-me filtering"
    },
    "lon": {
      "type": "number",
      "description": "Longitude for near-me filtering"
    },
    "radius_km": {
      "type": "number",
      "description": "Radius for lat/lon filter, default 15"
    },
    "max_price_usd": {
      "type": "number"
    },
    "free_only": {
      "type": "boolean"
    },
    "min_rating": {
      "type": "number",
      "description": "Only events rated at least this (1-13). 10+ = major act or stadium show, 11+ = megastar."
    },
    "badge": {
      "type": "string",
      "enum": [
        "sensory",
        "ebt",
        "freeday",
        "dog",
        "age21",
        "allages"
      ],
      "description": "Audience filter: sensory = sensory-friendly/autism-friendly showings; freeday = a museum/venue free-admission day (Academy Museum Free Day, Huntington's first Thursday) — not a nightclub's free-before-11pm promo; ebt = free or discounted with EBT/CalFresh (Museums for All); dog = dog-friendly; age21 = 21+ only; allages = explicitly all ages."
    },
    "limit": {
      "type": "number",
      "description": "1-25, default 10"
    }
  }
}

Get full details of one event by its id (from search_events results), including `provenance` (source, last_seen_at, still_listed, price_as_of, confidence) and venue facilities.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ]
}

Compare ticket prices for an event across marketplaces (Ticketmaster, Gametime, StubHub, Vivid Seats...). Gametime prices are fetched LIVE. Returns buy links sorted cheapest first.

{
  "type": "object",
  "properties": {
    "event_id": {
      "type": "string"
    }
  },
  "required": [
    "event_id"
  ]
}

Change-only history of what the source said about an event over time: price moves, sold-out, date shifts, delisting/cancellation, with when we first saw the listing. Use it to answer "is the price going up or down", "was this rescheduled" or "has this been removed". History starts 2026-08-22; points are recorded only when something changed.

{
  "type": "object",
  "properties": {
    "event_id": {
      "type": "string"
    }
  },
  "required": [
    "event_id"
  ]
}

Find Los Angeles bars and nightclubs: by vibe (cocktail, rooftop, dive, techno...), near a location, or with happy hour running right now. Includes ratings, hours, happy hour info and links.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "bar",
        "club"
      ]
    },
    "vibe": {
      "type": "string",
      "description": "One vibe tag, e.g. \"rooftop\". Call get_taxonomy for the list."
    },
    "lat": {
      "type": "number"
    },
    "lon": {
      "type": "number"
    },
    "happy_hour_now": {
      "type": "boolean",
      "description": "Only places with happy hour active or starting within an hour"
    },
    "limit": {
      "type": "number"
    }
  }
}

Find Los Angeles museums and galleries: art, history, science, film, kids, cars, gardens, photography. Answers the two questions ticketing APIs cannot: WHEN IS IT FREE (many LA museums are permanently free, others only on a recurring rule such as "second Tuesday of the month" or "Thursdays 5-8 PM" — `free.today`, `free.label` and `free.next` resolve that for the current LA date, `free.rules` gives the raw rule) and WHAT IS ON VIEW (current and upcoming exhibitions with their run dates, so you can say what closes soon). Also returns opening hours, open-now, typical visit length, quietest time, admission prices and links.

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "art",
        "history",
        "science",
        "film",
        "kids",
        "cars",
        "garden",
        "photo",
        "odd"
      ],
      "description": "Museum type. Call get_taxonomy for labels."
    },
    "free_today": {
      "type": "boolean",
      "description": "Only museums that are free today (always-free ones included, ranked last)"
    },
    "open_now": {
      "type": "boolean"
    },
    "lat": {
      "type": "number"
    },
    "lon": {
      "type": "number"
    },
    "limit": {
      "type": "number",
      "description": "1-25, default 10"
    }
  }
}

One call for "what to do tonight in LA": top events until ~6am plus bars with happy hour on right now.

{
  "type": "object",
  "properties": {
    "lat": {
      "type": "number"
    },
    "lon": {
      "type": "number"
    }
  }
}

List all event category tags, bar/club vibe tags, kid-place categories and museum types used by the other tools.

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