<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "AppleMusicAPI",
  "identifier" : "/documentation/AppleMusicAPI/Get-Equivalent-Ids-for-the-Albums-8tp4l",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Music API"
    ],
    "preciseIdentifier" : "rest:music_api:get:v1-catalog-{}-music-videos#filter-equivalents"
  },
  "title" : "Get Equivalent Catalog Music Videos by ID"
}
-->

# Get Equivalent Catalog Music Videos by ID

Fetch the equivalent, available content in the storefront for the provided music videos’ identifiers.

## Discussion

If successful, the HTTP status code is 200 (OK) and the `data` array contains the requested resource object. If unsuccessful, the HTTP status code indicates the error and the details are in the `errors` array. For more information, see [Handling Requests and Responses](/documentation/AppleMusicAPI/handling-requests-and-responses).

### Example

**Request:**

```
https://api.music.apple.com/v1/catalog/ch/music-videos?filter[equivalents]=1553279848
```

**Response:**

```json
{
    "data": [
        {
            "id": "1552406856",
            "type": "music-videos",
            "href": "/v1/catalog/ch/music-videos/1552406856",
            "attributes": {
                "previews": [
                    {
                        "url": "https: //video-ssl.itunes.apple.com/itunes-assets/Video114/v4/d6/33/c5/d633c5de-0ddb-ad5d-a560-3e9fb35c057b/mzvf_2101846033664580247.720w.h264lc.U.p.m4v",
                        "hlsUrl": "https: //play.itunes.apple.com/WebObjects/MZPlay.woa/hls/playlist.m3u8?cc=CH&a=1552406856&id=230060134&l=de&aec=HD",
                        "artwork": {
                            "width": 1561,
                            "url": "https: //is2-ssl.mzstatic.com/image/thumb/Video114/v4/f0/dc/be/f0dcbea2-4718-c310-d9f6-f16d86ffd699/Jobfaa18d62-b9d3-4e7a-ac99-fc4ca04a9c9a-109210777-PreviewImage_preview_image_45000_video_sdr-Time1612539991665.png/{w}x{h}bb.jpeg",
                            "height": 1080,
                            "textColor3": "a5a69c",
                            "textColor2": "bac0c4",
                            "textColor4": "9a9fa1",
                            "textColor1": "c7c9bd",
                            "bgColor": "1b1b19",
                            "hasP3": false
                        }
                    }
                ],
                "artwork": {
                    "width": 1553,
                    "url": "https: //is1-ssl.mzstatic.com/image/thumb/Video114/v4/c4/09/a5/c409a5d5-61c1-5a3b-54ca-6bb34af4a7da/21UMGIM09694.crop.jpg/{w}x{h}mv.jpeg",
                    "height": 1072,
                    "textColor3": "c6b490",
                    "textColor2": "d4bb93",
                    "textColor4": "b9a17e",
                    "textColor1": "e5d2a9",
                    "bgColor": "4d3a2c",
                    "hasP3": false
                },
                "artistName": "Dua Lipa",
                "url": "https: //music.apple.com/ch/music-video/were-good/1552406856",
                "genreNames": [
                    "Pop"
                ],
                "has4K": false,
                "durationInMillis": 181033,
                "releaseDate": "2021-02-12",
                "name": "We’re Good",
                "isrc": "GB1302001140",
                "playParams": {
                    "id": "1552406856",
                    "kind": "musicVideo"
                },
                "hasHDR": false
            },
            "relationships": {
                "artists": {
                    "href": "/v1/catalog/ch/music-videos/1552406856/artists",
                    "data": [
                        {
                            "id": "1031397873",
                            "type": "artists",
                            "href": "/v1/catalog/ch/artists/1031397873"
                        }
                    ]
                },
                "albums": {
                    "href": "/v1/catalog/ch/music-videos/1552406856/albums",
                    "data": []
                }
            }
        }
    ],
    "meta": {
        "filters": {
            "equivalents": {
                "1553279848": [
                    {
                        "id": "1552406856",
                        "type": "music-videos",
                        "href": "/v1/catalog/ch/music-videos/1552406856"
                    }
                ]
            }
        }
    }
}
```

## See Also

[`object MusicVideos`](/documentation/AppleMusicAPI/MusicVideos)

A resource object that represents a music video.

[`object MusicVideosResponse`](/documentation/AppleMusicAPI/MusicVideosResponse)

The response to a music videos request.



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)