Podcast API

{
  "service_type": "platform",
  "base_url": "https://www.listennotes.com/api",
  "auth_method": "api_key",
  "auth_config": {
    "header_name": "X-ListenAPI-Key",
    "query_param": null
  },
  "endpoints": [
    {
      "name": "search",
      "method": "GET",
      "path": "/api/v2/search",
      "description": "Search for podcasts and episodes by keyword, genre, language, etc."
    },
    {
      "name": "get_podcast",
      "method": "GET",
      "path": "/api/v2/podcasts/{id}",
      "description": "Get detailed information about a specific podcast."
    },
    {
      "name": "get_episode",
      "method": "GET",
      "path": "/api/v2/episodes/{id}",
      "description": "Get detailed information about a specific episode."
    },
    {
      "name": "related",
      "method": "GET",
      "path": "/api/v2/podcasts/{id}/related",
      "description": "Get related podcasts for a given podcast."
    },
    {
      "name": "best_podcasts",
      "method": "GET",
      "path": "/api/v2/best_podcasts",
      "description": "Get curated best podcasts, potentially by genre."
    },
    {
      "name": "curated_podcasts",
      "method": "GET",
      "path": "/api/v2/curated_podcasts/{id}",
      "description": "Get a curated podcast list by ID."
    },
    {
      "name": "genres",
      "method": "GET",
      "path": "/api/v2/genres",
      "description": "Get a list of podcast genres."
    },
    {
      "name": "typeahead",
      "method": "GET",
      "path": "/api/v2/typeahead",
      "description": "Typeahead search for podcasts and episodes."
    },
    {
      "name": "recommendations",
      "method": "GET",
      "path": "/api/v2/recommendations",
      "description": "Get personalized episode recommendations based on user's listening history (requires authentication)."
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "free_tier": "Limited requests per month (e.g., 15,000 requests/month) with attribution to Listen Notes.",
      "paid_tiers": " Pro and API tiers with higher rate limits, more features like recommendations, batch lookup, and no attribution requirement.",
      "more_info": "https://www.listennotes.com/api/pricing/"
    }
  },
  "rate_limits": {
    "free": "15,000 requests per month (approx. 500/day)",
    "paid": "Varies by plan; see pricing page for details",
    "other": "Rate limit headers are included in responses for monitoring."
  },
  "capabilities": [
    "Podcast search by keyword, genre, language, country, etc.",
    "Podcast metadata retrieval (title, description, artwork, website, etc.)",
    "Episode metadata retrieval (title, description, audio URL, duration, etc.)",
    "Related podcast recommendations",
    "Curated podcast lists",
    "Best podcasts rankings",
    "Genre taxonomy",
    "Typeahead/autocomplete search",
    "Personalized recommendations (for authenticated users)",
    "Supports multiple languages",
    "Podcast RSS feed parsing and indexing"
  ],
  "raw_analysis": "Listen Notes is a comprehensive podcast search and directory API, launched as a Show HN on Hacker News. It is designed for developers who want to build podcast-related applications, such as podcast players, discovery tools, analytics dashboards, or voice assistants. The platform maintains an extensive database of podcasts and episodes, updated regularly, and provides a unified REST API with JSON responses. Key features include search, metadata retrieval, related podcasts, curated best lists, and even recommendations. The API requires an API key for authentication, which is obtained by registering on the website. The free tier allows 15,000 requests per month, which is generous for prototyping, but for production use, paid plans offer higher limits and additional features. The API is mature and well-documented, with official client libraries in Python, JavaScript, and Ruby. It also integrates with popular platforms like Spotify and Apple Podcasts for metadata enrichment. The service is used by many developers and companies, and its pricing model is transparent. However, it is not open-source and relies on its own database, so data freshness may vary for indie podcasts. Overall, it's a solid choice for podcast-related development."
}

1/3 tests passed

{
  "overall": 72,
  "dimensions": {
    "token_efficiency": 8.0,
    "first_try_success": 7.0,
    "response_parseability": 9.0,
    "error_clarity": 6.0,
    "doc_quality": 7.0,
    "auth_simplicity": 6.0,
    "latency": 9.0,
    "consistency": 8.0
  },
  "pricing_normalized": {
    "free_tier_requests_per_month": 15000,
    "attribution_required": true,
    "paid_tiers_exist": true,
    "pricing_model": "freemium"
  },
  "issues": [
    "No /llms.txt file found - missing AI-friendly documentation endpoint",
    "No robots.txt found - accessibility metadata for crawlers missing",
    "Free tier requires attribution to Listen Notes, which may be a constraint for some use cases",
    "Site documentation not fully verified - may not cover all API limitations clearly"
  ],
  "recommendations": [
    "Add a /llms.txt file with concise API overview and endpoint documentation for AI agents",
    "Ensure robots.txt is present and clearly defines crawlable paths",
    "Provide explicit rate limit and error code documentation to improve error clarity",
    "Consider adding quick-start code samples in multiple languages to ease onboarding"
  ]
}