🎵 Track Matches

Audio match records identifying recognized versions, covers, and derivative works associated with a track.

Resource Overview

Track Matches represent matches found for a specific track. It is part of the hasMany relationship from the Track resource. It provides both a top-level collection endpoint and a nested endpoint under the Track resource, allowing clients to query matches globally or within the context of a specific track.

Base Endpoint
/track-matches
Resource Type
track-matches
Access Type
Read-Only
User Scope
Track owner-restricted

Schema

Read-Only Resource

All fields are read-only. Track Matches are generated automatically by the system when a Distribution Request is created.

System-Generated Attributes

Field Type Description Read-Only
id integer Unique track match identifier ✓
is-cover boolean Is cover or audio match ✓
title string Title of the track match ✓
album-title string Title of the album ✓
isrc-code string International Standard Recording Code ✓
album-upc-code string UPC Code (Universal Product Code) of the album ✓
iswc-code string International Standard Musical Work Code ✓
label string Label name ✓
release-date date Release date ✓
youtube-id string Youtube video identifier ✓
spotify-id string Spotify track identifier ✓
spotify-title string Spotify track title ✓
spotify-album-id string Spotify album identifier ✓
spotify-album-name string Spotify album name ✓
apple-id string Apple track identifier ✓
deezer-id string Deezer track identifier ✓
deezer-title string Deezer track title ✓
deezer-album-id string Deezer album identifier ✓
confidence-score integer ACR Cloud confidence score (from 70 to 100) ✓
created-at datetime Record creation date ✓
updated-at datetime Last update date ✓

Relationships

Relationship Type Related Resource Description
track BelongsTo tracks Track to associate match with
track-analysis BelongsTo track-analyses Track Analysis to associate match with
artists HasMany track-match-artists Artists of the track match
distributors HasMany track-match-distributors Distributors of the track match
time-offsets HasMany track-match-time-offsets Time ranges where the audio match occurs
spotify-artists HasMany track-match-spotify-artists Spotify artists of the track match
deezer-artists HasMany track-match-deezer-artists Deezer artists of the track match

API Endpoints

GET /track-matches

Get list of track matches for the authenticated user

Query Parameters

Filtering

  • • filter[track] - Filter by specific track
  • • filter[is-cover] - Filter by if track match is cover
  • • filter[title] - Filter by title (partial match)
  • • filter[album-title] - Filter by album title (partial match)
  • • filter[isrc-code] - Filter by ISRC code
  • • filter[album-upc-code] - Filter by album UPC code
  • • filter[iswc-code] - Filter by ISWC code
  • • filter[label] - Filter by label

Other Parameters

  • • include - Include related resources
    Available: track, track.user, track.albums, track.artists, track-analysis, artists, distributors, time-offsets, spotify-artists, deezer-artists
  • • sort - Sort by field (prefix with - for desc)
    Available: title, created-at, release-date
  • • page[number] - Page number
  • • page[size] - Results per page

Success Response

200 OK 
                        
