> ## Documentation Index > Fetch the complete documentation index at: https://mintlify.com/jellyfin/jellyfin/llms.txt > Use this file to discover all available pages before exploring further. # Items API > Query, filter, and search media items in the Jellyfin library The Items API provides comprehensive access to media items in your Jellyfin library, including powerful filtering, searching, and sorting capabilities. ## Get Items Retrieve items based on a flexible query with extensive filtering options. ```bash cURL theme={null} curl -X GET "https://your-server/Items" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" \ -H "Content-Type: application/json" ``` ```javascript JavaScript theme={null} const response = await fetch('https://your-server/Items', { headers: { 'Authorization': 'MediaBrowser Token=YOUR_API_KEY' } }); const data = await response.json(); ``` ```python Python theme={null} import requests response = requests.get( 'https://your-server/Items', headers={'Authorization': 'MediaBrowser Token=YOUR_API_KEY'} ) items = response.json() ``` ### Endpoint GET `/Items` ### Query Parameters The user ID. Required when not using an API key. The record index to start at. All items with a lower index will be dropped from the results. The maximum number of records to return. When searching within folders, determines whether the search will be recursive. Filter based on a search term. Comma-delimited sort orders. Options: Album, AlbumArtist, Artist, Budget, CommunityRating, CriticRating, DateCreated, DatePlayed, PlayCount, PremiereDate, ProductionYear, SortName, Random, Revenue, Runtime. Sort order: Ascending, Descending. Comma-delimited. Specify this to localize the search to a specific item or folder. Omit to use the root. Comma-delimited additional fields: Budget, Chapters, DateCreated, Genres, HomePageUrl, IndexOptions, MediaStreams, Overview, ParentId, Path, People, ProviderIds, PrimaryImageAspectRatio, Revenue, SortName, Studios, Taglines. Filter by item type. Comma-delimited. Examples: Movie, Series, Episode, MusicAlbum, Audio, Book. Exclude specific item types. Comma-delimited. Additional filters. Comma-delimited. Options: IsFolder, IsNotFolder, IsUnplayed, IsPlayed, IsFavorite, IsResumable, Likes, Dislikes. Filter by items marked as favorite. Filter by MediaType. Comma-delimited. Options: Video, Audio, Photo, Book. Filter by genre. Pipe-delimited. Filter by production year. Comma-delimited. Filter by tag. Pipe-delimited. Filter by official rating (PG, PG-13, TV-MA, etc). Pipe-delimited. Filter by minimum community rating. Filter by minimum critic rating. The minimum premiere date. The maximum premiere date. Filter by items with theme songs. Filter by items with theme videos. Filter by items with subtitles. Filter by items with trailers. Filter by items that are HD. Filter by items that are 4K. Filter by items that are 3D. Filter by items that have been played. Include user data in the response. Include image information in output. Enable the total record count. ### Response Array of BaseItemDto objects representing the media items. Unique identifier for the item. The name of the item. The type of item (Movie, Series, Episode, etc). The file system path to the item. The item description/overview. Array of genre names. Year the item was produced. Community rating score. Runtime in ticks (10,000 ticks = 1 millisecond). User-specific data for this item. Total number of items matching the query. The starting index of the results. ### Response Codes * `200` - Success: Items returned * `400` - Bad Request: userId is required when not using API key * `401` - Unauthorized: User does not have permission to access the library * `404` - Not Found: Library or parent item not found *** ## Get Resume Items Get items that can be resumed for a user. ```bash cURL theme={null} curl -X GET "https://your-server/UserItems/Resume?userId=USER_ID&limit=10" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` ### Endpoint `GET /UserItems/Resume` ### Query Parameters The user ID. The record index to start at. The maximum number of records to return. Specify this to localize the search to a specific item or folder. Whether to exclude currently active sessions. ### Response Codes * `200` - Success: Resume items returned * `404` - Not Found: User not found *** ## Get/Update Item User Data Manage user-specific data for an item (play count, favorite status, etc). ### Get Item User Data ```bash Get theme={null} curl -X GET "https://your-server/UserItems/{itemId}/UserData?userId=USER_ID" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` `GET /UserItems/{itemId}/UserData` ### Update Item User Data ```bash Update theme={null} curl -X POST "https://your-server/UserItems/{itemId}/UserData" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "IsFavorite": true, "Played": true, "PlaybackPositionTicks": 0 }' ``` `POST /UserItems/{itemId}/UserData` ### Request Body (Update) Whether the item is marked as favorite. Whether the item has been played. Playback position in ticks. Number of times played. User rating (likes/dislikes). ### Response Current playback position. Number of times the item has been played. Whether marked as favorite. Whether the item has been played. Date the item was last played. ### Response Codes * `200` - Success: User data returned/updated * `403` - Forbidden: User not allowed to view/update this data * `404` - Not Found: Item or user not found