GET
ArtistsList Artists
Return a paginated list of artists with optional name and genre filtering.
/v1/artistsMethod
GET
Path
/v1/artists
Group
Artists
Overview
How to use this endpoint
Use this endpoint when you need structured API data in a predictable JSON shape. Reference the request example, required parameters, and response fields below to wire it into your product or internal tool.
Response format
JSON response
All successful responses return data in a stable JSON envelope and use Tune UUIDs for resource identifiers.
Code example
Example request
request
Copy-ready
GET /v1/artists?genre=electronicRequest parameters
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | No | Search against artist names. |
genre | string | No | Filter by genre tag. |
limit | integer | No | Number of records to return. Default 20, maximum 100. |
cursor | string | No | Opaque cursor returned by a previous paginated response. |
Response schema
Response fields
| Field | Type | Description |
|---|---|---|
tune_id | uuid | Unique Tune artist identifier. |
name | string | Artist name. |
popularity | integer | Relative popularity score from 0 to 100. |
followers_total | integer | Total follower count. |
genres | string[] | Genres associated with the artist. |
images | object[] | Artist images with url, width, and height. |
Code example
Example response
application/json
Copy-ready
{
"data": [
{
"tune_id": "a87ff679-a2f3-71d1-9ad8-0800200c9a66",
"name": "Nova Circuit",
"popularity": 58,
"followers_total": 124500,
"genres": ["electronic", "ambient"],
"images": [
{
"url": "https://cdn.tune.dev/images/a87ff679_640.jpg",
"width": 640,
"height": 640
}
]
}
],
"pagination": {
"limit": 20,
"next_cursor": null
}
}Next steps