{
    "meta": {
        "page": {
            "currentPage": 1,
            "lastPage": 1,
            "perPage": 20,
            "total": 2
        }
    },
    "data": [
        {
            "type": "track-matches",
            "id": "1",
            "attributes": {
                "is-cover": 0,
                "title": "Julian Guy Gays",
                "album-title": "This And That",
                "isrc-code": "QMQGC2201053",
                "album-upc-code": "123456789012",
                "iswc-code": T9998887775,
                "label": "My Label",
                "release-date": "2022-07-06T00:00:00.000000Z",
                "youtube-id": "Yt123456789",
                "spotify-id": "1dNIEtp7AY3oDAKCGg2XkH",
                "spotify-title": "Julian Guy Gays",
                "spotify-album-id": "3RQQmkQEvNCY4prGKE6oc5",
                "spotify-album-name": "This and That",
                "apple-id": null,
                "deezer-id": "987654321",
                "deezer-title": "Julian Guy Gays",
                "deezer-album-id": "12345678",
                "deezer-album-name": "This And That",
                "confidence-score": 90,
                "created-at": "2023-04-19T03:13:13.000000Z",
                "updated-at": "2023-04-19T03:13:13.000000Z"
            },
            "relationships": {
                "track": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/1/track",
                        "self": "http://localhost:8091/api/v1/track-matches/1/relationships/track"
                    }
                },
                "track-analysis": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/1/track-analysis",
                        "self": "http://localhost:8091/api/v1/track-matches/1/relationships/track-analysis"
                    }
                },
                "artists": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/1/artists",
                        "self": "http://localhost:8091/api/v1/track-matches/1/relationships/artists"
                    }
                },
                "distributors": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/1/distributors",
                        "self": "http://localhost:8091/api/v1/track-matches/1/relationships/distributors"
                    }
                },
                "time-offsets": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/1/time-offsets",
                        "self": "http://localhost:8091/api/v1/track-matches/1/relationships/time-offsets"
                    }
                },
                "spotify-artists": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/1/spotify-artists",
                        "self": "http://localhost:8091/api/v1/track-matches/1/relationships/spotify-artists"
                    }
                },
                "deezer-artists": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/1/deezer-artists",
                        "self": "http://localhost:8091/api/v1/track-matches/1/relationships/deezer-artists"
                    }
                }
            },
            "links": {
                "self": "http://localhost:8091/api/v1/track-matches/1"
            }
        },
        {
            "type": "track-matches",
            "id": "2",
            "attributes": {
                "is-cover": 1,
                "title": "Elyot",
                "album-title": "Awakes Unknown",
                "isrc-code": "QM8XZ2204352",
                "album-upc-code": "197368767154",
                "iswc-code": null,
                "label": "EMS Records",
                "release-date": "2023-04-07T00:00:00.000000Z",
                "youtube-id": "aBcDeFg1234",
                "spotify-id": "0sNOF9WDwhWunNAHPD3Baj",
                "spotify-title": "Elyot",
                "spotify-album-id": "6akEvsycLGftJxYudPjmqK",
                "spotify-album-name": "Awakes Unknown",
                "apple-id": "1459876543",
                "deezer-id": "87654321",
                "deezer-title": "Elyot",
                "deezer-album-id": "3135556",
                "deezer-album-name": "Awakes Unknown",
                "confidence-score": null,
                "created-at": "2023-04-19T03:13:13.000000Z",
                "updated-at": "2023-04-19T03:13:13.000000Z"
            },
            "relationships": {
                "track": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/2/track",
                        "self": "http://localhost:8091/api/v1/track-matches/2/relationships/track"
                    }
                },
                "track-analysis": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/2/track-analysis",
                        "self": "http://localhost:8091/api/v1/track-matches/2/relationships/track-analysis"
                    }
                },
                "artists": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/2/artists",
                        "self": "http://localhost:8091/api/v1/track-matches/2/relationships/artists"
                    }
                },
                "distributors": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/2/distributors",
                        "self": "http://localhost:8091/api/v1/track-matches/2/relationships/distributors"
                    }
                },
                "time-offsets": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/2/time-offsets",
                        "self": "http://localhost:8091/api/v1/track-matches/2/relationships/time-offsets"
                    }
                },
                "spotify-artists": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/2/spotify-artists",
                        "self": "http://localhost:8091/api/v1/track-matches/2/relationships/spotify-artists"
                    }
                },
                "deezer-artists": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/2/deezer-artists",
                        "self": "http://localhost:8091/api/v1/track-matches/2/relationships/deezer-artists"
                    }
                }
            },
            "links": {
                "self": "http://localhost:8091/api/v1/track-matches/2"
            }
        }
    ]
}
GET /tracks/{id}/track-matches

Get list of track matches of a track for the authenticated user

Query Parameters

Filtering

  • • filter[is-cover] - Filter by if track match is cover
  • • filter[title] - Filter by title (partial match)
  • • filter[album-title] - Filter by album title (partial match)
  • • filter[isrc-code] - Filter by ISRC code
  • • filter[album-upc-code] - Filter by album UPC code
  • • filter[iswc-code] - Filter by ISWC code
  • • filter[label] - Filter by label

