llms.txt
Machine-readable summary of Catalogue Events, Standard Metadata, and Enhanced Metadata.
MassiveMusic Docs
Catalogue Events delivers catalogue updates to your HTTPS endpoint as events. There are two metadata event types: Standard Metadata and Enhanced Metadata.
Catalogue Events Overview
- Page: Catalogue Events Overview (NEW)
- Topic: Catalogue event delivery, metadata event types, ingestion order, availability, and takedown handling.
Summary
Catalogue Events sends updates for the MassiveMusic catalogue to your infrastructure as events.
You will work with two metadata event types:
-
Standard Metadata
- Licensor-provided
- Delivered through Catalogue Events as Release Events
- Includes Artist(s), Release, Track(s), and availability data
- Must be ingested first
- Is the source of truth for catalogue, release, and availability updates
- Newer events overwrite older events because each event is a snapshot of the latest release state
- Includes bulk catalogue ingestion, availability updates, and takedown handling
-
Enhanced Metadata
- MassiveMusic-provided
- Delivered through its own Catalogue Events stream
- Includes track-level enrichment tags
- Must be ingested after Standard Metadata
- Should be attached to tracks already stored from Standard Metadata
- Is not the source of truth for release structure, availability, or takedown updates
Processing Rules
- Store Standard Metadata first.
- Treat each Standard Metadata event as the latest release snapshot.
- Overwrite older Standard Metadata with newer Standard Metadata for the same release.
- Apply bulk catalogue ingestion from Standard Metadata.
- Apply availability updates from Standard Metadata.
- Apply takedown handling from Standard Metadata.
- Store Enhanced Metadata after Standard Metadata is already available.
- Use Enhanced Metadata to enrich existing track records.
- Do not use Enhanced Metadata as the source of truth for release or availability changes.
Key Differences
| Aspect | Standard Metadata | Enhanced Metadata |
|---|---|---|
| Provider | Licensor-provided | MassiveMusic-provided |
| Delivery | Catalogue Events Release Events | Separate Catalogue Events stream |
| Scope | Artist(s), Release, Track(s), availability | Track enrichment tags |
| Ingestion order | First | After Standard Metadata |
| Source of truth | Yes | No |
| Overwrite logic | Newer events overwrite older events | Attach to existing tracks |
| Availability and takedowns | Included | Not authoritative |
Related Docs
Notes for Agents
- "Catalogue Events" refers to event delivery to a consumer HTTPS endpoint.
- "Metadata event types" refers to Standard Metadata events and Enhanced Metadata events.
- Standard Metadata should be treated as authoritative.
- Enhanced Metadata should be treated as additive enrichment.
Updated 10 days ago