---
title: INSearchForMediaIntent
framework: intents
role: symbol
role_heading: Class
path: intents/insearchformediaintent
---

# INSearchForMediaIntent

A request to search for a media item.

## Declaration

```swift
class INSearchForMediaIntent
```

## Mentioned in

Improving Siri Media Interactions and App Selection

## Overview

Overview The system creates an INSearchForMediaIntent object when the user asks Siri to search for a media item, or searches for a musician or band in Spotlight. To handle this intent, provide a handler that conforms to the INSearchForMediaIntentHandling protocol. Your handler should confirm the request and create an INSearchForMediaIntentResponse object with the media to search for. Additional Intent Attributes The following table lists additional attributes of this intent object:  |   |   |

## Topics

### Initializing the Intent Object

- [init(mediaItems:mediaSearch:)](intents/insearchformediaintent/init(mediaitems:mediasearch:).md)

### Searching for Media

- [mediaItems](intents/insearchformediaintent/mediaitems.md)
- [mediaSearch](intents/insearchformediaintent/mediasearch.md)

## Relationships

### Inherits From

- [INIntent](intents/inintent.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [INIntentSetImageKeyPath](intents/inintentsetimagekeypath.md)
- [NSCoding](foundation/nscoding.md)
- [NSCopying](foundation/nscopying.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)
- [NSSecureCoding](foundation/nssecurecoding.md)

## See Also

### Search for Media

- [INSearchForMediaIntentHandling](intents/insearchformediaintenthandling.md)
- [INSearchForMediaIntentResponse](intents/insearchformediaintentresponse.md)