Search

let results = try await Rollup.shared.search("sushi in Tokyo last spring")
for result in results.results {
    print(result.id, result.date as Any, result.places.first?.name as Any)
}

​

What a query can say

• Dates, such as “last spring”, “in March”, “2025” or a holiday.
• Media, such as “videos” or “screenshots”.
• Places: countries, cities, neighborhoods, venue names and kinds of places, such as “ramen” or “museum”.
• What photos show, matched against the image and its labels.
• Text in images, such as signs, menus and screenshots.

​

Results

• id: the PhotoKit local identifier. Load the image yourself with PhotoKit.
• date and timeZone: when and in which time zone it was taken.
• mediaType and isFavorite.
• location: neighborhood, city, metro, country and coordinates.
• places and cuisines: the venue its visit resolved to, and cuisines for food photos. Empty when places is off.
• labels: what the photo shows, with probabilities.
• text: text read from the image, and screenshot for what was read from a screenshot.
• score, relevance, matchedText and matchReasons: why it matched.

​

Loading images

import Photos

let assets = PHAsset.fetchAssets(withLocalIdentifiers: results.results.map(\.id), options: nil)

​

Errors

• noIndex: nothing is indexed yet. Wait until indexing.state.isSearchable is true.
• notConfigured: call configure first.
• accessRevoked: your app’s Rollup key no longer works. See Keys and revocation.