Labelcamp API v2

Product Genres

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

Music genre classification for products.

Examples: "Pop / Rock / Indie", "French Pop", "Electronic Music"

Primary genre categorization used for organizing and classifying music products.

List product genres

GET

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

/product-genres

Retrieve all available product genres

List product genres › 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 genres › Responses

Successful response

object[]

Array of resource objects (override with specific resource schema)

object[]

Related resources included in the response

object

GET/product-genres

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

shell

Example Responses

{
  "data": [
    {
      "id": "<ID>",
      "type": "product-genres",
      "links": {
        "self": "https://api.idol.io/api/v2/product-genres/<ID>"
      },
      "attributes": {
        "name": "Pop"
      }
    },
    {
      "id": "<ID>",
      "type": "product-genres",
      "links": {
        "self": "https://api.idol.io/api/v2/product-genres/<ID>"
      },
      "attributes": {
        "name": "Rock"
      }
    },
    {
      "id": "<ID>",
      "type": "product-genres",
      "links": {
        "self": "https://api.idol.io/api/v2/product-genres/<ID>"
      },
      "attributes": {
        "name": "Hip-Hop/Rap"
      }
    }
  ],
  "meta": {
    "record-count": 50,
    "page-count": 17
  },
  "links": {
    "first": "https://api.idol.io/api/v2/product-genres?page%5Bnumber%5D=1&page%5Bsize%5D=3",
    "next": "https://api.idol.io/api/v2/product-genres?page%5Bnumber%5D=2&page%5Bsize%5D=3",
    "last": "https://api.idol.io/api/v2/product-genres?page%5Bnumber%5D=17&page%5Bsize%5D=3"
  }
}

json

application/vnd.api+json

Get product genre details

GET

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

/product-genres/{id}

Retrieve details for a specific product genre by ID

Get product genre details › path Parameters

id

string · required

Resource ID

Get product genre details › Responses

Successful response

object

The primary resource object (override with specific resource schema)

object[]

Related resources included in the response

object

GET/product-genres/{id}

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

shell

Example Responses

No example specified for this content type

application/vnd.api+json

Product Types Distributor Product Subgenres

Labelcamp API v2

Product Genres

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

Music genre classification for products.

Examples: "Pop / Rock / Indie", "French Pop", "Electronic Music"

Primary genre categorization used for organizing and classifying music products.

List product genres

GET

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

/product-genres

Retrieve all available product genres

List product genres › 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 genres › Responses

Successful response

object[]

Array of resource objects (override with specific resource schema)

object[]

Related resources included in the response

object

GET/product-genres

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

shell

Example Responses

{
  "data": [
    {
      "id": "<ID>",
      "type": "product-genres",
      "links": {
        "self": "https://api.idol.io/api/v2/product-genres/<ID>"
      },
      "attributes": {
        "name": "Pop"
      }
    },
    {
      "id": "<ID>",
      "type": "product-genres",
      "links": {
        "self": "https://api.idol.io/api/v2/product-genres/<ID>"
      },
      "attributes": {
        "name": "Rock"
      }
    },
    {
      "id": "<ID>",
      "type": "product-genres",
      "links": {
        "self": "https://api.idol.io/api/v2/product-genres/<ID>"
      },
      "attributes": {
        "name": "Hip-Hop/Rap"
      }
    }
  ],
  "meta": {
    "record-count": 50,
    "page-count": 17
  },
  "links": {
    "first": "https://api.idol.io/api/v2/product-genres?page%5Bnumber%5D=1&page%5Bsize%5D=3",
    "next": "https://api.idol.io/api/v2/product-genres?page%5Bnumber%5D=2&page%5Bsize%5D=3",
    "last": "https://api.idol.io/api/v2/product-genres?page%5Bnumber%5D=17&page%5Bsize%5D=3"
  }
}

json

application/vnd.api+json

Get product genre details

GET

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

/product-genres/{id}

Retrieve details for a specific product genre by ID

Get product genre details › path Parameters

id

string · required

Resource ID

Get product genre details › Responses

Successful response

object

The primary resource object (override with specific resource schema)

object[]

Related resources included in the response

object

GET/product-genres/{id}

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

shell

Example Responses

No example specified for this content type

application/vnd.api+json

Product Types Distributor Product Subgenres