<?xml version="1.0" encoding="UTF-8"?><rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>Revelator API Documentation</title><description>A developer help center for anyone looking to use the Revelator API and bring their music business to the next level.</description><link>https://api-docs-stage.revelator.com/v2</link><language>en-us</language><item><title>[NEW] Monetization Policies</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-02-25</link><guid isPermaLink="false">changelog-2026-02-25/monetization-policies-endpoints</guid><pubDate>Wed, 25 Feb 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;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).&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Territories Clearances</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-02-25</link><guid isPermaLink="false">changelog-2026-02-25/territories-clearances-endpoints</guid><pubDate>Wed, 25 Feb 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;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.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Release Rights</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-02-25</link><guid isPermaLink="false">changelog-2026-02-25/release-rights-endpoints</guid><pubDate>Wed, 25 Feb 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;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.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Pricing Tiers</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-02-25</link><guid isPermaLink="false">changelog-2026-02-25/pricing-tiers-endpoints</guid><pubDate>Wed, 25 Feb 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;New endpoints to retrieve and configure pricing. The API now dynamically filters available pricing options based on the
release&apos;s audio quality (Bit Depth/Sample Rate) and specific DSP configuration.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Files API (Multipart Upload)</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-03-25</link><guid isPermaLink="false">changelog-2026-03-25/files-upload-endpoints</guid><pubDate>Wed, 25 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;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 &lt;code&gt;fileUrl&lt;/code&gt; that can be referenced across V2.0 API payloads.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Model Context Protocol (MCP) Servers (Beta)</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-03-25</link><guid isPermaLink="false">changelog-2026-03-25/mcps</guid><pubDate>Wed, 25 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;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.&lt;/p&gt;
&lt;p&gt;By configuring these servers, your LLMs can use natural language to query catalog metadata, analyze Top Movers and
revenue, manage physical releases, and more.&lt;/p&gt;
&lt;p&gt;&lt;em&gt;Note: Our MCP Servers are currently in &lt;strong&gt;BETA&lt;/strong&gt;. They are under active development and are subject to breaking
changes - some tools can result in &lt;code&gt;403 Forbidden&lt;/code&gt; or other errors.&lt;/em&gt;&lt;/p&gt;
</content:encoded></item><item><title>[BREAKING] Pricing Tiers Update</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-03-04</link><guid isPermaLink="false">changelog-2026-03-04/pricing-tiers-body-change</guid><pubDate>Wed, 04 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;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 &lt;code&gt;distributorStoreId&lt;/code&gt; and separate them into &lt;code&gt;trackPrices&lt;/code&gt; and &lt;code&gt;releasePrices&lt;/code&gt; arrays.&lt;/p&gt;
</content:encoded></item><item><title>[BREAKING] Monetization Policies Update</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-03-04</link><guid isPermaLink="false">changelog-2026-03-04/monetization-policies-body-change</guid><pubDate>Wed, 04 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;The request body structure has been updated to align with the GET response format. You must now submit policies within a
&lt;code&gt;monetizationPolicies&lt;/code&gt; array of objects (e.g., &lt;code&gt;{ &quot;monetizationPolicyId&quot;: 5 }&lt;/code&gt;) rather than a simple array of integers.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Top Movers Analytics</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-03-12</link><guid isPermaLink="false">changelog-2026-03-12/top-movers</guid><pubDate>Thu, 12 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;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.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Physical Releases API</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-03-25</link><guid isPermaLink="false">changelog-2026-03-25/physical-releases-endpoints</guid><pubDate>Wed, 25 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;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.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Global API Rate Limiting</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-03-31</link><guid isPermaLink="false">changelog-2026-03-31/global-rate-limiting</guid><pubDate>Tue, 31 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;To ensure platform stability and performance, we have introduced a global rate limit for the V2.0 API.&lt;/p&gt;
&lt;p&gt;The API now strictly enforces a limit of &lt;strong&gt;200 requests per minute per IP address&lt;/strong&gt; (evaluated on a fixed 1-minute
window). If this limit is exceeded, the offending IP address will be temporarily blocked for &lt;strong&gt;1 hour&lt;/strong&gt;. Any requests
made during this ban period will be rejected with a standard HTTP &lt;code&gt;429 Too Many Requests&lt;/code&gt; response.&lt;/p&gt;
&lt;p&gt;We strongly recommend implementing exponential backoff in your API clients to prevent unintended bans during bulk
operations.&lt;/p&gt;
</content:encoded></item><item><title>[DOCS] Changelog RSS Feed</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-04-09</link><guid isPermaLink="false">changelog-2026-04-09/rss-feed</guid><pubDate>Thu, 09 Apr 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;You can now subscribe to our API Changelog via RSS!&lt;/p&gt;
&lt;p&gt;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.&lt;/p&gt;
&lt;p&gt;To subscribe, click the &lt;strong&gt;RSS Feed&lt;/strong&gt; button at the top of the changelog page, or point your reader directly to
&lt;code&gt;https://api-docs.revelator.com/v2/rss.xml&lt;/code&gt;.&lt;/p&gt;
</content:encoded></item><item><title>[CHANGE] API Rate Limiting Policy Update</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-04-14</link><guid isPermaLink="false">changelog-2026-04-14/reduced-ban-on-rate-limiter</guid><pubDate>Tue, 14 Apr 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;We have updated the global API rate limiting policy to provide a smoother developer experience and more accurate traffic
measurement.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Rolling Window:&lt;/strong&gt; The 200 requests/minute limit is now evaluated using a continuous 60-second rolling window instead
of a fixed calendar-minute window.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Reduced Ban Time:&lt;/strong&gt; If the rate limit is exceeded, the temporary IP block (resulting in &lt;code&gt;429 Too Many Requests&lt;/code&gt;) has
been reduced from &lt;strong&gt;1 hour&lt;/strong&gt; down to &lt;strong&gt;10 minutes&lt;/strong&gt;.&lt;/li&gt;
&lt;/ul&gt;
</content:encoded></item><item><title>[NEW] YouTube API Endpoints</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-04-22</link><guid isPermaLink="false">changelog-2026-04-22/youtube-endpoints</guid><pubDate>Wed, 22 Apr 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;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.&lt;/p&gt;
</content:encoded></item><item><title>[CHANGE] labelId is now optional for Physical Releases</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-05-27</link><guid isPermaLink="false">changelog-2026-05-27/labelid-optional-on-physical-releases</guid><pubDate>Wed, 27 May 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;The &lt;code&gt;labelId&lt;/code&gt; 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 &lt;code&gt;null&lt;/code&gt;.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Artists Endpoints</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-07-01</link><guid isPermaLink="false">changelog-2026-07-01/artists-endpoints</guid><pubDate>Wed, 01 Jul 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;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.&lt;/p&gt;
</content:encoded></item><item><title>[CHANGE] Facebook DSP Profile Update Behavior</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-07-02</link><guid isPermaLink="false">changelog-2026-07-02/facebook-dsps-profiles-change</guid><pubDate>Thu, 02 Jul 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Updates the behavior of Facebook DSP profile handling through the &lt;code&gt;externalIds&lt;/code&gt; property.&lt;/p&gt;
&lt;p&gt;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.&lt;/p&gt;
</content:encoded></item><item><title>[CHANGE] Removal of Artist Release and Track Count Fields</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-07-06</link><guid isPermaLink="false">changelog-2026-07-06/removing-counts-from-artists</guid><pubDate>Mon, 06 Jul 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Starting July 29, 2026, the &lt;code&gt;releasesCount&lt;/code&gt; and &lt;code&gt;tracksCount&lt;/code&gt; fields will be removed from artist responses across all
affected endpoints.&lt;/p&gt;
&lt;p&gt;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.&lt;/p&gt;
</content:encoded></item><item><title>[CHANGE] New Filters for Physical Release Listings</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-08-27</link><guid isPermaLink="false">changelog-2026-08-27/physical-releases-list-filters</guid><pubDate>Thu, 27 Aug 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Added &lt;code&gt;physicalReleaseIds&lt;/code&gt;, &lt;code&gt;assetIds&lt;/code&gt;, &lt;code&gt;artistIds&lt;/code&gt;, and &lt;code&gt;labelIds&lt;/code&gt; filters to physical release listings.&lt;/p&gt;
&lt;p&gt;See &lt;a href=&quot;/v2/en/catalog/physical-releases&quot;&gt;Physical Releases&lt;/a&gt;.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Pre-Distribution Validation Endpoints</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-08-27</link><guid isPermaLink="false">changelog-2026-08-27/validation-endpoints</guid><pubDate>Thu, 27 Aug 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Added validation endpoints for checking a release without changing anything. &lt;code&gt;deliver/validate&lt;/code&gt; reports what would
block distribution; &lt;code&gt;takedown/validate&lt;/code&gt; reports whether the release can be taken down from the given stores. Both
return &lt;code&gt;hasBlockingErrors&lt;/code&gt;, which is the same flag the corresponding action checks—&lt;code&gt;false&lt;/code&gt; means that action will not
be rejected by validation.&lt;/p&gt;
&lt;p&gt;See &lt;a href=&quot;/v2/en/supply-chain/validations&quot;&gt;Validations&lt;/a&gt;.&lt;/p&gt;
</content:encoded></item><item><title>[CHANGE] Preview Start Seconds Update</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-09-25</link><guid isPermaLink="false">changelog-2026-09-25/preview-start-seconds</guid><pubDate>Fri, 25 Sep 2026 00:00:00 GMT</pubDate><content:encoded>&lt;hr /&gt;
&lt;p&gt;&lt;code&gt;previewStartSeconds&lt;/code&gt; can now be set to &lt;code&gt;0&lt;/code&gt;. Previously, the value had to be &lt;code&gt;null&lt;/code&gt; or greater than &lt;code&gt;0&lt;/code&gt;.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Composers Endpoints</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-09-23</link><guid isPermaLink="false">changelog-2026-09-23/composers-endpoints</guid><pubDate>Wed, 23 Sep 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Introduces the Composers endpoints to manage writer identities referenced from tracks.&lt;/p&gt;
&lt;p&gt;See &lt;a href=&quot;/v2/en/catalog/composers&quot;&gt;Composers&lt;/a&gt;.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Delivery &amp; Takedown Endpoints</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-09-23</link><guid isPermaLink="false">changelog-2026-09-23/delivery-takedown-endpoints</guid><pubDate>Wed, 23 Sep 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Introduces the endpoints that move a release onto stores and back off again. Both take a list of &lt;code&gt;distributorStoreIds&lt;/code&gt; and return a bare boolean meaning the request was accepted—not that the work is done.&lt;/p&gt;
&lt;p&gt;Delivering does not publish a release: it submits the release into the inspection queue, where an inspector from your organization must approve it in the Revelator UI before anything is packaged and sent to a DSP.&lt;/p&gt;
&lt;p&gt;See &lt;a href=&quot;/v2/en/supply-chain/delivery-takedown&quot;&gt;Delivery &amp;amp; Takedown&lt;/a&gt;.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Labels Endpoints</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-09-23</link><guid isPermaLink="false">changelog-2026-09-23/labels-endpoints</guid><pubDate>Wed, 23 Sep 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Introduces the Labels endpoints to manage record label profiles referenced from releases, tracks, and artists.&lt;/p&gt;
&lt;p&gt;See &lt;a href=&quot;/v2/en/catalog/labels&quot;&gt;Labels&lt;/a&gt;.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Date-Range Filters Added to Catalog Listings</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-09-23</link><guid isPermaLink="false">changelog-2026-09-23/last-update-date-filters</guid><pubDate>Wed, 23 Sep 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;&lt;code&gt;lastUpdateDateFrom&lt;/code&gt; and &lt;code&gt;lastUpdateDateTo&lt;/code&gt; are now available on physical release and artists listings. Both take a UTC
date-time and filter on when the record was last modified, which makes incremental catalog syncs possible without paging
the full collection.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Publishers Endpoints</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-09-23</link><guid isPermaLink="false">changelog-2026-09-23/publishers-endpoints</guid><pubDate>Wed, 23 Sep 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Introduces the Publishers endpoints to manage the publishers referenced from tracks as the rights holder behind a composer&apos;s share.&lt;/p&gt;
&lt;p&gt;See &lt;a href=&quot;/v2/en/catalog/publishers&quot;&gt;Publishers&lt;/a&gt;.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Releases Endpoints</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-09-23</link><guid isPermaLink="false">changelog-2026-09-23/releases-endpoints</guid><pubDate>Wed, 23 Sep 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Introduces the Releases endpoints to manage the releases that group catalog assets for distribution.&lt;/p&gt;
&lt;p&gt;See &lt;a href=&quot;/v2/en/catalog/releases&quot;&gt;Releases&lt;/a&gt;.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Track &amp; Video Validation</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-09-23</link><guid isPermaLink="false">changelog-2026-09-23/track-video-validation</guid><pubDate>Wed, 23 Sep 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Adds single-asset validation for tracks and videos, complementing the release-level &lt;code&gt;deliver/validate&lt;/code&gt; and &lt;code&gt;takedown/validate&lt;/code&gt; endpoints. Each checks the asset&apos;s own metadata—identifiers, without evaluating the release it belongs to. This makes it possible to check a track or video while it is still being prepared, before it is added to a release.&lt;/p&gt;
&lt;p&gt;See &lt;a href=&quot;/v2/en/supply-chain/validations&quot;&gt;Validations&lt;/a&gt;.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Tracks Endpoints</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-09-23</link><guid isPermaLink="false">changelog-2026-09-23/tracks-endpoints</guid><pubDate>Wed, 23 Sep 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Introduces the Tracks endpoints to manage individual audio recordings and the credits attached to them.&lt;/p&gt;
&lt;p&gt;See &lt;a href=&quot;/v2/en/catalog/tracks&quot;&gt;Tracks&lt;/a&gt;.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Video Rights</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-09-23</link><guid isPermaLink="false">changelog-2026-09-23/video-rights-endpoints</guid><pubDate>Wed, 23 Sep 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Extends rights management to videos. Streaming, Download, and UGC rights can now be read and set per video, alongside the track- and release-level rights already available.&lt;/p&gt;
&lt;p&gt;See &lt;a href=&quot;/v2/en/catalog/rights&quot;&gt;Rights&lt;/a&gt;.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Videos Endpoints</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-09-23</link><guid isPermaLink="false">changelog-2026-09-23/videos-endpoints</guid><pubDate>Wed, 23 Sep 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Introduces the Videos endpoints, making video a first-class catalog asset with its own metadata, credits, and rights. Videos are distributed by assigning them to a release exactly like tracks.&lt;/p&gt;
&lt;p&gt;See &lt;a href=&quot;/v2/en/catalog/videos&quot;&gt;Videos&lt;/a&gt;.&lt;/p&gt;
</content:encoded></item><item><title>[CHANGE] Audio File Size Limit Increased to 5 GB</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-10-12</link><guid isPermaLink="false">changelog-2026-10-12/audio-file-size-increase</guid><pubDate>Mon, 12 Oct 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;The maximum file size for audio uploads has increased to 5 GB.&lt;/p&gt;
</content:encoded></item><item><title>[CHANGE] Video File Size Limit Increased to 30 GB</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-10-12</link><guid isPermaLink="false">changelog-2026-10-12/video-file-size-increasemdx</guid><pubDate>Mon, 12 Oct 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;The maximum file size for video uploads has increased to 30 GB.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Artificial Streams Analytics Endpoints</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-10-28</link><guid isPermaLink="false">changelog-2026-10-28/analytics-artificial-streams-endpoints</guid><pubDate>Wed, 28 Oct 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Introduces the Artificial Streams analytics endpoints. Report streams flagged as artificial, flagged assets, and fines
by track, release, artist, label, country, DSP, client, or date, and compare artificial streams per client against a
previous period with the dashboard endpoint.&lt;/p&gt;
&lt;p&gt;See &lt;a href=&quot;/v2/en/analytics/artificial-streams&quot;&gt;Artificial Streams&lt;/a&gt;.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Consumption and Engagement Analytics Endpoints</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-10-28</link><guid isPermaLink="false">changelog-2026-10-28/analytics-consumption-engagement-endpoints</guid><pubDate>Wed, 28 Oct 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Introduces the Consumption and Engagement analytics endpoints. Use &lt;code&gt;mediaType&lt;/code&gt; to read streaming data (streams,
downloads, saves, skips, completions) or user-generated content data (views, creations, likes, shares, comments, watch
time), and group it with the &lt;code&gt;dimension&lt;/code&gt; parameter—including source of stream and discovery type. Consumption time
series also include an estimated revenue figure.&lt;/p&gt;
&lt;p&gt;See &lt;a href=&quot;/v2/en/analytics/consumption&quot;&gt;Consumption&lt;/a&gt; and &lt;a href=&quot;/v2/en/analytics/engagement&quot;&gt;Engagement&lt;/a&gt;.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Playlist Analytics Endpoints</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-10-28</link><guid isPermaLink="false">changelog-2026-10-28/analytics-playlists-endpoints</guid><pubDate>Wed, 28 Oct 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Introduces the Playlist analytics endpoints. Report playlist streams, playlist counts, followers, and track counts by
playlist, playlist type, DSP, or country, and list the tracks added to, removed from, or active on playlists over the
last 7, 14, or 28 days.&lt;/p&gt;
&lt;p&gt;See &lt;a href=&quot;/v2/en/analytics/playlists&quot;&gt;Playlists&lt;/a&gt;.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Revenue Analytics Endpoint</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-10-28</link><guid isPermaLink="false">changelog-2026-10-28/analytics-revenue-endpoint</guid><pubDate>Wed, 28 Oct 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Introduces a single Revenue analytics endpoint. Choose how streams, downloads, and earnings are grouped with the
&lt;code&gt;dimension&lt;/code&gt; parameter—track, release, artist, label, country, DSP, delivery type, asset type, YouTube channel,
YouTube video, or date—and split the results by month or year with &lt;code&gt;dateGranularity&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;See &lt;a href=&quot;/v2/en/analytics/revenue&quot;&gt;Revenue&lt;/a&gt; and the &lt;a href=&quot;/v2/en/analytics/overview&quot;&gt;Analytics Overview&lt;/a&gt;.&lt;/p&gt;
</content:encoded></item><item><title>[BREAKING] Recording Properties Required on Tracks</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-10-28</link><guid isPermaLink="false">changelog-2026-10-28/tracks-recording-properties-required</guid><pubDate>Wed, 28 Oct 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;From &lt;strong&gt;November 25, 2026&lt;/strong&gt;, &lt;code&gt;recordingProperties&lt;/code&gt; becomes a required field when creating or updating a track. Requests
that omit it, or send it empty, will be rejected.&lt;/p&gt;
&lt;p&gt;Include at least one value—use &lt;code&gt;none&lt;/code&gt; when no other property applies, or &lt;code&gt;undeclared&lt;/code&gt; if it is not yet specified. See
&lt;a href=&quot;https://helpdesk.revelator.com/support/solutions/articles/69000856124&quot;&gt;Track Origin &amp;amp; Track Properties&lt;/a&gt; for the
available values.&lt;/p&gt;
&lt;p&gt;See &lt;a href=&quot;/v2/en/catalog/tracks&quot;&gt;Tracks&lt;/a&gt;.&lt;/p&gt;
</content:encoded></item><item><title>[CHANGE] Locked Fields on Partially Locked Tracks and Videos</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-10-28</link><guid isPermaLink="false">changelog-2026-10-28/trackvendorid-and-catalog-locked-when-asset-is-partially-locked</guid><pubDate>Wed, 28 Oct 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;&lt;code&gt;trackVendorId&lt;/code&gt; on tracks and &lt;code&gt;catalog&lt;/code&gt; on videos can no longer be changed when the asset&apos;s &lt;code&gt;lockLevel&lt;/code&gt; is
&lt;code&gt;partiallyLocked&lt;/code&gt;. Previously, these fields stayed editable.&lt;/p&gt;
&lt;p&gt;An asset is partially locked when any release it appears on is partially locked, which happens once that release has
been distributed to at least one store.&lt;/p&gt;
&lt;p&gt;See &lt;a href=&quot;/v2/en/catalog/tracks#track-locking&quot;&gt;Track Locking&lt;/a&gt; and &lt;a href=&quot;/v2/en/catalog/videos#video-locking&quot;&gt;Video Locking&lt;/a&gt;.&lt;/p&gt;
</content:encoded></item><item><title>[CHANGE] Payee Filter for Video Listings</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-10-28</link><guid isPermaLink="false">changelog-2026-10-28/videos-payee-filter</guid><pubDate>Wed, 28 Oct 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Added the &lt;code&gt;payeeIds&lt;/code&gt; filter to video listings.&lt;/p&gt;
&lt;p&gt;See &lt;a href=&quot;/v2/en/catalog/videos&quot;&gt;Videos&lt;/a&gt;.&lt;/p&gt;
</content:encoded></item><item><title>[BREAKING] Sale Date Columns Removed from Releases Export</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-11-04</link><guid isPermaLink="false">changelog-2026-11-04/releases-export-sale-date-columns-removed</guid><pubDate>Wed, 04 Nov 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;From &lt;strong&gt;November 28, 2026&lt;/strong&gt;, the Export Releases CSV no longer includes the &lt;code&gt;SaleStartDate&lt;/code&gt; and &lt;code&gt;SalePreOrderDate&lt;/code&gt;
columns. All other columns are unchanged.&lt;/p&gt;
&lt;p&gt;See &lt;a href=&quot;/v2/en/catalog/releases#export-releases&quot;&gt;Export Releases&lt;/a&gt; and &lt;a href=&quot;/v2/en/supply-chain/sale-start-dates&quot;&gt;Sale Start Dates&lt;/a&gt;.&lt;/p&gt;
</content:encoded></item><item><title>[NEW] Sale Start Dates Endpoints</title><link>https://api-docs-stage.revelator.com/v2/changelog#2026-11-02</link><guid isPermaLink="false">changelog-2026-11-02/sale-start-dates-endpoints</guid><pubDate>Mon, 02 Nov 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Introduces endpoints to retrieve and save the sale start dates of a release: the date, time, and time zone it goes live,
and an optional preorder date. Set one release-level date for every store, and optionally per-store dates for staggered
go-live or store exclusives.&lt;/p&gt;
&lt;p&gt;These endpoints replace the sale start fields of the V1.0 &lt;code&gt;POST /content/release/retail/save&lt;/code&gt; endpoint, which is now
deprecated. Every call to &lt;code&gt;retail/save&lt;/code&gt; replaces the release-level dates and deletes all per-store dates.&lt;/p&gt;
&lt;p&gt;See &lt;a href=&quot;/v2/en/supply-chain/sale-start-dates&quot;&gt;Sale Start Dates&lt;/a&gt;.&lt;/p&gt;
</content:encoded></item></channel></rss>