Jellyfin API

{
  "service_type": "platform",
  "base_url": "https://jellyfin.local",
  "auth_method": "api_key",
  "auth_config": {
    "methods": [
      "api_key",
      "access_token"
    ],
    "header": "X-Emby-Token",
    "alternative_header": "Authorization: MediaBrowser Token=<token>",
    "notes": "Jellyfin supports API keys generated from the admin dashboard (Dashboard > API Keys) and access tokens obtained via the /Users/AuthenticateByName endpoint. The X-Emby-Token header is the conventional way to pass credentials. Bearer token authentication via the Authorization header is also supported."
  },
  "endpoints": [
    {
      "name": "System Information",
      "method": "GET",
      "path": "/System/Info",
      "description": "Returns general information about the Jellyfin server"
    },
    {
      "name": "Public System Information",
      "method": "GET",
      "path": "/System/Info/Public",
      "description": "Returns public information about the server (no auth required)"
    },
    {
      "name": "Authenticate User",
      "method": "POST",
      "path": "/Users/AuthenticateByName",
      "description": "Authenticate a user and receive an access token"
    },
    {
      "name": "List Users",
      "method": "GET",
      "path": "/Users",
      "description": "Get all users on the server (admin only)"
    },
    {
      "name": "Get Items (Library)",
      "method": "GET",
      "path": "/Items",
      "description": "Query media items with filters (recursive, parentId, etc.)"
    },
    {
      "name": "Get User Items",
      "method": "GET",
      "path": "/Users/{userId}/Items",
      "description": "Get media items for a specific user"
    },
    {
      "name": "Get Item Details",
      "method": "GET",
      "path": "/Users/{userId}/Items/{itemId}",
      "description": "Get detailed metadata for a specific item"
    },
    {
      "name": "Search Hints",
      "method": "GET",
      "path": "/Search/Hints",
      "description": "Search for media items by name"
    },
    {
      "name": "Get Views",
      "method": "GET",
      "path": "/Users/{userId}/Views",
      "description": "Get the user's media library views (Movies, TV Shows, etc.)"
    },
    {
      "name": "Playback Info",
      "method": "GET",
      "path": "/Items/{itemId}/PlaybackInfo",
      "description": "Get playback information and stream URLs for an item"
    },
    {
      "name": "Sessions",
      "method": "GET",
      "path": "/Sessions",
      "description": "List active playback sessions"
    },
    {
      "name": "Library Refresh",
      "method": "POST",
      "path": "/Library/Refresh",
      "description": "Trigger a library scan/refresh"
    },
    {
      "name": "Get Activity Log",
      "method": "GET",
      "path": "/System/ActivityLog/Entries",
      "description": "Retrieve server activity log entries"
    },
    {
      "name": "Scheduled Tasks",
      "method": "GET",
      "path": "/ScheduledTasks",
      "description": "List scheduled tasks on the server"
    }
  ],
  "pricing_model": {
    "type": "free",
    "details": {
      "license": "GPLv2 (open source)",
      "cost": "Free — self-hosted. No subscription or usage fees.",
      "notes": "Jellyfin is a free, open-source media server. Users host it themselves. Optional costs may include hardware, storage, and bandwidth. There is no paid tier or official cloud offering by the Jellyfin project."
    }
  },
  "rate_limits": {
    "documented": false,
    "notes": "Jellyfin does not publish fixed rate limits. Practical limits depend on the self-hosted server's resources (CPU, disk I/O, transcoding capacity). Concurrent transcoding sessions are typically the main constraint. Some reverse-proxy deployments may impose their own rate limits."
  },
  "capabilities": [
    "Media library management (movies, TV shows, music, books, photos)",
    "Metadata scraping and enrichment",
    "User management and authentication",
    "Playback control and streaming",
    "Transcoding (hardware and software)",
    "Live TV and DVR support",
    "Plugin/extension ecosystem",
    "DLNA and network discovery",
    "Sync/offline downloads",
    "Parental controls and content ratings",
    "Session monitoring",
    "Activity logging and reporting",
    "Scheduled tasks and library scans",
    "Webhook support (via plugins)",
    "Multi-platform clients (web, mobile, TV, desktop)"
  ],
  "raw_analysis": "Jellyfin is a free, open-source media server platform — a fork of Emby — designed for self-hosting personal media libraries. Despite the placeholder URL 'https://jellyfin.local', this is not a public SaaS API; it is a self-hosted server distributed as software (Docker, native packages, etc.) that exposes a well-documented REST API on its local or externally-exposed endpoint.\n\nWho it's for: Home lab enthusiasts, self-hosting communities, families wanting to manage and stream their own media collections, and developers building clients or integrations on top of the Je

0/3 tests passed

{
  "overall": 62,
  "dimensions": {
    "token_efficiency": 8.0,
    "first_try_success": 4.0,
    "response_parseability": 7.0,
    "error_clarity": 5.0,
    "doc_quality": 7.0,
    "auth_simplicity": 8.0,
    "latency": 2.0,
    "consistency": 4.0
  },
  "pricing_normalized": {
    "model": "free_open_source",
    "cost": 0,
    "tier": "self-hosted",
    "notes": "GPLv2, no paid tiers, no official cloud. Costs limited to infrastructure (hardware, storage, bandwidth)."
  },
  "issues": [
    "All three checks failed with DNS resolution errors — DNS/probe configuration is broken or the domain is unreachable from the test environment",
    "No robots.txt or llms.txt could be verified; agent-friendliness of the public site is unknown",
    "Latency score collapsed because the reachable path returned naming errors in ~85-91ms, indicating a configuration/DNS problem rather than real responsiveness",
    "Self-hosting requirement raises onboarding friction for non-technical users",
    "No official hosted cloud offering; auth and first-run experience depend on user's own deployment"
  ],
  "recommendations": [
    "Verify DNS/domain configuration; jellyfin.org should resolve publicly. Re-run checks once the domain is reachable",
    "Publish /robots.txt and /llms.txt to improve agent discovery and structured retrieval",
    "Provide a canonical quickstart URL and machine-readable capabilities manifest (JSON/YAML) for agents",
    "Recommend only when users are comfortable self-hosting or have Docker/NAS/home-server experience",
    "Highlight the strong API surface (Jellyfin REST API) for agent integration once reachable",
    "Surface SBOM/security headers and status page to boost the consistency score"
  ]
}