Labelcamp API v2

Videos

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

Manage music video content with support for file uploads, ISRC codes, and track associations.

GET

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

/videos

Retrieve video content for distribution

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

filter[distributor-id]

string

Filter by distributor ID

filter[company-ids]

string

Comma-separated company IDs

filter[label-ids]

string

Comma-separated label IDs

filter[product-ids]

string

Comma-separated product IDs

filter[track-ids]

string

Comma-separated track IDs

filter[distributor-product-subgenre-ids]

string

Comma-separated distributor product subgenre IDs

filter[product-genre-ids]

string

Comma-separated product genre IDs

Successful response

object[]

Array of resource objects (override with specific resource schema)

object[]

Related resources included in the response

object

GET/videos

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

shell

Example Responses

No example specified for this content type

application/vnd.api+json

Create a video

POST

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

/videos

Create a new video content for distribution

Create a video › Request Body

object · required

Create a video › Responses

Video created successfully

object

The primary resource object (override with specific resource schema)

object[]

Related resources included in the response

object

POST/videos

curl --request POST \
  --url https://api.idol.io/api/v2/videos \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": {
    "type": "videos",
    "id": "id",
    "attributes": {
      "name": "name",
      "created-at": "2024-08-25T15:00:00Z",
      "updated-at": "2024-08-25T15:00:00Z",
      "crop": {},
      "isrc-audio": {},
      "isrc-video": {},
      "upc-code": {},
      "front-cover": {},
      "length": 0,
      "resolution": "resolution",
      "cover-url": "https://www.example.com/path/to/resource"
    },
    "relationships": {
      "label": {
        "data": {
          "type": "type",
          "id": "id"
        },
        "links": {
          "self": "https://www.example.com/path/to/resource",
          "related": "https://www.example.com/path/to/resource"
        }
      },
      "tracks": {
        "data": [
          {
            "type": "type",
            "id": "id"
          }
        ],
        "links": {
          "self": "https://www.example.com/path/to/resource",
          "related": "https://www.example.com/path/to/resource"
        },
        "meta": {}
      }
    }
  }
}
'

shell

Example Request Body

{
  "data": {
    "type": "videos",
    "id": "id",
    "attributes": {
      "name": "name",
      "created-at": "2024-08-25T15:00:00Z",
      "updated-at": "2024-08-25T15:00:00Z",
      "crop": {},
      "isrc-audio": {},
      "isrc-video": {},
      "upc-code": {},
      "front-cover": {},
      "length": 0,
      "resolution": "resolution",
      "cover-url": "https://www.example.com/path/to/resource"
    },
    "relationships": {
      "label": {
        "data": {
          "type": "type",
          "id": "id"
        },
        "links": {
          "self": "https://www.example.com/path/to/resource",
          "related": "https://www.example.com/path/to/resource"
        }
      },
      "tracks": {
        "data": [
          {
            "type": "type",
            "id": "id"
          }
        ],
        "links": {
          "self": "https://www.example.com/path/to/resource",
          "related": "https://www.example.com/path/to/resource"
        },
        "meta": {}
      }
    }
  }
}

json

Example Responses

No example specified for this content type

application/vnd.api+json

Get video details

GET

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

/videos/{id}

Retrieve details for a specific video by ID

Get video details › path Parameters

id

string · required

Resource ID

Get video details › Responses

Successful response

object

The primary resource object (override with specific resource schema)

object[]

Related resources included in the response

object

GET/videos/{id}

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

shell

Example Responses

No example specified for this content type

application/vnd.api+json

Update a video

PUT

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

/videos/{id}

Update an existing video

Update a video › path Parameters

id

string · required

Resource ID

Update a video › Request Body

object · required

Update a video › Responses

Video updated successfully

object

The primary resource object (override with specific resource schema)

object[]

Related resources included in the response

object

PUT/videos/{id}

curl --request PUT \
  --url https://api.idol.io/api/v2/videos/:id \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": {
    "type": "videos",
    "id": "id",
    "attributes": {
      "name": "name",
      "created-at": "2024-08-25T15:00:00Z",
      "updated-at": "2024-08-25T15:00:00Z",
      "crop": {},
      "isrc-audio": {},
      "isrc-video": {},
      "upc-code": {},
      "front-cover": {},
      "length": 0,
      "resolution": "resolution",
      "cover-url": "https://www.example.com/path/to/resource"
    },
    "relationships": {
      "label": {
        "data": {
          "type": "type",
          "id": "id"
        },
        "links": {
          "self": "https://www.example.com/path/to/resource",
          "related": "https://www.example.com/path/to/resource"
        }
      },
      "tracks": {
        "data": [
          {
            "type": "type",
            "id": "id"
          }
        ],
        "links": {
          "self": "https://www.example.com/path/to/resource",
          "related": "https://www.example.com/path/to/resource"
        },
        "meta": {}
      }
    }
  }
}
'

