# MusicLibrarySectionedRequest A request that your app uses to fetch items grouped by sections from the user’s music library. ``` struct MusicLibrarySectionedRequest where SectionType : MusicLibrarySectionRequestable, MusicItemType : MusicLibraryRequestable ``` ## Topics ### Initializers [`init()`](/documentation/MusicKit/MusicLibrarySectionedRequest/init()) Creates a request to fetch items grouped by sections from the library. ### Instance Properties [`var includeOnlyDownloadedContent: Bool`](/documentation/MusicKit/MusicLibrarySectionedRequest/includeOnlyDownloadedContent) A Boolean value that indicates whether the library response should only include items downloaded on the user’s device. [`var limit: Int`](/documentation/MusicKit/MusicLibrarySectionedRequest/limit) A limit for the number of items to return in the library response. [`var offset: Int`](/documentation/MusicKit/MusicLibrarySectionedRequest/offset) An offset for the request. ### Instance Methods [`func filterItems(matching: KeyPath?>, contains: RelatedMusicItemType)`](/documentation/MusicKit/MusicLibrarySectionedRequest/filterItems(matching:contains:)-3s88f) Filters items by a given relationship that matches a specific value. [`func filterItems(matching: KeyPath, contains: String)`](/documentation/MusicKit/MusicLibrarySectionedRequest/filterItems(matching:contains:)-8rbsc) Filters items by a given property that contains a specific string. [`func filterItems(matching: KeyPath, contains: String)`](/documentation/MusicKit/MusicLibrarySectionedRequest/filterItems(matching:contains:)-9hpfh) Filters items by a given optional property that contains a specific string. [`func filterItems(matching: KeyPath, equalTo: Value)`](/documentation/MusicKit/MusicLibrarySectionedRequest/filterItems(matching:equalTo:)-3zn4r) Filters items by a given property that matches a specific value. [`func filterItems(matching: KeyPath, equalTo: Value?)`](/documentation/MusicKit/MusicLibrarySectionedRequest/filterItems(matching:equalTo:)-5ybaa) Filters items by a given optional property that matches a specific value. [`func filterItems(matching: KeyPath, memberOf: [Value])`](/documentation/MusicKit/MusicLibrarySectionedRequest/filterItems(matching:memberOf:)-49h2x) Filters items by a property for an array of possible values. [`func filterItems(matching: KeyPath, memberOf: [Value?])`](/documentation/MusicKit/MusicLibrarySectionedRequest/filterItems(matching:memberOf:)-zmb0) Filters items by an optional property for an array of possible values. [`func filterItems(text: String)`](/documentation/MusicKit/MusicLibrarySectionedRequest/filterItems(text:)) Filters items by a specific string. [`func filterSections(matching: KeyPath, contains: String)`](/documentation/MusicKit/MusicLibrarySectionedRequest/filterSections(matching:contains:)-3jf7b) Filters sections by a given optional property that contains a specific string. [`func filterSections(matching: KeyPath, contains: String)`](/documentation/MusicKit/MusicLibrarySectionedRequest/filterSections(matching:contains:)-5ptoy) Filters sections by a given property that contains a specific string. [`func filterSections(matching: KeyPath, equalTo: Value?)`](/documentation/MusicKit/MusicLibrarySectionedRequest/filterSections(matching:equalTo:)-5nop7) Filters sections by a given optional property that matches a specific value. [`func filterSections(matching: KeyPath, equalTo: Value)`](/documentation/MusicKit/MusicLibrarySectionedRequest/filterSections(matching:equalTo:)-7v8tr) Filters sections by a given property that matches a specific value. [`func filterSections(matching: KeyPath, memberOf: [Value])`](/documentation/MusicKit/MusicLibrarySectionedRequest/filterSections(matching:memberOf:)-4l0z8) Filters sections by a property for an array of possible values. [`func filterSections(matching: KeyPath, memberOf: [Value?])`](/documentation/MusicKit/MusicLibrarySectionedRequest/filterSections(matching:memberOf:)-746mb) Filters sections by an optional property for an array of possible values. [`func filterSections(text: String)`](/documentation/MusicKit/MusicLibrarySectionedRequest/filterSections(text:)) Filters sections by a specific string. [`func response() async throws -> MusicLibrarySectionedResponse`](/documentation/MusicKit/MusicLibrarySectionedRequest/response()) Fetches items grouped by sections from the user’s music library. [`func sortItems(by: KeyPath, ascending: Bool)`](/documentation/MusicKit/MusicLibrarySectionedRequest/sortItems(by:ascending:)) Sorts items by a specified property. [`func sortSections(by: KeyPath, ascending: Bool)`](/documentation/MusicKit/MusicLibrarySectionedRequest/sortSections(by:ascending:)) Sorts sections by a specified property. --- Copyright © 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)