<!--
{
  "availability" : [
    "iOS: 10.0.0 - 15.0.0",
    "iPadOS: 10.0.0 - 15.0.0",
    "macCatalyst: 13.1.0 - 15.0.0",
    "visionOS: 1.0.0 - 1.0.0",
    "watchOS: 3.2.0 - 8.0.0"
  ],
  "documentType" : "symbol",
  "framework" : "SiriKit",
  "identifier" : "/documentation/Intents/INSearchForPhotosIntentHandling",
  "metadataVersion" : "0.1.0",
  "role" : "Protocol",
  "symbol" : {
    "kind" : "Protocol",
    "modules" : [
      "Intents"
    ],
    "preciseIdentifier" : "c:objc(pl)INSearchForPhotosIntentHandling"
  },
  "title" : "INSearchForPhotosIntentHandling"
}
-->

# INSearchForPhotosIntentHandling

The handler interface for searching the user’s photos.

```
protocol INSearchForPhotosIntentHandling : NSObjectProtocol
```

## Overview

Use the methods of the [`INSearchForPhotosIntentHandling`](/documentation/Intents/INSearchForPhotosIntentHandling) protocol to resolve, confirm, and handle requests to search the photos in your app. Adopt this protocol in an object of your Intents extension that’s capable of performing the search and determining the number of results. Siri doesn’t display the photos found during the search. After a successful search, Siri launches your app to display the photos.

Siri delivers an [`INSearchForPhotosIntent`](/documentation/Intents/INSearchForPhotosIntent) object to your handler when the user asks to search their photos. The provided intent object contains the parameters to use when searching for the photos. Use the methods of this protocol to resolve the search parameters, to perform the search, and to return the number of photos that match the criteria.

## Topics

### Resolving the Intent Parameters

[`resolveDateCreated(for:with:)`](/documentation/Intents/INSearchForPhotosIntentHandling/resolveDateCreated(for:with:))

Resolves the taken dates for the photos.

[`resolveLocationCreated(for:with:)`](/documentation/Intents/INSearchForPhotosIntentHandling/resolveLocationCreated(for:with:))

Resolves the location of the photos.

[`resolvePeopleInPhoto(for:with:)`](/documentation/Intents/INSearchForPhotosIntentHandling/resolvePeopleInPhoto(for:with:))

Resolves the people in the photos.

[`resolveAlbumName(for:with:)`](/documentation/Intents/INSearchForPhotosIntentHandling/resolveAlbumName(for:with:))

Resolves the name of the photo album containing the photos.

[`resolveSearchTerms(for:with:)`](/documentation/Intents/INSearchForPhotosIntentHandling/resolveSearchTerms(for:with:))

Resolves any search terms provided by the user.

### Confirming the Response

[`confirm(intent:completion:)`](/documentation/Intents/INSearchForPhotosIntentHandling/confirm(intent:completion:))

Confirms whether you can perform the search.

### Handling the Intent

[`handle(intent:completion:)`](/documentation/Intents/INSearchForPhotosIntentHandling/handle(intent:completion:))

Handles searching the photos and returning the number of results.


---

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)