<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "macCatalyst: -",
    "macOS: 27.0.0 -",
    "tvOS: 27.0.0 -",
    "visionOS: 27.0.0 -",
    "watchOS: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "MediaIntents",
  "identifier" : "/documentation/MediaIntents/AudioSearch",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Media Intents"
    ],
    "preciseIdentifier" : "s:12MediaIntents11AudioSearchV"
  },
  "title" : "AudioSearch"
}
-->

# AudioSearch

Results and metadata for a person’s audio search and playback request with Siri.

```
struct AudioSearch
```

## Overview

People use Apple Intelligence and Siri to find and play audio. By integrating your app’s
audio catalog with Apple Intelligence and Siri using the <doc://com.apple.documentation/documentation/AppIntents>
framework, the system forwards search and playback requests to your app, and your app
returns audio search results and allows the system to play your app’s songs, podcasts, audiobooks, and so on.

The `AudioSearch` structure captures a person’s audio search and playback request — music, podcasts,
audiobooks, or other audio content.

Use `AudioSearch` in your <doc://com.apple.documentation/documentation/AppIntents/IntentValueQuery> implementation
to find matching audio content in your app’s media catalog.

For more information about allowing people to find audio content in your app with
Apple Intelligence and Siri, see
<doc://com.apple.documentation/documentation/MediaIntents/responding-to-audio-search-and-playback-requests>.

## Topics

### Describing result criteria

[`var criteria: AudioSearch.Criteria`](/documentation/MediaIntents/AudioSearch/criteria-swift.property)

The search criteria for the audio request.

[`enum Criteria`](/documentation/MediaIntents/AudioSearch/Criteria-swift.enum)

The metadata and classification of a person’s audio search that the system provides.

### Accessing Spotlight search results

### Providing default implementations

[`init(criteria: AudioSearch.Criteria, spotlightSearchResults: [Never])`](/documentation/MediaIntents/AudioSearch/init(criteria:spotlightSearchResults:))

[`static let defaultResolverSpecification: EmptyResolverSpecification<AudioSearch>`](/documentation/MediaIntents/AudioSearch/defaultResolverSpecification)

### Initializers

[`init(criteria: AudioSearch.Criteria)`](/documentation/MediaIntents/AudioSearch/init(criteria:))

Creates an audio search with a person’s search criteria.

### Type Aliases

[`typealias Specification`](/documentation/MediaIntents/AudioSearch/Specification)

[`typealias UnwrappedType`](/documentation/MediaIntents/AudioSearch/UnwrappedType)

[`typealias ValueType`](/documentation/MediaIntents/AudioSearch/ValueType)

## Relationships

### Conforms To

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

[`IntentValueExpressing`](/documentation/AppIntents/IntentValueExpressing)

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

[`IntentValueConvertible`](/documentation/AppIntents/IntentValueConvertible)

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

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

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

[`DisplayRepresentable`](/documentation/AppIntents/DisplayRepresentable)

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

[`PersistentlyIdentifiable`](/documentation/AppIntents/PersistentlyIdentifiable)

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

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

[`TypeDisplayRepresentable`](/documentation/AppIntents/TypeDisplayRepresentable)

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

[`InstanceDisplayRepresentable`](/documentation/AppIntents/InstanceDisplayRepresentable)

---

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)