<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "AppleMusicAPI",
  "identifier" : "/documentation/AppleMusicAPI/Get-Multiple-Catalog-Music-Videos-by-ID",
  "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#ids"
  },
  "title" : "Get Multiple Catalog Music Videos by ID"
}
-->

# Get Multiple Catalog Music Videos by ID

Fetch one or more music videos by using their 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/us/music-videos?ids=1553279848,1549013065
```

**Response:**

```json
{
    "data": [
        {
            "id": "1553279848",
            "type": "music-videos",
            "href": "/v1/catalog/us/music-videos/1553279848",
            "attributes": {
                "previews": [
                    {
                        "url": "https: //video-ssl.itunes.apple.com/itunes-assets/Video114/v4/c8/14/3c/c8143cb4-e58a-8075-44b0-602f43d7646f/mzvf_2953199973497507158.720w.h264lc.U.p.m4v",
                        "hlsUrl": "https: //play.itunes.apple.com/WebObjects/MZPlay.woa/hls/playlist.m3u8?cc=US&a=1553279848&id=231169237&l=en&aec=HD",
                        "artwork": {
                            "width": 1560,
                            "height": 1080,
                            "url": "https: //is3-ssl.mzstatic.com/image/thumb/Video124/v4/26/6b/fe/266bfe0f-9d0c-e992-ae86-ce97cb251e40/Job80599ed4-a39e-455a-9f99-5bdc54c44284-109334076-PreviewImage_preview_image_43000_video_sdr-Time1613053183818.png/{w}x{h}bb.jpeg",
                            "bgColor": "cadee0",
                            "textColor1": "101414",
                            "textColor2": "181e1f",
                            "textColor3": "353c3d",
                            "textColor4": "3b4445"
                        }
                    }
                ],
                "artwork": {
                    "width": 640,
                    "height": 360,
                    "url": "https: //is1-ssl.mzstatic.com/image/thumb/Video124/v4/3f/1e/6f/3f1e6f35-6960-3f0e-0a0c-8701aa2012d4/dj.bcvxpufw.jpg/{w}x{h}mv.jpeg",
                    "bgColor": "000000",
                    "textColor1": "86bff9",
                    "textColor2": "7cb0ea",
                    "textColor3": "6b98c7",
                    "textColor4": "638dbb"
                },
                "artistName": "Dua Lipa",
                "url": "https: //music.apple.com/us/music-video/were-good/1553279848",
                "genreNames": [
                    "Pop"
                ],
                "has4K": false,
                "durationInMillis": 191913,
                "releaseDate": "2021-02-12",
                "name": "We’re Good",
                "isrc": "GB1302001140",
                "playParams": {
                    "id": "1553279848",
                    "kind": "musicVideo"
                },
                "hasHDR": false
            },
            "relationships": {
                "albums": {
                    "href": "/v1/catalog/us/music-videos/1553279848/albums",
                    "data": []
                },
                "artists": {
                    "href": "/v1/catalog/us/music-videos/1553279848/artists",
                    "data": [
                        {
                            "id": "1031397873",
                            "type": "artists",
                            "href": "/v1/catalog/us/artists/1031397873"
                        }
                    ]
                }
            }
        },
        {
            "id": "1549013065",
            "type": "music-videos",
            "href": "/v1/catalog/us/music-videos/1549013065",
            "attributes": {
                "previews": [
                    {
                        "url": "https: //video-ssl.itunes.apple.com/itunes-assets/Video124/v4/e0/5f/88/e05f8810-e2c5-8b06-d9da-d58829fe590b/mzvf_12665898235115114036.720w.h264lc.U.p.m4v",
                        "hlsUrl": "https: //play.itunes.apple.com/WebObjects/MZPlay.woa/hls/playlist.m3u8?cc=US&a=1549013065&id=224630612&l=en&aec=HD",
                        "artwork": {
                            "width": 1912,
                            "height": 1072,
                            "url": "https: //is5-ssl.mzstatic.com/image/thumb/Video124/v4/ae/b6/41/aeb64141-a00e-d4b4-e19e-7fd00eff0534/Jobc9e8f50e-a109-4976-9f16-ee7871899a6c-108689753-PreviewImage_preview_image_45000_video_sdr-Time1610655522053.png/{w}x{h}bb.jpeg",
                            "bgColor": "0c040c",
                            "textColor1": "eb707e",
                            "textColor2": "e75b6b",
                            "textColor3": "be5a67",
                            "textColor4": "bb4a58"
                        }
                    }
                ],
                "artwork": {
                    "width": 1912,
                    "height": 1072,
                    "url": "https: //is4-ssl.mzstatic.com/image/thumb/Video124/v4/1a/54/02/1a5402a4-48bb-dee3-c0c4-368bfee4158d/21UMGIM01401.crop.jpg/{w}x{h}mv.jpeg",
                    "bgColor": "38332d",
                    "textColor1": "e8d9d2",
                    "textColor2": "d9ccce",
                    "textColor3": "c4b8b1",
                    "textColor4": "b9aeae"
                },
                "artistName": "Selena Gomez",
                "url": "https: //music.apple.com/us/music-video/de-una-vez/1549013065",
                "genreNames": [
                    "Latin"
                ],
                "has4K": false,
                "durationInMillis": 168467,
                "releaseDate": "2021-01-14",
                "name": "De Una Vez",
                "isrc": "USUMV2100129",
                "playParams": {
                    "id": "1549013065",
                    "kind": "musicVideo"
                },
                "hasHDR": false
            },
            "relationships": {
                "albums": {
                    "href": "/v1/catalog/us/music-videos/1549013065/albums",
                    "data": []
                },
                "artists": {
                    "href": "/v1/catalog/us/music-videos/1549013065/artists",
                    "data": [
                        {
                            "id": "280215834",
                            "type": "artists",
                            "href": "/v1/catalog/us/artists/280215834"
                        }
                    ]
                }
            }
        }
    ]
}
```

## 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)