How to work with the Track API

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

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.