Browse the Help Center for platform guides or API & Developers for integration docs.
curl --request GET \
--url https://open.beatpass.ca/api/v1/artists/{id} \
--header 'Authorization: Bearer <token>'{
"status": "success",
"artist": {
"id": 123,
"name": "Led Zeppelin",
"image_small": "https://example.com/image1.jpg",
"verified": true,
"albums": {
"current_page": 1,
"from": 1,
"to": 100,
"per_page": 25,
"last_page": 156,
"total": 264,
"data": [
{
"id": 123,
"name": "Coda",
"image": "https://example.com/image1.jpg",
"release_date": "1982-11-19",
"description": "<string>",
"tracks": [
{
"id": 123,
"name": "Hey Hey What Can I Do",
"release_date": "1982-11-19",
"image": "https://example.com/image1.jpg",
"duration": 5645848548,
"description": "<string>",
"artists": [
{
"id": 123,
"name": "Led Zeppelin",
"image_small": "https://example.com/image1.jpg",
"verified": true
}
]
}
],
"artists": [
{
"id": 123,
"name": "Led Zeppelin",
"image_small": "https://example.com/image1.jpg",
"verified": true
}
]
}
]
},
"similar": [
{
"id": 123,
"name": "Led Zeppelin",
"image_small": "https://example.com/image1.jpg",
"verified": true
}
],
"top_tracks": [
{
"id": 123,
"name": "Hey Hey What Can I Do",
"release_date": "1982-11-19",
"image": "https://example.com/image1.jpg",
"duration": 5645848548,
"description": "<string>",
"artists": [
{
"id": 123,
"name": "Led Zeppelin",
"image_small": "https://example.com/image1.jpg",
"verified": true
}
]
}
],
"genres": [
{
"id": 1,
"name": "rock"
}
],
"profile": {
"id": 1,
"description": "<string>",
"city": "<string>",
"country": "<string>"
},
"profile_images": [
{
"id": 1,
"url": "https://site.com/image.jpg"
}
],
"links": [
{
"id": 1,
"url": "https://facebook.com",
"title": "Facebook"
}
]
}
}curl --request GET \
--url https://open.beatpass.ca/api/v1/artists/{id} \
--header 'Authorization: Bearer <token>'{
"status": "success",
"artist": {
"id": 123,
"name": "Led Zeppelin",
"image_small": "https://example.com/image1.jpg",
"verified": true,
"albums": {
"current_page": 1,
"from": 1,
"to": 100,
"per_page": 25,
"last_page": 156,
"total": 264,
"data": [
{
"id": 123,
"name": "Coda",
"image": "https://example.com/image1.jpg",
"release_date": "1982-11-19",
"description": "<string>",
"tracks": [
{
"id": 123,
"name": "Hey Hey What Can I Do",
"release_date": "1982-11-19",
"image": "https://example.com/image1.jpg",
"duration": 5645848548,
"description": "<string>",
"artists": [
{
"id": 123,
"name": "Led Zeppelin",
"image_small": "https://example.com/image1.jpg",
"verified": true
}
]
}
],
"artists": [
{
"id": 123,
"name": "Led Zeppelin",
"image_small": "https://example.com/image1.jpg",
"verified": true
}
]
}
]
},
"similar": [
{
"id": 123,
"name": "Led Zeppelin",
"image_small": "https://example.com/image1.jpg",
"verified": true
}
],
"top_tracks": [
{
"id": 123,
"name": "Hey Hey What Can I Do",
"release_date": "1982-11-19",
"image": "https://example.com/image1.jpg",
"duration": 5645848548,
"description": "<string>",
"artists": [
{
"id": 123,
"name": "Led Zeppelin",
"image_small": "https://example.com/image1.jpg",
"verified": true
}
]
}
],
"genres": [
{
"id": 1,
"name": "rock"
}
],
"profile": {
"id": 1,
"description": "<string>",
"city": "<string>",
"country": "<string>"
},
"profile_images": [
{
"id": 1,
"url": "https://site.com/image.jpg"
}
],
"links": [
{
"id": 1,
"url": "https://facebook.com",
"title": "Facebook"
}
]
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
ID of the artist
Comma separated list of additional data to fetch for this artist. Supported values: similar, genres, albums, topTracks.
"albums,genres"
Response body contains an artist object in JSON format.
"success"
Show child attributes
"Led Zeppelin"
Small image for artist, usually 320x320px in size.
"https://example.com/image1.jpg"
Whether artist has been verified by SITE_NAME staff
true
Show child attributes
1
1
100
25
156
264
Show child attributes
"Coda"
Artwork image for album, usually 300x300px in size
"https://example.com/image1.jpg"
Release date of the album in YYYY-MM-DD format
"1982-11-19"
description for the album
Tracks of the album
Show child attributes
"Hey Hey What Can I Do"
Release date of the album in YYYY-MM-DD format
"1982-11-19"
Artwork image for album, usually 300x300px in size
"https://example.com/image1.jpg"
Duration for track in milliseconds
5645848548
description for the track
List of artists who performed the track
Show child attributes
"Led Zeppelin"
Small image for artist, usually 320x320px in size.
"https://example.com/image1.jpg"
Whether artist has been verified by SITE_NAME staff
true
Artists of the album
Show child attributes
"Led Zeppelin"
Small image for artist, usually 320x320px in size.
"https://example.com/image1.jpg"
Whether artist has been verified by SITE_NAME staff
true
Show child attributes
Show child attributes
"Hey Hey What Can I Do"
Release date of the album in YYYY-MM-DD format
"1982-11-19"
Artwork image for album, usually 300x300px in size
"https://example.com/image1.jpg"
Duration for track in milliseconds
5645848548
description for the track
List of artists who performed the track
Show child attributes
"Led Zeppelin"
Small image for artist, usually 320x320px in size.
"https://example.com/image1.jpg"
Whether artist has been verified by SITE_NAME staff
true
Was this page helpful?