Venues

​

Venues where the artist has performed (past or scheduled), grouped by venue with the events that took place at each. Venues are sorted by capacity descending and paginated via limit/offset. Each venue row nests a narrow events[] subset — full event detail (pricing, images, status-annotated name) comes from /api/artist/{id}/{status}/events. Returns [] when the artist has no linked venues or events.

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
Query Parameters
  • limit
    Type: number Format: float
    max:  
    100

    Maximum number of venues to return. Defaults to 20, 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}/venues
curl https://api.chartmetric.com/api/artist/2/venues \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": [
    {
      "venue_id": 434,
      "venue_name": "Dodger Stadium",
      "venue_url": "https://www.jambase.com/venue/dodger-stadium",
      "venue_capacity": 56000,
      "city": {
        "id": 7058,
        "name": "Los Angeles"
      },
      "code2": "US",
      "events": [
        {
          "id": 356,
          "event_name": "Besame Mucho (cancelled)",
          "jambase_event_url": "https://www.jambase.com/festival/besame-mucho-2024",
          "songkick_event_url": "https://www.songkick.com/festivals/2317029-besame-mucho/id/41963404-besame-mucho-2024",
          "seatgeek_event_url": null,
          "type": "Festival",
          "start_date": "2024-12-21T00:00:00.000Z",
          "end_date": "2024-12-21T00:00:00.000Z",
          "is_headliner": true
        }
      ]
    }
  ]
}

Success