Skip to main content
GET
/
artist
Get Artists
curl --request GET \
  --url https://api.royalti.io/artist/ \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "artistName": "<string>",
      "signDate": "2023-12-25",
      "label": "<string>",
      "publisher": "<string>",
      "copyright": "<string>",
      "externalId": "<string>",
      "artistImg": "<string>",
      "links": {
        "spotify": "https://open.spotify.com/artist/...",
        "instagram": "@artisthandle",
        "youtube": "https://youtube.com/@artist"
      },
      "contributors": {},
      "TenantId": 123,
      "realName": "<string>",
      "pseudonyms": [
        "<string>"
      ],
      "birthDate": "2023-12-25",
      "birthPlace": "<string>",
      "biography": "<string>",
      "influences": [
        "<string>"
      ],
      "chartHistory": [
        {}
      ],
      "socialMediaVerified": {
        "instagram": true,
        "twitter": false
      },
      "genres": [
        "<string>"
      ],
      "instruments": [
        "<string>"
      ],
      "activeYears": "<string>",
      "associatedActs": [
        "<string>"
      ],
      "recordingName": "<string>",
      "nationality": "<string>",
      "gender": "<string>",
      "website": "<string>",
      "fanClubUrl": "<string>",
      "managementInfo": {},
      "bookingInfo": {},
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "pagination": {
    "totalItems": 123,
    "totalPages": 123,
    "currentPage": 123,
    "pageSize": 123
  }
}

​
Description

/artist/ Description:
The /artist/ endpoint retrieves a list of artists based on specified criteria. It allows filtering artists by name, external ID, and searching for artists using a keyword. Method:
GET Query Parameters:
ParameterRequiredDescription
artistNameNoFilter artists by their name.
externalIdNoFilter artists by their external ID.
pageNoSpecifies the page number for pagination.
sizeNoSpecifies the number of artists per page.
catalogNoSpecifies whether to include catalog information.
qNoSearches for artists using a keyword.
statisticsNoWhether to include statistical data.
sortNoField to sort by.
orderNoSort order (asc or desc).
attributesNoComma-separated list of attributes to include.
columnNoSpecific column to filter.
userNoFilter by user ID.

​
Code Examples

const response = await fetch('https://api.royalti.io/artist/', {
  method: 'GET',
});

const data = await response.json();
console.log(data);

Authorizations

​
Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Query Parameters

​
artistName
string

Filter artists by their name

​
externalId
string

Filter artists by external ID

​
page
integer
default:1

Page number for pagination

​
size
integer
default:10

Number of items per page

​
catalog
boolean

Include catalog information

​
q
string

Search query

​
statistics
boolean

Include statistical data

​
sort
string
default:updatedAt

Field to sort by

​
order
enum<string>
default:desc

Sort order

Available options:
asc,
desc
​
attributes
string

Comma-separated list of attributes to include

​
column
string

Specific column to filter

​
user
string

Filter by user ID

Response

Success

​
success
boolean
​
data
object[]
​
pagination
object