Labelcamp API v2

Product Types

Endpoint:https://api.idol.io/api/v2

Product type classification.

Available types: Album, Single, EP, Video

Defines the format and type of music releases.

List product types

GET

https://api.idol.io/api/v2

/product-types

Retrieve all available product types

List product types › query Parameters

page[number]

integer · min: 1

Page number for pagination

Default: 1

page[size]

integer · min: 1 · max: 200

Number of items per page (max 200)

Default: 20

List product types › Responses

Successful response

object[]

Array of resource objects (override with specific resource schema)

object[]

Related resources included in the response

object

GET/product-types

curl --request GET \
  --url https://api.idol.io/api/v2/product-types

shell

Example Responses

{
  "data": [
    {
      "id": "1",
      "type": "product-types",
      "links": {
        "self": "https://api.idol.io/api/v2/product-types/1"
      },
      "attributes": {
        "name": "Album"
      }
    },
    {
      "id": "2",
      "type": "product-types",
      "links": {
        "self": "https://api.idol.io/api/v2/product-types/2"
      },
      "attributes": {
        "name": "Single"
      }
    },
    {
      "id": "3",
      "type": "product-types",
      "links": {
        "self": "https://api.idol.io/api/v2/product-types/3"
      },
      "attributes": {
        "name": "EP"
      }
    }
  ],
  "meta": {
    "record-count": 8,
    "page-count": 3
  },
  "links": {
    "first": "https://api.idol.io/api/v2/product-types?page%5Bnumber%5D=1&page%5Bsize%5D=3",
    "next": "https://api.idol.io/api/v2/product-types?page%5Bnumber%5D=2&page%5Bsize%5D=3",
    "last": "https://api.idol.io/api/v2/product-types?page%5Bnumber%5D=3&page%5Bsize%5D=3"
  }
}

json

application/vnd.api+json

Get product type details

GET

https://api.idol.io/api/v2

/product-types/{id}

Retrieve details for a specific product type by ID

Get product type details › path Parameters

id

string · required

Resource ID

Get product type details › Responses

Successful response

object

The primary resource object (override with specific resource schema)

object[]

Related resources included in the response

object

GET/product-types/{id}

curl --request GET \
  --url https://api.idol.io/api/v2/product-types/:id

shell

Example Responses

{
  "data": {
    "id": "1",
    "type": "product-types",
    "links": {
      "self": "https://api.idol.io/api/v2/product-types/1"
    },
    "attributes": {
      "name": "Album"
    }
  }
}

json

application/vnd.api+json

Languages Product Genres

Labelcamp API v2

Product Types

Endpoint:https://api.idol.io/api/v2

Product type classification.

Available types: Album, Single, EP, Video

Defines the format and type of music releases.

List product types

GET

https://api.idol.io/api/v2

/product-types

Retrieve all available product types

List product types › query Parameters

page[number]

integer · min: 1

Page number for pagination

Default: 1

page[size]

integer · min: 1 · max: 200

Number of items per page (max 200)

Default: 20

List product types › Responses

Successful response

object[]

Array of resource objects (override with specific resource schema)

object[]

Related resources included in the response

object

GET/product-types

curl --request GET \
  --url https://api.idol.io/api/v2/product-types

shell

Example Responses

{
  "data": [
    {
      "id": "1",
      "type": "product-types",
      "links": {
        "self": "https://api.idol.io/api/v2/product-types/1"
      },
      "attributes": {
        "name": "Album"
      }
    },
    {
      "id": "2",
      "type": "product-types",
      "links": {
        "self": "https://api.idol.io/api/v2/product-types/2"
      },
      "attributes": {
        "name": "Single"
      }
    },
    {
      "id": "3",
      "type": "product-types",
      "links": {
        "self": "https://api.idol.io/api/v2/product-types/3"
      },
      "attributes": {
        "name": "EP"
      }
    }
  ],
  "meta": {
    "record-count": 8,
    "page-count": 3
  },
  "links": {
    "first": "https://api.idol.io/api/v2/product-types?page%5Bnumber%5D=1&page%5Bsize%5D=3",
    "next": "https://api.idol.io/api/v2/product-types?page%5Bnumber%5D=2&page%5Bsize%5D=3",
    "last": "https://api.idol.io/api/v2/product-types?page%5Bnumber%5D=3&page%5Bsize%5D=3"
  }
}

json

application/vnd.api+json

Get product type details

GET

https://api.idol.io/api/v2

/product-types/{id}

Retrieve details for a specific product type by ID

Get product type details › path Parameters

id

string · required

Resource ID

Get product type details › Responses

Successful response

object

The primary resource object (override with specific resource schema)

object[]

Related resources included in the response

object

GET/product-types/{id}

curl --request GET \
  --url https://api.idol.io/api/v2/product-types/:id

shell

Example Responses

{
  "data": {
    "id": "1",
    "type": "product-types",
    "links": {
      "self": "https://api.idol.io/api/v2/product-types/1"
    },
    "attributes": {
      "name": "Album"
    }
  }
}

json

application/vnd.api+json

Languages Product Genres