The Guardian

{
  "service_type": "platform",
  "base_url": "https://open-platform.theguardian.com",
  "auth_method": "api_key",
  "auth_config": {
    "api_key": "YOUR_API_KEY",
    "in": "query",
    "name": "api-key"
  },
  "endpoints": [
    {
      "path": "/content",
      "method": "GET",
      "params": {
        "q": "search terms",
        "section": "section id",
        "tag": "tag ids",
        "order-by": "newest|oldest|relevance",
        "page-size": "max 200",
        "page": "pagination",
        "format": "json|xml"
      },
      "description": "Search and retrieve content articles"
    },
    {
      "path": "/tags",
      "method": "GET",
      "params": {
        "q": "search tags",
        "type": "tag type",
        "page-size": "max 200"
      },
      "description": "List tags by keywords or type"
    },
    {
      "path": "/sections",
      "method": "GET",
      "params": {},
      "description": "List all content sections"
    },
    {
      "path": "/editions",
      "method": "GET",
      "params": {},
      "description": "List available editions (default: UK, US, AU, international)"
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "free_tier": "Free access to daily content (up to 500 calls/day per API key). More than 12 calls per second requires an API key. No commercial use without permission.",
      "paid_tier": "Commercial licences available. Premium access features include higher rate limits (up to 500 requests per day, with commercial options for higher). Pricing on request via contact form.",
      "trial": "Free API key with immediate access, but limited to 12 calls per second and 500 calls per day for non-commercial use."
    }
  },
  "rate_limits": {
    "free_tier": {
      "calls_per_second": 12,
      "calls_per_day": 500,
      "rules": "Rate limit enforced via token bucket; exceeding results in HTTP 429. For higher limits, contact Guardian."
    },
    "commercial_tier": "Higher limits, customised, not publicly documented."
  },
  "capabilities": [
    "Content search and retrieval across all Guardian sections",
    "Topic/tag-based filtering",
    "Section-based navigation",
    "Edition support (UK, US, AU, international)",
    "Support for JSON and XML responses",
    "Rich article metadata (webTitle, url, tags, section, publication date, etc.)",
    "Pagination and sorting (newest, oldest, relevance)",
    "Tag and section lists",
    "REST-based API with GET only"
  ],
  "raw_analysis": "The Guardian open-platform provides a RESTful API to access all published UK newspaper content, including articles, tags, and sections. It is designed for developers, journalists, and researchers who want to integrate Guardian journalism into their apps or analyses. The API is Mature and stable, with documented endpoints and a comprehensive developer portal. The service is free for non-commercial use, with a daily call limit and rate limit, while commercial licences are available for higher volume or commercial purposes. The API is read-only; it does not allow content submission or moderation. It highlights its strength in structured metadata (tags, sections) which enables semantic filtering. The API is used in many third-party integrations and news aggregators. Notably, it requires nothing more than a simple API key; authentication is via query parameter, and there is no OAuth. The platform is strictly content access, not a full publishing tool. For users needing only content retrieval, this is a robust and well-documented service. Integration with other platforms is possible via the JSON endpoints, making it suitable for feeding into CMS, marketing dashboards, or research datasets."
}

1/3 tests passed

```json
{
  "overall": 72,
  "dimensions": {
    "token_efficiency": 8.5,
    "first_try_success": 7.5,
    "response_parseability": 9.5,
    "error_clarity": 6.5,
    "doc_quality": 7.0,
    "auth_simplicity": 8.0,
    "latency": 9.5,
    "consistency": 7.5
  },
  "pricing_normalized": {
    "free_tier": "500 calls/day, 12 calls/sec, non-commercial",
    "paid_tier": "Commercial licenses, higher limits, pricing on request",
    "entry_barrier": "low"
  },
  "issues": [
    "robots.txt returns 404 (GitHub Pages-style error page)",
    "No llms.txt file available for agent discovery",
    "Free tier limited to 12 calls/second (may throttle bursts)",
    "Commercial use requires manual contact for pricing",
    "GET-only API limits interaction patterns"
  ],
  "recommendations": [
    "Add a properly configured robots.txt with clear crawl rules",
    "Create and publish an llms.txt file to aid agent discovery",
    "Consider making commercial pricing transparent on the site",
    "Add rate limit headers to API responses so agents can self-throttle",
    "Document the 12 call/sec limit more prominently in getting-started guides"
  ]
}
```