Skip to main content
GET
/
artist
/
{id}
/
products
Get Artist Products
curl --request GET \
  --url https://api.royalti.io/artist/{id}/products \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "prod-123",
    "upc": "123456789012",
    "title": "Album Title",
    "isDraft": false,
    "splitCount": 3,
    "count": 50000,
    "royalty": 4500.25,
    "Assets": [
      {
        "id": "asset-456",
        "isrc": "USABC1234567",
        "title": "Song Title",
        "version": "Album Version",
        "AssetProducts": {
          "Number": 1
        }
      }
    ],
    "Artists": [
      {
        "id": "456",
        "artistName": "Main Artist",
        "type": "primary"
      }
    ]
  }
]
This endpoint requires authentication. Include your Bearer token in the Authorization header.

​
Description

artist//products Description:
The /artist/{id}/products endpoint retrieves all products associated with a specific artist, including related assets and statistics. Method:
GET Path Parameter:
ParameterTypeDescription
id (required)stringThe unique identifier of the artist.
page (optional)integerPage number for pagination (default: 1)
size (optional)integerNumber of products per page (default: 10)
type (optional)stringFilter by product type (default: all)
Response Includes:
  • Basic product information
  • Related assets (id, isrc, title, version, track number)
  • Split count (number of splits associated with the product)
  • Total play/stream count (from ProductStats)
  • Total royalties (from ProductStats)
  • Artist information including the type of association

​
Code Examples

const response = await fetch('https://api.royalti.io/artist/example-id/products', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${token}`,
  },
});

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

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string
required

Artist ID

Query Parameters

​
page
integer
default:1

Page number for pagination

​
size
integer
default:10

Number of products per page

​
type
string

Filter by product type

Response

Success

​
id
string

Unique identifier of the product

​
upc
string

UPC code of the product

​
title
string

Title of the product

​
isDraft
boolean

Whether the product is a draft

​
splitCount
integer

Number of splits associated with this product

​
count
number

Total play/stream count from ProductStats

​
royalty
number

Total royalties from ProductStats

​
Assets
object[]
​
Artists
object[]