How to work with the Track API

Details Team
  • Updated
Follow

The Track API allows external systems to access track-level metadata stored in your details database. It is ideal for synchronizing catalog data, powering dashboards, or enabling custom integrations with other tools in your workflow.
 

What the API Returns

The Track API returns track metadata stored in your database, including but not limited to:

  • Track title
  • Artist name
  • Version
  • Playtime
  • ISRC
  • Track ID
  • UUID

The data is returned as structured JSON, ready for use in your own apps or services.


Use Cases

The Track API is suitable for:

  • Integrating track data into your internal systems
  • Enabling metadata syncs across services
  • Exporting or analyzing catalog data
  • Building custom dashboards or user-facing tools
     
     

Accessing the API

Each client has a unique API key and endpoint. To find yours:

  1. Log in to your details account
  2. Go to SETTINGS / SHARING / API Keys
  3. Locate the Track API section


Authentication

All API calls require your client-specific api_key. This key should be treated as a secret and must be included as a query parameter in every request:

?api_key=<your_key>

 

Endpoint Format

https://api.berlin3.com/api/<clientID>/?action=tracks&api_key=<your_key>

Sample Response

{
  "status": "ok",
  "results": [
    {
      "track_id": 14532,
      "uuid": "e73b8f30-b07d-4a68-8a6d-219ab9f9f742",
      "title": "The Story",
      "version": "Remastered",
      "artist": "Side Effect",
      "isrc": "FR9W12012717",
      "playtime": "00:03:45",
      "created": "2024-12-01T10:12:34Z",
      "last_modified": "2025-03-02T08:41:00Z"
    },
    ...
  ]
}

Field Descriptions

Field Type Description
track_id integer Internal ID of the track
uuid string Globally unique identifier for the track
title string Track title
version string Version info (e.g. Edit, Remix, Remastered)
artist string Name of the track’s artist
isrc string International Standard Recording Code
playtime string Duration in format HH:MM:SS
created datetime Timestamp when the track was created
last_modified datetime Timestamp of last update

The API returns an array of matching tracks inside the results field. The status field confirms the success of the request.

 

Support

If you have questions about usage, performance, or custom integrations, feel free to contact our team at label_team@detailsdetails.eu.

Let details work for you.

 

Related articles