shell

Example Request Body

{
  "data": {
    "type": "videos",
    "id": "id",
    "attributes": {
      "name": "name",
      "created-at": "2024-08-25T15:00:00Z",
      "updated-at": "2024-08-25T15:00:00Z",
      "crop": {},
      "isrc-audio": {},
      "isrc-video": {},
      "upc-code": {},
      "front-cover": {},
      "length": 0,
      "resolution": "resolution",
      "cover-url": "https://www.example.com/path/to/resource"
    },
    "relationships": {
      "label": {
        "data": {
          "type": "type",
          "id": "id"
        },
        "links": {
          "self": "https://www.example.com/path/to/resource",
          "related": "https://www.example.com/path/to/resource"
        }
      },
      "tracks": {
        "data": [
          {
            "type": "type",
            "id": "id"
          }
        ],
        "links": {
          "self": "https://www.example.com/path/to/resource",
          "related": "https://www.example.com/path/to/resource"
        },
        "meta": {}
      }
    }
  }
}

json

Example Responses

No example specified for this content type

application/vnd.api+json

Delete a video

DELETE

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

/videos/{id}

Delete a video

Delete a video › path Parameters

id

string · required

Resource ID

Delete a video › Responses

Video deleted successfully

No data returned

DELETE/videos/{id}

curl --request DELETE \
  --url https://api.idol.io/api/v2/videos/:id

shell

Example Responses

No example specified for this content type

Tracks Records

Labelcamp API v2

Videos

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

Manage music video content with support for file uploads, ISRC codes, and track associations.

GET

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

/videos

Retrieve video content for distribution

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

filter[distributor-id]

string

Filter by distributor ID

filter[company-ids]

string

Comma-separated company IDs

filter[label-ids]

string

Comma-separated label IDs

filter[product-ids]

string

Comma-separated product IDs

filter[track-ids]

string

Comma-separated track IDs

filter[distributor-product-subgenre-ids]

string

Comma-separated distributor product subgenre IDs

filter[product-genre-ids]

string

Comma-separated product genre IDs

Successful response

object[]

Array of resource objects (override with specific resource schema)

object[]

Related resources included in the response

object

GET/videos

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

shell

Example Responses

No example specified for this content type

application/vnd.api+json

Create a video

POST

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

/videos

Create a new video content for distribution

Create a video › Request Body

object · required

Create a video › Responses

Video created successfully

object

The primary resource object (override with specific resource schema)

object[]

Related resources included in the response

object

POST/videos

curl --request POST \
  --url https://api.idol.io/api/v2/videos \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": {
    "type": "videos",
    "id": "id",
    "attributes": {
      "name": "name",
      "created-at": "2024-08-25T15:00:00Z",
      "updated-at": "2024-08-25T15:00:00Z",
      "crop": {},
      "isrc-audio": {},
      "isrc-video": {},
      "upc-code": {},
      "front-cover": {},
      "length": 0,
      "resolution": "resolution",
      "cover-url": "https://www.example.com/path/to/resource"
    },
    "relationships": {
      "label": {
        "data": {
          "type": "type",
          "id": "id"
        },
        "links": {
          "self": "https://www.example.com/path/to/resource",
          "related": "https://www.example.com/path/to/resource"
        }
      },
      "tracks": {
        "data": [
          {
            "type": "type",
            "id": "id"
          }
        ],
        "links": {
          "self": "https://www.example.com/path/to/resource",
          "related": "https://www.example.com/path/to/resource"
        },
        "meta": {}
      }
    }
  }
}
'

shell

Example Request Body

