<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "SiriKitCloudMedia",
  "identifier" : "/documentation/SiriKitCloudMedia/MediaSearch",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "SiriKit Cloud Media"
    ],
    "preciseIdentifier" : "data:sirikit_media_api:MediaSearch"
  },
  "title" : "MediaSearch"
}
-->

# MediaSearch

A description of the media items the user wants to play, add to a playlist, or express a preference for.

```
object MediaSearch
```

## Discussion

A `releaseDate` may refer to the publication of a specific media item, or to music typical of a particular decade. For example, the client represents *Play some 80s music* with a `releaseDate` ranging from the first moment of 1980 to the last moment of 1989.

## Topics

### Prioritizing Search Results

[`string MediaSortOrder`](/documentation/SiriKitCloudMedia/MediaSortOrder)

A prioritization for search results.

### Filtering by Release Date

[`object DateComponentsRange`](/documentation/SiriKitCloudMedia/DateComponentsRange)

A period of time from a specified start date to a specified end date.

[`* DateComponents`](/documentation/SiriKitCloudMedia/DateComponents)

A full or partial date and time.

[`object ExplicitDateComponents`](/documentation/SiriKitCloudMedia/ExplicitDateComponents)

A date or time in specified of units (such as year, month, day, hour, and minute) for evaluation in a calendar system and time zone.


---

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)