Deezer

List Deezer artist concerts

List upcoming Deezer artist concerts and festivals.

GET/v1/deezer/artists/{artistId}/events
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
5
artistIdstringrequiredpath

Deezer artist id, for example `119`.

pattern: ^[1-9]\d{0,11}$

typestringoptionalquery

Only this kind of event. Default: both.

one of: concert, festival

nearstringoptionalquery

Sort by distance from this point, `latitude,longitude`. Default: soonest first. With `near`, `type` is applied to each page after Deezer sorts by distance, so a page can hold fewer than `limit` events.

pattern: ^-?\d{1,3}(\.\d+)?,-?\d{1,3}(\.\d+)?$

limitintegeroptionalquery

Items per page, 1 to 100. Default: 50.

≥ 1 · ≤ 100

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page. Keep the other parameters the same.

min 1 chars · max 1000 chars

Response fields
44

Endpoint-specific response payload.

datalookupStatus
string

Whether the item was found.

one of: found, not_found

dataonTour
booleannullable

Whether Deezer marks the artist as on tour.

Events Deezer still marks as pending. Check `startAt`; a pending event can already have started.

dataevents[]id
integer

Event id.

dataevents[]name
string

Event name, with the date.

dataevents[]url
stringnullable

Public page of the event on the ticketing and listings site.

dataevents[]startAt
stringnullable

When the event starts. Midnight UTC when the listing gives only a date (ISO-8601, UTC).

dataevents[]hasTime
booleannullable

Whether `startAt` carries a time of day. Null when Deezer does not say (event lookups and searches).

dataevents[]status
stringnullable

Event status: `PENDING`, `STARTED`, `ENDED`, `CANCELLED` or `POSTPONED`.

dataevents[]venue
stringnullable

Venue name.

dataevents[]city
stringnullable

City name.

dataevents[]countryCode
stringnullable

Two-letter country code.

Venue coordinates when the listing provides them; null on a single event lookup or a search.

dataevents[]coordinateslatitude
numbernullable

Latitude.

dataevents[]coordinateslongitude
numbernullable

Longitude.

What kind of event it is.

dataevents[]typesconcert
boolean

A concert.

dataevents[]typesfestival
boolean

A festival.

dataevents[]typeslivestreamConcert
boolean

A livestreamed concert.

dataevents[]typeslivestreamFestival
boolean

A livestreamed festival.

Artists on the bill that Deezer lists as artists.

A short reference to an artist.

dataevents[]performers[]artistid
integer

Artist id.

dataevents[]performers[]artistname
string

Artist name.

dataevents[]performers[]artisturl
stringnullable

Artist page URL.

Picture URLs in four sizes.

dataevents[]performers[]artistimagesid
stringnullable

Image identifier; every size URL is built from it. Null when the item has no picture of its own.

dataevents[]performers[]artistimagessmall
stringnullable

Small image URL (about 56 px).

dataevents[]performers[]artistimagesmedium
stringnullable

Medium image URL (about 250 px).

dataevents[]performers[]artistimagesbig
stringnullable

Large image URL (about 500 px).

dataevents[]performers[]artistimagesxl
stringnullable

Extra-large image URL (about 1000 px).

dataevents[]performers[]fanCount
integernullable

Number of fans.

dataevents[]performers[]isMain
booleannullable

Whether the artist headlines.

dataevents[]performers[]isSupport
booleannullable

Whether the artist is a support act.

dataevents[]performers[]order
integernullable

Position in the running order.

dataevents[]performersTruncated
boolean

Whether the bill has more acts than the lookup returns (100 for an event lookup, 15 in a list).

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/deezer/artists/119/events" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Artist's concerts and festivals.