Other Parameters

  • • include - Include related resources
    Available: track, track.user, track.albums, track.artists, track-analysis, artists, distributors, time-offsets, spotify-artists, deezer-artists
  • • sort - Sort by field (prefix with - for desc)
    Available: title, created-at, release-date
  • • page[number] - Page number
  • • page[size] - Results per page

Success Response

200 OK 
                        
{
    "meta": {
        "page": {
            "currentPage": 1,
            "lastPage": 1,
            "perPage": 20,
            "total": 2
        }
    },
    "data": [
        {
            "type": "track-matches",
            "id": "1",
            "attributes": {
                "is-cover": 0,
                "title": "Julian Guy Gays",
                "album-title": "This And That",
                "isrc-code": "QMQGC2201053",
                "album-upc-code": "123456789012",
                "iswc-code": T9998887775,
                "label": "My Label",
                "release-date": "2022-07-06T00:00:00.000000Z",
                "youtube-id": "Yt123456789",
                "spotify-id": "1dNIEtp7AY3oDAKCGg2XkH",
                "spotify-title": "Julian Guy Gays",
                "spotify-album-id": "3RQQmkQEvNCY4prGKE6oc5",
                "spotify-album-name": "This and That",
                "apple-id": null,
                "deezer-id": "987654321",
                "deezer-title": "Julian Guy Gays",
                "deezer-album-id": "12345678",
                "deezer-album-name": "This And That",
                "confidence-score": 90,
                "created-at": "2023-04-19T03:13:13.000000Z",
                "updated-at": "2023-04-19T03:13:13.000000Z"
            },
            "relationships": {
                "track": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/1/track",
                        "self": "http://localhost:8091/api/v1/track-matches/1/relationships/track"
                    }
                },
                "track-analysis": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/1/track-analysis",
                        "self": "http://localhost:8091/api/v1/track-matches/1/relationships/track-analysis"
                    }
                },
                "artists": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/1/artists",
                        "self": "http://localhost:8091/api/v1/track-matches/1/relationships/artists"
                    }
                },
                "distributors": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/1/distributors",
                        "self": "http://localhost:8091/api/v1/track-matches/1/relationships/distributors"
                    }
                },
                "time-offsets": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/1/time-offsets",
                        "self": "http://localhost:8091/api/v1/track-matches/1/relationships/time-offsets"
                    }
                },
                "spotify-artists": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/1/spotify-artists",
                        "self": "http://localhost:8091/api/v1/track-matches/1/relationships/spotify-artists"
                    }
                },
                "deezer-artists": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/1/deezer-artists",
                        "self": "http://localhost:8091/api/v1/track-matches/1/relationships/deezer-artists"
                    }
                }
            },
            "links": {
                "self": "http://localhost:8091/api/v1/track-matches/1"
            }
        },
        {
            "type": "track-matches",
            "id": "2",
            "attributes": {
                "is-cover": 1,
                "title": "Elyot",
                "album-title": "Awakes Unknown",
                "isrc-code": "QM8XZ2204352",
                "album-upc-code": "197368767154",
                "iswc-code": null,
                "label": "EMS Records",
                "release-date": "2023-04-07T00:00:00.000000Z",
                "youtube-id": "aBcDeFg1234",
                "spotify-id": "0sNOF9WDwhWunNAHPD3Baj",
                "spotify-title": "Elyot",
                "spotify-album-id": "6akEvsycLGftJxYudPjmqK",
                "spotify-album-name": "Awakes Unknown",
                "apple-id": "1459876543",
                "deezer-id": "87654321",
                "deezer-title": "Elyot",
                "deezer-album-id": "3135556",
                "deezer-album-name": "Awakes Unknown",
                "confidence-score": null,
                "created-at": "2023-04-19T03:13:13.000000Z",
                "updated-at": "2023-04-19T03:13:13.000000Z"
            },
            "relationships": {
                "track": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/2/track",
                        "self": "http://localhost:8091/api/v1/track-matches/2/relationships/track"
                    }
                },
                "track-analysis": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/2/track-analysis",
                        "self": "http://localhost:8091/api/v1/track-matches/2/relationships/track-analysis"
                    }
                },
                "artists": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/2/artists",
                        "self": "http://localhost:8091/api/v1/track-matches/2/relationships/artists"
                    }
                },
                "distributors": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/2/distributors",
                        "self": "http://localhost:8091/api/v1/track-matches/2/relationships/distributors"
                    }
                },
                "time-offsets": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/2/time-offsets",
                        "self": "http://localhost:8091/api/v1/track-matches/2/relationships/time-offsets"
                    }
                },
                "spotify-artists": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/2/spotify-artists",
                        "self": "http://localhost:8091/api/v1/track-matches/2/relationships/spotify-artists"
                    }
                },
                "deezer-artists": {
                    "links": {
                        "related": "http://localhost:8091/api/v1/track-matches/2/deezer-artists",
                        "self": "http://localhost:8091/api/v1/track-matches/2/relationships/deezer-artists"
                    }
                }
            },
            "links": {
                "self": "http://localhost:8091/api/v1/track-matches/2"
            }
        }
    ]
}
GET /track-matches/{id}

