<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "iPadOS: 13.0.0 -",
    "macCatalyst: 13.1.0 -",
    "tvOS: 14.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 6.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SiriKit",
  "identifier" : "/documentation/Intents/INMediaSearch",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Intents"
    ],
    "preciseIdentifier" : "c:objc(cs)INMediaSearch"
  },
  "title" : "INMediaSearch"
}
-->

# INMediaSearch

An object that describes a media type to search for, such as a station name, song name, or album name.

```
class INMediaSearch
```

## Topics

### Initializing a Media Search Object

[`init(mediaType:sortOrder:mediaName:artistName:albumName:genreNames:moodNames:releaseDate:reference:mediaIdentifier:)`](/documentation/Intents/INMediaSearch/init(mediaType:sortOrder:mediaName:artistName:albumName:genreNames:moodNames:releaseDate:reference:mediaIdentifier:))

Creates a new media search object with the specified parameters.

[`-  initWithMediaType:sortOrder:mediaName:artistName:albumName:genreNames:moodNames:releaseDate:reference:mediaIdentifier:`](/documentation/Intents/INMediaSearch/initWithMediaType:sortOrder:mediaName:artistName:albumName:genreNames:moodNames:releaseDate:reference:mediaIdentifier:)

Creates a new media search object with the specified parameters.

### Retrieving Search Information

[`genreNames`](/documentation/Intents/INMediaSearch/genreNames)

The media genres to search.

[`mediaIdentifier`](/documentation/Intents/INMediaSearch/mediaIdentifier)

The unique media identifier to search for.

[`mediaName`](/documentation/Intents/INMediaSearch/mediaName)

The name of the media to search for.

[`mediaType`](/documentation/Intents/INMediaSearch/mediaType)

The type of media to search for.

[`moodNames`](/documentation/Intents/INMediaSearch/moodNames)

The moods to search for.

[`reference`](/documentation/Intents/INMediaSearch/reference)

A reference for the media item to search for.

[`INMediaReference`](/documentation/Intents/INMediaReference)

Constants that describe a reference for a media item.

[`releaseDate`](/documentation/Intents/INMediaSearch/releaseDate)

The release date to search for.

[`sortOrder`](/documentation/Intents/INMediaSearch/sortOrder)

The sort order for the found media items.

[`INMediaSortOrder`](/documentation/Intents/INMediaSortOrder)

Constants indicating the sort order for the found media items.

[`activityNames`](/documentation/Intents/INMediaSearch/activityNames)

The activity names to search for.

### Modifying the Media Name

The following properties can only be used in conjunction with the [`mediaName`](/documentation/Intents/INMediaSearch/mediaName)

The name of the media to search for. property.

[`albumName`](/documentation/Intents/INMediaSearch/albumName)

The name of the album to search for.

[`artistName`](/documentation/Intents/INMediaSearch/artistName)

The name of the artist to search for.

## Relationships

### Inherits From

[`NSObject-swift.class`](/documentation/ObjectiveC/NSObject-swift.class)

### Conforms To

[`CVarArg`](/documentation/Swift/CVarArg)

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

[`Hashable`](/documentation/Swift/Hashable)

[`Equatable`](/documentation/Swift/Equatable)

[`NSCoding`](/documentation/Foundation/NSCoding)

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`NSSecureCoding`](/documentation/Foundation/NSSecureCoding)

[`NSCopying`](/documentation/Foundation/NSCopying)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

---

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)