What is a UUID?
At Soundcharts, we deal with millions of music entities to provide real-time data to our users.
Each entity (artist, album, song) has a unique identifier, or UUID, following the same structure.
An example of UUID is '11e81bcc-9c1c-ce38-b96b-a0369fe50396' (artist UUID for Billie Eilish).
❗ Please note that when we merge 2 entities in our system, both UUIDs will still work for our API clients, the deprecated one working as an alias.
Linked to each UUID are the external platform identifiers, available in the 'Get IDs' endpoints.
The UUID is then used to retrieve all information in our API, like audience metrics, charts/playlist entries, concerts, etc.
How to find a UUID
The unique identifier can be found:
Through a platform identifier if you have one, in the Get artist by platform ID or Get song by platform ID endpoints for instance;
Through an industry standard like the ISRC or the UPC (Get song by ISRC, Get album by UPC);
Through a search using the entity name, in our search endpoints like Search artist by name or Search song by name.