Live Events

​

Live events (concerts, festivals, performances) for an artist, filtered by status (current or past). Events come from the ES cm_live_event index, hydrated with jambase/songkick/seatgeek/ticketmaster URLs, venue details, and pricing (when available from seatgeek or ticketmaster). price_trend is a seatgeek-only 28-day average-price series; non-seatgeek sources return []. event_name suffix (e.g. (cancelled)) reflects the event status.

Path Parameters
  • id
    Type: integer
    min:  
    2
    max:  
    2147483647
    required

    Chartmetric artist ID. Note: id=1 ('Various Artists') is rejected.

    • enum
      const:  
      1
      values
      • 1
  • status
    Type: string enum
    required

    Event status. One of current, past. Songkick events are only returned for past.

    values
    • current
    • past
Query Parameters
  • fromDaysAgo
    Type: integer
    required

    Number of days ago marking the start of the event window. Use a negative value to point into the future.

  • toDaysAgo
    Type: integer
    required

    Number of days ago marking the end of the event window. Use a negative value to point into the future.

  • cityId
    Type: integer | null

    Optional Chartmetric city ID to filter events to a single city.

  • limit
    Type: integer
    min:  
    0
    max:  
    100

    Maximum number of events to return. Defaults to 10, max 100.

  • offset
    Type: integer
    min:  
    0

    Number of items to skip from the start of the result set; pair with limit to paginate.

Responses
  • application/json
Request Example for get/api/artist/{id}/{status}/events
curl 'https://api.chartmetric.com/api/artist/2/current/events?fromDaysAgo=1&toDaysAgo=1' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": [
    {
      "id": 8553348,
      "event_name": "Modest Mouse at Greek Theatre",
      "jambase_event_url": "https://www.jambase.com/venue/greek-theatre",
      "songkick_event_url": null,
      "seatgeek_event_url": null,
      "ticketmaster_event_url": null,
      "image_url": null,
      "type": "Concert",
      "start_date": "2024-07-28T00:00:00.000Z",
      "end_date": "2024-07-28T00:00:00.000Z",
      "venue_id": 1,
      "venue_name": "Greek Theatre",
      "venue_url": "https://thegreekberkeley.com/",
      "venue_capacity": 8500,
      "city": {
        "id": 6312,
        "name": "Berkeley",
        "province": "California"
      },
      "code2": "US",
      "low_price": 45,
      "high_price": 250,
      "price": 120,
      "price_trend": [
        {
          "date": "2024-07-01",
          "price": 115
        }
      ],
      "currency": "USD",
      "is_headliner": true
    }
  ]
}

Success