Changelog

Starting July 29, 2026, the releasesCount and tracksCount fields will be removed from artist responses across all affected endpoints.

These fields were previously exposed as part of the artist object but are no longer reliable and have been removed to prevent incorrect or inconsistent data usage.

Updates the behavior of Facebook DSP profile handling through the externalIds property.

Previously, providing only one Facebook profile automatically created the corresponding entry for the other profile. Starting July 29, 2026, both Facebook profile entries must be managed together. Omitting either entry will be treated as an instruction to remove the corresponding profile association.

Introduces the Artists endpoints to manage individual and group act metadata. These endpoints supports rich profile data including biographies, localizations, and social media links. It also features robust management of External Artist IDs for DSP profile mapping (preventing catalog fragmentation on platforms like Apple, Spotify, and Meta) and support for the Spotify Artist Profile Protection key.

The labelId property is no longer required when creating or updating physical releases. If a label is not applicable to your release, you can now safely omit this field from your request payload or pass null.

Introduces the read-only YouTube API. These endpoints allow you to search, filter, and retrieve rich metadata and performance statistics for YouTube channels and videos that have been synced with your Revelator account.

We have updated the global API rate limiting policy to provide a smoother developer experience and more accurate traffic measurement.

• Rolling Window: The 200 requests/minute limit is now evaluated using a continuous 60-second rolling window instead of a fixed calendar-minute window.
• Reduced Ban Time: If the rate limit is exceeded, the temporary IP block (resulting in 429 Too Many Requests) has been reduced from 1 hour down to 10 minutes.

You can now subscribe to our API Changelog via RSS!

If you want to stay informed about breaking changes, new endpoints, and platform updates in real-time, you can plug our RSS feed into your favorite RSS reader, Slack workspace, or automated notification workflow.

To subscribe, click the RSS Feed button at the top of the changelog page, or point your reader directly to https://api-docs.revelator.com/v2/rss.xml.

To ensure platform stability and performance, we have introduced a global rate limit for the V2.0 API.

The API now strictly enforces a limit of 200 requests per minute per IP address (evaluated on a fixed 1-minute window). If this limit is exceeded, the offending IP address will be temporarily blocked for 1 hour. Any requests made during this ban period will be rejected with a standard HTTP 429 Too Many Requests response.

We strongly recommend implementing exponential backoff in your API clients to prevent unintended bans during bulk operations.

Introduces a new multipart upload workflow for securely uploading binary files (audio, video, images, and documents). This API allows for optional chunk splitting and parallel uploads to significantly increase upload speeds. Files uploaded via these endpoints generate a fileUrl that can be referenced across V2.0 API payloads.

We are excited to introduce our new Model Context Protocol (MCP) servers in Public Beta. This suite of five servers (Catalog, Supply Chain, Analytics, Royalties, and Blockchain) enables you to securely connect AI assistants (like Claude Desktop) directly to your Revelator data.

By configuring these servers, your LLMs can use natural language to query catalog metadata, analyze Top Movers and revenue, manage physical releases, and more.

Note: Our MCP Servers are currently in BETA. They are under active development and are subject to breaking changes - some tools can result in 403 Forbidden or other errors.

Introduces the Physical Releases API to manage metadata for physical music and video products (e.g., Vinyl, CD, DVD, Blu-ray). This API allows you to link existing digital catalog assets to physical product formats based on category-specific configurations. Note: This is a metadata-only feature and does not support manufacturing, inventory, or physical supply chain workflows.

Introduces the Top Movers analytics endpoint. This API allows you to retrieve rising and falling trends across specific dimensions (labels, artists, releases, tracks, DSPs, and markets). It calculates stream and revenue momentum by comparing specific periods (daily, weekly, monthly, quarterly, yearly) against their preceding equivalent periods. Built-in thresholds automatically filter out low-volume statistical noise.

The request body structure has been updated to align with the GET response format. You must now submit policies within a monetizationPolicies array of objects (e.g., { "monetizationPolicyId": 5 }) rather than a simple array of integers.

The request body structure has been updated to align with the GET response format. Instead of a flat array of IDs, you must now group prices by distributorStoreId and separate them into trackPrices and releasePrices arrays.

Enables granular management of monetization policies. Unlike previous API versions, this update supports setting unique policies for individual tracks across specific UGC stores (YouTube Content ID, TikTok, Facebook).

New endpoints to retrieve and configure pricing. The API now dynamically filters available pricing options based on the release’s audio quality (Bit Depth/Sample Rate) and specific DSP configuration.

Introduces new endpoints to manage Streaming, Download, and UGC rights. This API allows for granular control, including setting specific download permissions at the release level and full rights management at the individual track level.

Introduces a new structure for defining Availability Rules. You can now define precise inclusion and exclusion logic for specific territories and DSPs at both the Release and Track levels.