---
title: INSearchForPhotosIntent
framework: intents
role: symbol
role_heading: Class
path: intents/insearchforphotosintent
---

# INSearchForPhotosIntent

A request for the list of photos that match the specified criteria.

## Declaration

```swift
class INSearchForPhotosIntent
```

## Overview

Overview The system creates an INSearchForPhotosIntent object when the user asks to search for photos in an app. The intent object contains the parameters to use during the search, including the possible name of a photo album, the people in the photos, or the location of the photos. Use this intent object to validate the search parameters and to begin the search process. When performing the search, use only the provided parameters and ignore any that have no values. To handle this intent, the handler object in your Intents extension must adopt the INSearchForPhotosIntentHandling protocol. Your handler should confirm the request and create an INSearchForPhotosIntentResponse object with the results of the search. For successful searches, Siri offers the user a way to launch your app and see the results. For a list of other intents in the photos domain, see INPhotosDomainHandling. Additional Intent Attributes The following table lists additional attributes of this intent object:  |   |   |

## Topics

### Creating the Intent Object

- [init(dateCreated:locationCreated:albumName:searchTerms:includedAttributes:excludedAttributes:peopleInPhoto:)](intents/insearchforphotosintent/init(datecreated:locationcreated:albumname:searchterms:includedattributes:excludedattributes:peopleinphoto:).md)

### Getting the People in the Photos

- [peopleInPhoto](intents/insearchforphotosintent/peopleinphoto.md)
- [peopleInPhotoOperator](intents/insearchforphotosintent/peopleinphotooperator.md)

### Getting the Search Terms

- [searchTerms](intents/insearchforphotosintent/searchterms.md)
- [searchTermsOperator](intents/insearchforphotosintent/searchtermsoperator.md)

### Getting the Search Attributes

- [dateCreated](intents/insearchforphotosintent/datecreated.md)
- [locationCreated](intents/insearchforphotosintent/locationcreated.md)
- [albumName](intents/insearchforphotosintent/albumname.md)
- [includedAttributes](intents/insearchforphotosintent/includedattributes.md)
- [excludedAttributes](intents/insearchforphotosintent/excludedattributes.md)
- [INPhotoAttributeOptions](intents/inphotoattributeoptions.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

### Photo Search

- [INSearchForPhotosIntentHandling](intents/insearchforphotosintenthandling.md)
- [INSearchForPhotosIntentResponse](intents/insearchforphotosintentresponse.md)