Labelcamp API v2

Company management and organization structure. Companies represent business entities that own labels and manage music catalog. A company belongs to a distributor and can have multiple labels associated with it. Use companies to organize your catalog hierarchically within the distributor structure.

Label management and configuration

Albums and releases management.

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

Records represent the actual audio files (WAV, FLAC, etc.) that are used as masters for track distribution. Each record has a master type (CD quality, HD, Dolby Atmos) and precision level.

Models an artist in Labelcamp. If several artists have the same name, the one with the highest priority will be selected by default by the application when an album is set to "active" status.

Managing Artists

Artist Association Mechanism

When a product becomes "active", Labelcamp automatically:

1. Searches for an artist resource for each artist/contributor name
2. Chooses the artist with the highest priority
3. Creates a new artist with priority "1" if no existing match is found
4. Associates the artist as a role with the product and track

Key Features

• Multiple DSP IDs: Artists can have multiple Digital Service Provider IDs through "availabilities"
• Duplicate Names: Supports multiple artists with the same name
• Proactive Creation: Allows creating artists in advance to control future release associations

Best Practices

• Set Default Artist: Assign the highest priority to the "default" artist to ensure correct future associations
• Create in Advance: Create artist resources before creating albums for better control
• Update Associations: To update artist associations on an existing product:
  1. Set the album status to "draft"
  2. Set it back to "active" to reprocess artist roles

Proactively managing artist resources ensures accurate metadata and DSP integrations across all releases.

Retrieve a complete list of roles used in the application for artists on products and tracks. Artist roles define the specific function or instrument played by an artist on a product or track (e.g., Actor, Accordion, Acoustic Guitar, Vocals, Producer). These roles can be used when creating or updating products and tracks to specify artist contributions.

Audio file uploads and processing tasks

Product delivery tasks to DSPs. Priorities: normal (default), urgent (higher priority), next (immediate, bypasses validations, limited to 1,000/day) Our smart prioritization system automatically and efficiently organizes deliveries by urgency, even when handling large volumes of content delivered simultaneously. Normal priority is the default level, strongly recommended for most SendTasks. Urgent priority ranks higher than Normal. Next priority ensures the SendTask is processed immediately, ahead of all other waiting deliveries. However, Next should be used only in exceptional cases for last-minute, critical deliveries, as excessive use may disrupt the prioritization system. This priority is subject to a daily quota of 1,000 SendTasks. Important Note: Selecting "Next" ignores all validations on product, offer, and DSP. The product will be delivered immediately. This action is performed under your responsibility.

Send task factory management for bulk distribution operations. Delivery types: delivery, update, redelivery, delete Key features:

• Bulk send task creation
• Track counts by status (completed, waiting, sending, error, stuck)
• Configure send dates, release dates, UPCs, and comments

Efficiently manage large-scale distribution operations across multiple platforms.

Models marketing items that can be attached to products, like Apple Motion Arts. Supported formats:

• apple_motion_art_mobile: Mobile format (3:4 aspect ratio)
• apple_motion_art_desktop: Desktop format (1:1 aspect ratio)

Currently supported attachable types: Product only Asset attachments allow you to associate additional media assets with products for enhanced presentation on digital platforms.

Links video content to tracks for music video distribution across DSPs.

Release configurations including release dates, pricing, territories, and platform selections. Each product can have multiple offers for different markets or release windows.

Track-level release configurations and availability settings. The track-price-code attribute is a DistributorPriceCode object with a is-track-price attribute set to true. It is only optional in the TrackOffer, if left blank the track-price-code set in the Offer will apply. Same as above applies for genre attribute.

Distribution rights management. Configure which territories and DSPs can distribute your content. Actions include "add", "remove", or "clear" rights.

Manage availability information for artists, products, and tracks on Digital Service Providers (DSPs). Availabilities track the presence and external identifiers of your content on various streaming platforms, including:

• External identifiers (e.g., Spotify IDs, Apple Music IDs)
• Platform-specific URLs
• Territory-specific availability

Supported item types: Artist, Product, Track Use this resource to link your internal content to external platform identifiers for tracking and integration purposes.

Digital Service Providers (Spotify, Apple Music, etc.)

Digital Service Provider upload configuration details. Additional track options are available for these DSPs:

• Amazon
• Anghami
• Beatport
• Deezer
• Facebook
• Facebook Fingerprint
• Facebook Library
• Juno Download
• Kkbox
• Napster
• Pandora
• Playzer
• Soundcloud
• Spotify
• Tidal
• Tiktok
• Youtube Art Track
• Youtube Content ID

Track the availability status of products on Digital Service Providers. Relationships: availabilities, dsp, product Manage and monitor the current distribution status of products across various streaming platforms.

Retail platform information. Examples: Apple Music, Spotify, Instagram Reference data for digital retail platforms and streaming services.

AppleArtist resource allows listing and creating artist representations specific to Apple Music platform. The AppleArtist resource links your artists to Apple Music's catalog, providing Apple-specific metadata like genre classification and locale information.

Spotify-specific artist information and identifiers.

Used for specifying audio languages, lyric languages, and content localization.

Product type classification. Available types: Album, Single, EP, Video Defines the format and type of music releases.

Music genre classification for products. Examples: "Pop / Rock / Indie", "French Pop", "Electronic Music" Primary genre categorization used for organizing and classifying music products.

Detailed music subgenre classification for products. Provides granular subgenre categorization (e.g., "Pop - Rock: Alternative - Indie", "Electronic Music - Techno") for precise music classification.

Price code management for distributors. Price codes define pricing tiers for tracks and albums across different territories and platforms.

Geographic territory information for distribution rights and availability.

Geographic continent information for distribution and rights management. Available continents include WW (Worldwide), Europe, Africa, and other major geographical regions used for organizing territories and distribution rights.

Track playlists across streaming platforms.

Flexible tagging system for organizing products and other resources.

Asynchronous data export jobs for trends and analytics data. Workflow:

1. Create an extract job via POST /extracts with the desired parameters
2. Poll GET /extracts/{id} to check the job status
3. When result-url is populated, download the generated file

Supported extract types:

• daily-trends - Daily streaming and sales trends data

Output formats:

• CSV

User account management and authentication. Use /users/me to retrieve the currently authenticated user's details.

Group (account/organization) management. Groups represent organizational units within Labelcamp. They can be nested (parent/child), have expiration dates, and control access to resources through ACLs.

Distributor account management and configuration. Distributors are the top-level organizational entities in the Labelcamp hierarchy, managing companies, labels, and distribution rights.

Usage quotas and limits for distributor accounts.

Distributor-specific customization settings and configurations. Retrieve customization settings specific to your distributor account.