Changelog

Last June, we introduced support for TikTok’s new Scanning service (TTS)— and it’s officially going live. This feature lets users set Monetize or BlockAccess policies on tracks used in UGC videos.

To comply with TikTok’s scanning policies, the following fields must be included per track:

• Track Origin – Composition Rights
• Track Properties – Recording Rights
• Monetization Policy:
  • Monetize – Allow monetized UGC usage
  • BlockAccess – Prevent UGC use entirely

Tracks without updates after the deadline will be excluded from scanning and monetization

Actions Required

• Update metadata and apply the appropriate policy
• Redeliver affected tracks only to TikTok (No additional distribution fees apply)

Deadlines

• 2025-03-31 Tiktok Deadline for the new Scanning service (TTS)

API documentation Release Notes have been updated and renamed to Changelog.

Actions Required

• No actions required

Deadlines

• No deadlines

Deezer is enforcing new contributor metadata requirements starting Q2 2025. Tracks missing required roles will be removed, along with associated albums.

• Instrumental Tracks must include:
  • Composer (RoleId: 2)
• Non-Instrumental Tracks must include either:
  • Composer (RoleId: 2) + Lyricist (RoleId: 4)
  • or Composer Lyricist (RoleId: 65)

Actions Required

• Update your metadata to match the new requirements.

Deadlines

• 2025-04-14 Global compliance deadline
• 2025-05-31 Brazil (BR country code) compliance deadline

A profileId of 0, null, or an absent entry in the artistExternalIds array will now be treated the same. The specific behavior of this empty state will differ depending on the store.

Any endpoints responding with an Artist Object will have its artistExternalIds array contain only existing external IDs. Values that were previously had "profileId": 0 will no longer appear in the array.

Actions Required

• Update your implementation relying on the returned Artist Object

Deadlines

• 2025-03-11

Added support for additional DSPs when it comes to providing Artist External IDs.

• Soundcloud (68)
• Meta (309)

Actions Required

• No actions required

Deadlines

• No deadlines

We no longer support testing on the staging environment. All of the examples and documentation were updated to reflect this change.

Please contact us to create a dedicated Sandbox account.

Actions Required

• Adjust your testing to use the sandbox account on the production environment

Deadlines

• 2025-02-05

We are removing support for redirecting to, and generally using, the outdated V1 Web Interface.

Actions Required

• Remove any references to the V1 Web Interface

Deadlines

• 2025-02-05

From this point forward the only supported url will be api.revelator.com

This is currently not a breaking change, but we recommend updating your code to use the primary url, as others might become deprecated in the future.

Actions Required

• Change the main URL across your implementation to api.revelator.com

Deadlines

• 2025-02-05

Added support for Engagement Analytics to the V3 Analytics. 📊

• Access by using the new engagement metric
• Track listener behavior with skip rates, completion rates, saves, and short-stream metrics
• Compatible with all existing filters and aggregation dimensions in the
• Part of our continuing effort to provide deeper streaming insights

Actions Required

• No actions required

Deadlines

• No deadlines

Dolby atmos is officially supported and ready to be distributed.

To supported this change, the Track Object has been updated. Explore the new changes directly on the Track Object and refer to the New track recording model section for more information.

Make sure you understand the limitations and cost associated with Dolby Atmos recordings before creating tracks. Read our Dolby Atmos Guide for more information.

Actions Required

• Review the new track recording model
• Read our Dolby Atmos Guide

Deadlines

• No deadlines

As part of our security hygiene and access protocol work, we’ve moved to a more secure token protocol and updated the related documentation accordingly.

The access token can only be provided in the Authorization header, and must be prefixed with the word “Bearer”. (Bearer token)

Actions Required

• Update your implementation to only authenticate using the Bearer token

Deadlines

• 2024-08-05

Added this previously undocumented field to the Artist Object.

Actions Required

• No actions required

Deadlines

• No deadlines

Newly documented Takedowns section.

Actions Required

• No actions required

Deadlines

• No deadlines

Added the Common Resources section in order to provide easy-access and overview of this type of data.

Actions Required

• No actions required

Deadlines

• No deadlines

New Monetization Policy changes introduced to reflect TikTok’s Monetization Changes

• Added monetization policies for TikTok. (NoTikTokScanning, Monetize, BlockAccess)
• A new field trackMonetizationPolicyIds available during Setting Distribution Options for track-level policies.

Actions Required

• Review the monetization policy section

Deadlines

• No deadlines

New fields/changes introduced to reflect TikTok’s Monetization Changes

• trackProperties is a new and required field on the Track Object.
• trackType is now a required field on the Track Object. This field also accepts a new value: 2 - Cover song

Actions Required

• Update your implementation of the affected endpoints

Deadlines

• 2024-07-15 Implementation deadline

Attemnts to distribute to stores containing the isActive == false will now fail.

Actions Required

• Make sure you are not trying to deliver to any inactive stores

Deadlines

• 2024-05-22

Added the (Beta) API support for user invites.

Actions Required

• No actions required

Deadlines

• No deadlines

Composer/Writer details on tracks missing either a valid first and last artist name are no longer allowed for distribution.

Actions Required

• Make sure you are providing the first and last name for all Composers/Writers

Deadlines

• 2024-05-15

Tracks that are less than 2 seconds long are no longer allowed for distribution. Any attempt at distributing or uploading these tracks will fail.

Actions Required

• Make sure you arenot trying to distribute short tracks

Deadlines

• 2024-05-15

Added a Glossary page containing most used terms.

Actions Required

• No actions required

Deadlines

• No deadlines

Royalty tokens are now supported and documented.

Actions Required

• No actions required

Deadlines

• No deadlines

Distribution statuses updated.

• New statuses for takedowns (72, 75, 76, 79)
• Old statuses updated (8, 10, 11)

Actions Required

• If you implementation is rellying on any of the changed statuses, make sure you update it accordingly.

Deadlines

• 2024-03-20

The endpoint examples are now back after the documentation migration.

Actions Required

• No actions required

Deadlines

• No deadlines

Tipalti integration added to Revelator. By completing the following flows you will be able to pay your payees using this feature:

• Payor Flow - Connect your Tipalti Account with your Revelator Parent Account
• Payee Flow - Set up a payee to receive money via Tipalty

Actions Required

• No actions required

Deadlines

• No deadlines

• New look and feel
• New URL api-docs.revelator.com
• Ability to search through the documentation (CTRL + K)

Actions Required

• Start using the new API documentation on a new URL

Deadlines

• No deadlines

Using an externalUrl to associate files with a track/release is no longer recommended! Files referenced like this are not being downloaded by our system until distribution, leading to unexpected behavior. Use the endpoints mentioned above for all file uploading needs.

Actions Required

• Update your implementation to no longer utilize externalUrl for track/release audio files
• Use the new endpoints for uploading files instead

Deadlines

• 2023-11-11

Newly documented endpoints for uploading files

• POST /media/audio/upload/wav - Upload a file in wav format to the Revelator servers
• POST /media/image/upload - Upload an image file to the Revelator servers
• POST /media/audio/pullexternal/wav - Pull a file in wav format from an external url to the Revalator servers

Actions Required

• No actions required

Deadlines

• No deadlines

POST /account/createnewaccount' - endpoint is now deprecated. This is done to mitigate confusion for creating new accounts.

Actions Required

• Use the documented ways of creating accounts instead

Deadlines

• 2023-09-26

Enterprise information endpoints:

• GET /enterprise/clients/{id} - Retrieves basic information about a single enterprise
• GET /enterprise/clients/all - Retrieves basic information about all enterprises associated with the account

Actions Required

• No actions required

Deadlines

• No deadlines