{
  "data": {
    "type": "videos",
    "id": "id",
    "attributes": {
      "name": "name",
      "created-at": "2024-08-25T15:00:00Z",
      "updated-at": "2024-08-25T15:00:00Z",
      "crop": {},
      "isrc-audio": {},
      "isrc-video": {},
      "upc-code": {},
      "front-cover": {},
      "length": 0,
      "resolution": "resolution",
      "cover-url": "https://www.example.com/path/to/resource"
    },
    "relationships": {
      "label": {
        "data": {
          "type": "type",
          "id": "id"
        },
        "links": {
          "self": "https://www.example.com/path/to/resource",
          "related": "https://www.example.com/path/to/resource"
        }
      },
      "tracks": {
        "data": [
          {
            "type": "type",
            "id": "id"
          }
        ],
        "links": {
          "self": "https://www.example.com/path/to/resource",
          "related": "https://www.example.com/path/to/resource"
        },
        "meta": {}
      }
    }
  }
}

json

Example Responses

No example specified for this content type

application/vnd.api+json

Get video details

GET

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

/videos/{id}

Retrieve details for a specific video by ID

Get video details › path Parameters

id

string · required

Resource ID

Get video details › Responses

Successful response

object

The primary resource object (override with specific resource schema)

object[]

Related resources included in the response

object

GET/videos/{id}

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

shell

Example Responses

No example specified for this content type

application/vnd.api+json

Update a video

PUT

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

/videos/{id}

Update an existing video

Update a video › path Parameters

id

string · required

Resource ID

Update a video › Request Body

object · required

Update a video › Responses

Video updated successfully

object

The primary resource object (override with specific resource schema)

object[]

Related resources included in the response

object

PUT/videos/{id}

curl --request PUT \
  --url https://api.idol.io/api/v2/videos/:id \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": {
    "type": "videos",
    "id": "id",
    "attributes": {
      "name": "name",
      "created-at": "2024-08-25T15:00:00Z",
      "updated-at": "2024-08-25T15:00:00Z",
      "crop": {},
      "isrc-audio": {},
      "isrc-video": {},
      "upc-code": {},
      "front-cover": {},
      "length": 0,
      "resolution": "resolution",
      "cover-url": "https://www.example.com/path/to/resource"
    },
    "relationships": {
      "label": {
        "data": {
          "type": "type",
          "id": "id"
        },
        "links": {
          "self": "https://www.example.com/path/to/resource",
          "related": "https://www.example.com/path/to/resource"
        }
      },
      "tracks": {
        "data": [
          {
            "type": "type",
            "id": "id"
          }
        ],
        "links": {
          "self": "https://www.example.com/path/to/resource",
          "related": "https://www.example.com/path/to/resource"
        },
        "meta": {}
      }
    }
  }
}
'

shell

Example Request Body

{
  "data": {
    "type": "videos",
    "id": "id",
    "attributes": {
      "name": "name",
      "created-at": "2024-08-25T15:00:00Z",
      "updated-at": "2024-08-25T15:00:00Z",
      "crop": {},
      "isrc-audio": {},
      "isrc-video": {},
      "upc-code": {},
      "front-cover": {},
      "length": 0,
      "resolution": "resolution",
      "cover-url": "https://www.example.com/path/to/resource"
    },
    "relationships": {
      "label": {
        "data": {
          "type": "type",
          "id": "id"
        },
        "links": {
          "self": "https://www.example.com/path/to/resource",
          "related": "https://www.example.com/path/to/resource"
        }
      },
      "tracks": {
        "data": [
          {
            "type": "type",
            "id": "id"
          }
        ],
        "links": {
          "self": "https://www.example.com/path/to/resource",
          "related": "https://www.example.com/path/to/resource"
        },
        "meta": {}
      }
    }
  }
}

json

Example Responses

No example specified for this content type

application/vnd.api+json

Delete a video

DELETE

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

/videos/{id}

Delete a video

Delete a video › path Parameters

id

string · required

Resource ID

Delete a video › Responses

Video deleted successfully

No data returned

DELETE/videos/{id}

curl --request DELETE \
  --url https://api.idol.io/api/v2/videos/:id

shell

Example Responses

No example specified for this content type

Tracks Records

Videos

List videos

List videos › query Parameters

List videos › Responses

Create a video

Create a video › Request Body

Create a video › Responses

Get video details

Get video details › path Parameters

Get video details › Responses

Update a video

Update a video › path Parameters

Update a video › Request Body

Update a video › Responses

Delete a video

Delete a video › path Parameters

Delete a video › Responses

Videos

List videos

List videos › query Parameters

List videos › Responses

Create a video

Create a video › Request Body

Create a video › Responses

Get video details

Get video details › path Parameters

Get video details › Responses

Update a video

Update a video › path Parameters

Update a video › Request Body

Update a video › Responses

Delete a video

Delete a video › path Parameters

Delete a video › Responses