Retrieve a specific track match with its complete information and relationships.

Example Response

200 OK 
                    
{
    "data": {
        "type": "track-matches",
        "id": "1",
        "attributes": {
            "is-cover": 0,
            "title": "Julian Guy Gays",
            "album-title": "This And That",
            "isrc-code": "QMQGC2201053",
            "album-upc-code": "123456789012",
            "iswc-code": T9998887775,
            "label": "My Label",
            "release-date": "2022-07-06T00:00:00.000000Z",
            "youtube-id": "Yt123456789",
            "spotify-id": "1dNIEtp7AY3oDAKCGg2XkH",
            "spotify-title": "Julian Guy Gays",
            "spotify-album-id": "3RQQmkQEvNCY4prGKE6oc5",
            "spotify-album-name": "This and That",
            "apple-id": null,
            "deezer-id": "987654321",
            "deezer-title": "Julian Guy Gays",
            "deezer-album-id": "12345678",
            "deezer-album-name": "This And That",
            "confidence-score": 90,
            "created-at": "2023-04-19T03:13:13.000000Z",
            "updated-at": "2023-04-19T03:13:13.000000Z"
        },
        "relationships": {
            "track": {
                "links": {
                    "related": "http://localhost:8091/api/v1/track-matches/1/track",
                    "self": "http://localhost:8091/api/v1/track-matches/1/relationships/track"
                }
            },
            "track-analysis": {
                "links": {
                    "related": "http://localhost:8091/api/v1/track-matches/1/track-analysis",
                    "self": "http://localhost:8091/api/v1/track-matches/1/relationships/track-analysis"
                }
            },
            "artists": {
                "links": {
                    "related": "http://localhost:8091/api/v1/track-matches/1/artists",
                    "self": "http://localhost:8091/api/v1/track-matches/1/relationships/artists"
                }
            },
            "distributors": {
                "links": {
                    "related": "http://localhost:8091/api/v1/track-matches/1/distributors",
                    "self": "http://localhost:8091/api/v1/track-matches/1/relationships/distributors"
                }
            },
            "time-offsets": {
                "links": {
                    "related": "http://localhost:8091/api/v1/track-matches/1/time-offsets",
                    "self": "http://localhost:8091/api/v1/track-matches/1/relationships/time-offsets"
                }
            },
            "spotify-artists": {
                "links": {
                    "related": "http://localhost:8091/api/v1/track-matches/1/spotify-artists",
                    "self": "http://localhost:8091/api/v1/track-matches/1/relationships/spotify-artists"
                }
            },
            "deezer-artists": {
                "links": {
                    "related": "http://localhost:8091/api/v1/track-matches/1/deezer-artists",
                    "self": "http://localhost:8091/api/v1/track-matches/1/relationships/deezer-artists"
                }
            }
        }
    }
}
Previous: Track Artists Next: Trends