TVDB

{
  "service_type": "platform",
  "base_url": "https://thetvdb.com",
  "auth_method": "api_key",
  "auth_config": {
    "api_key": "required",
    "header": "Authorization",
    "scheme": "Bearer",
    "additional_headers": {
      "Accept-Language": "en",
      "Content-Type": "application/json"
    }
  },
  "endpoints": [
    {
      "path": "/api/v4/login",
      "method": "POST",
      "description": "Authenticate using apikey and obtain JWT token",
      "required_headers": ["Content-Type"],
      "body": {
        "apikey": "string",
        "username": "optional",
        "userkey": "optional"
      }
    },
    {
      "path": "/api/v4/series",
      "method": "GET",
      "description": "Retrieve list of series with filtering options",
      "required_headers": ["Authorization"],
      "parameters": {
        "page": "integer",
        "limit": "integer",
        "id": "integer",
        "name": "string",
        "slug": "string",
        "country": "string",
        "year": "integer",
        "status": "string",
        "studio": "integer",
        "network": "integer",
        "sort": "string"
      }
    },
    {
      "path": "/api/v4/series/{id}",
      "method": "GET",
      "description": "Get detailed information for a specific series",
      "required_headers": ["Authorization"],
      "parameters": {}
    },
    {
      "path": "/api/v4/series/{id}/episodes",
      "method": "GET",
      "description": "Get episodes for a series",
      "required_headers": ["Authorization"],
      "parameters": {
        "page": "integer",
        "limit": "integer",
        "episodeType": "string",
        "season": "integer"
      }
    },
    {
      "path": "/api/v4/series/{id}/artworks",
      "method": "GET",
      "description": "Get artworks for a series (posters, banners, etc.)",
      "required_headers": ["Authorization"],
      "parameters": {}
    },
    {
      "path": "/api/v4/artworks/{id}",
      "method": "GET",
      "description": "Get artwork details",
      "required_headers": ["Authorization"],
      "parameters": {}
    },
    {
      "path": "/api/v4/episodes/{id}",
      "method": "GET",
      "description": "Get detailed episode information",
      "required_headers": ["Authorization"],
      "parameters": {}
    },
    {
      "path": "/api/v4/search",
      "method": "GET",
      "description": "Search for TV series by name or other criteria",
      "required_headers": ["Authorization"],
      "parameters": {
        "q": "string",
        "type": "string (series, episode, movie)",
        "year": "integer",
        "country": "string"
      }
    },
    {
      "path": "/api/v4/languages",
      "method": "GET",
      "description": "List supported languages",
      "required_headers": ["Authorization"],
      "parameters": {}
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "free": {
        "description": "Access with API key, limited rate limits, community-driven data",
        "limits": [
          "Rate limited to 50 requests per day for basic usage",
          "Requires free registration to obtain API key",
          "No commercial use without additional agreement"
        ]
      },
      "paid": {
        "description": "Higher rate limits and commercial usage available via paid plans",
        "details": {
          "available": false,
          "note": "As of 2025, TVDB offers a premium API for higher usage, but details not publicly listed on the page."
        }
      }
    }
  },
  "rate_limits": {
    "default": {
      "requests_per_day": 50,
      "requests_per_second": 1,
      "note": "Free API key limitations; higher limits for paid subscribers or approved apps."
    }
  },
  "capabilities": [
    "Comprehensive TV series metadata",
    "Episode data and air dates",
    "Artwork (posters, fanart, banners, etc.)",
    "Translations in multiple languages",
    "Search and discovery",
    "User-contributed content",
    "Community moderation",
    "Trending and popular series",
    "Series recommendations",
    "Data export (JSON via API)",
    "Integration with media centers (Plex, Kodi, etc.) through API"
  ],
  "raw_analysis": "TheTVDB is a community-driven television metadata database, similar to IMDb or TMDb, but focused exclusively on TV shows. The platform is well-established, having been around since 2006, and is widely used by media players and home theater software like Plex, Kodi, and Emby to enrich their libraries with cover art, episode summaries, and air dates.\n\nMaturity: The platform is mature, with a stable v4 API (restful, JSON-based) that has been in use for several years. The previous XML-based v2 API is deprecated but still functional. The community has a significant number of contributors, ensuring data completeness for many shows, though coverage may be spotty for niche or new series.\n\nMain features: The API provides endpoints for series, episodes, artwork, and search. It supports multiple languages and inc

2/3 tests passed

```json
{
  "overall": 72,
  "dimensions": {
    "token_efficiency": 6.5,
    "first_try_success": 6.0,
    "response_parseability": 8.5,
    "error_clarity": 6.5,
    "doc_quality": 7.0,
    "auth_simplicity": 6.5,
    "latency": 9.0,
    "consistency": 7.5
  },
  "pricing_normalized": {
    "free_tier": "50 requests/day with API key",
    "paid_tier": "Not publicly documented, details unclear",
    "commercial_use": "Requires additional agreement, no public pricing",
    "registration_required": true
  },
  "issues": [
    "Free tier severely limited at 50 requests/day — prohibitive for most agent use cases",
    "No /llms.txt file — agents cannot easily discover API docs via standard AI convention",
    "Pricing for paid tier is opaque — no public rate card or plan details",
    "API endpoints explicitly disallowed in robots.txt, suggesting scraping is not welcome",
    "No security headers detected on the main site",
    "Commercial licensing unclear — may require sales engagement, slowing autonomous adoption"
  ],
  "recommendations": [
    "Add /llms.txt to expose API documentation and terms in a machine-readable format",
    "Publish transparent paid tier pricing to allow agents to estimate costs before committing",
    "Consider raising free tier limit beyond 50/day to enable meaningful testing and prototyping",
    "Clarify commercial use terms and licensing paths explicitly in documentation",
    "Add structured error codes to API responses to improve agent error handling",
    "Implement SSO or OAuth to streamline authentication for programmatic access"
  ]
}
```