---
title: "Platform links"
method: GET
path: "/v1/tracks/links"
tags: ["Tracks"]
---

# Platform links

`GET /v1/tracks/links`

## Request

- Base URL: `https://api.sonovault.now`
- URL: `https://api.sonovault.now/v1/tracks/links`
- Auth: API key in header `x-api-key`

Lightweight cross-platform ID resolver. Given an ISRC or a source-specific ID, returns all known external platform links.

## Query parameters

- `id` integer
- `isrc` string
- `spotify_id` string
- `beatport_id` string
- `discogs_id` string
- `musicbrainz_id` string
- `applemusic_id` string
- `tidal_id` string
- `youtube_id` string

## Response `200`

Successful response

- object
  - `track_id` integer, required: Sonovault track ID the lookup resolved to.
  - `title` string, required: Track title.
  - `isrc` string, nullable, required: One representative ISRC for the track. `null` when none is known.
  - `links` PlatformLink[], required: Every known platform ID for the track. Empty array when we hold none.
    - `source` 'spotify' | 'beatport' | 'discogs' | 'musicbrainz' | 'applemusic' | 'tidal' | 'youtube', required: The platform this ID belongs to.
    - `external_id` string, required: The track's ID on that platform.
    - `url` string, nullable, required: Deep link to the track on the platform. `null` when the platform has no stable public URL for it.

---

[API](https://skmtc.dev/sonovault/apis/sonovault-api.md) · [All operations](https://skmtc.dev/sonovault/apis/sonovault-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sonovault/apis/sonovault-api/revisions/0152fff23f2c?raw)