NPR One

{
  "service_type": "platform",
  "base_url": "http://dev.npr.org/api",
  "auth_method": "api_key",
  "auth_config": {
    "api_key": "required",
    "location": "query"
  },
  "endpoints": [
    {
      "path": "/",
      "method": "GET",
      "description": "Root endpoint, may return service info or documentation."
    },
    {
      "path": "/stations/",
      "method": "GET",
      "description": "List NPR member stations."
    },
    {
      "path": "/listens/",
      "method": "GET",
      "description": "Get personalized listening recommendations and stream metadata."
    },
    {
      "path": "/channels/",
      "method": "GET",
      "description": "Get available channels (e.g., NPR News, entertainment)."
    },
    {
      "path": "/programs/",
      "method": "GET",
      "description": "Get list of NPR programs available for listening."
    },
    {
      "path": "/episodes/",
      "method": "GET",
      "description": "Get episodes for programs."
    },
    {
      "path": "/media/",
      "method": "GET",
      "description": "Get media assets (audio streams) for a given episode or segment."
    }
  ],
  "pricing_model": {
    "type": "free",
    "details": {
      "description": "NPR One API is free to use for personal or non-commercial applications. No explicit paid tiers documented on the dev portal."
    }
  },
  "rate_limits": {
    "unknown": true,
    "notes": "No explicit rate limits published. Recommended to use responsibly and check documentation for updates."
  },
  "capabilities": [
    "Personalized audio recommendations",
    "Station discovery",
    "Channel-based listening",
    "Program and episode metadata",
    "Audio stream retrieval",
    "Support for non-commercial apps",
    "Public API with key-based access"
  ],
  "raw_analysis": "NPR One is a personalized news and entertainment listening service by NPR. The developer API at dev.npr.org/api provides programmatic access to NPR's audio content, including personalized recommendations, station information, program/episode metadata, and audio streams. It's designed for developers building non-commercial applications that integrate NPR audio. The API requires an API key, likely obtained via registration on the dev portal. The platform is well-established as part of NPR's digital offerings, with documentation and examples available. It supports common tasks like fetching station lists, channels, programs, episodes, and media assets. There are no explicit rate limits or pricing tiers mentioned, indicating it's free but may have usage guidelines. Integration is straightforward via HTTP GET requests, making it suitable for mobile apps, web widgets, or voice assistants. The main maturity concern is that the API might not be as actively updated compared to commercial APIs, and personalization features may require additional user context. Overall, it's a valuable resource for NPR content access in non-commercial settings."
}

0/3 tests passed

```json
{
  "overall": 22,
  "dimensions": {
    "token_efficiency": 5.0,
    "first_try_success": 4.0,
    "response_parseability": 7.0,
    "error_clarity": 3.0,
    "doc_quality": 4.0,
    "auth_simplicity": 5.0,
    "latency": 2.0,
    "consistency": 2.0
  },
  "pricing_normalized": {
    "type": "free",
    "cost_model": "free",
    "tier_notes": "Free for personal/non-commercial use. No paid tiers documented"
  },
  "issues": [
    "All three network checks failed with DNS resolution errors ('No address associated with hostname') - indicates the platform domain is unreachable or DNS is misconfigured",
    "No HTTP response received at all (null status codes) - cannot confirm server exists or responds",
    "No security headers detected due to failed connections",
    "No llms.txt file found - no AI-agent friendly documentation endpoint",
    "Latency measurements (82-112ms) are meaningless as they only reflect DNS failure time, not actual server response",
    "Platform cannot be evaluated for uptime or response quality due to complete DNS failure"
  ],
  "recommendations": [
    "Fix DNS configuration for the NPR One API domain - currently unresolvable to any server",
    "Ensure the domain resolves and serves HTTPS responses for any API access",
    "Add a public llms.txt file with API documentation, authentication requirements, and endpoint schemas for AI agent discoverability",
    "Provide structured API metadata (OpenAPI spec or similar) to improve response parseability",
    "Add clear documentation on rate limits, authentication key process, and usage restrictions"
  ]
}
```