Currents

{
  "service_type": "platform",
  "base_url": "https://currentsapi.services",
  "auth_method": "api_key",
  "auth_config": {
    "header": "Authorization",
    "scheme": "Bearer",
    "parameter": "apiKey",
    "description": "API key provided after registration; must be included in query parameter 'apiKey' or header 'Authorization: Bearer <apiKey>'."
  },
  "endpoints": [
    {
      "name": "Latest News",
      "path": "/en/api/v1/latest-news",
      "method": "GET",
      "description": "Retrieve breaking news articles with filters for language, country, and category.",
      "parameters": ["language", "country", "category", "page_number", "page_size"],
      "auth_required": true
    },
    {
      "name": "Search",
      "path": "/en/api/v1/search",
      "method": "GET",
      "description": "Search the archive for articles by keyword(s).",
      "parameters": ["keywords", "language", "country", "category", "start_date", "end_date", "page_number", "page_size"],
      "auth_required": true
    },
    {
      "name": "Available News Sources",
      "path": "/en/api/v1/available-news",
      "method": "GET",
      "description": "List news sources monitored by Currents, with metadata like category and language.",
      "parameters": ["language", "country", "category"],
      "auth_required": true
    },
    {
      "name": "Sources",
      "path": "/en/api/v1/sources",
      "method": "GET",
      "description": "Retrieve detailed information about available news sources (similar to available-news).",
      "parameters": ["language", "country", "category"],
      "auth_required": true
    },
    {
      "name": "OpenAPI Specification",
      "path": "/json/swagger.json",
      "method": "GET",
      "description": "Machine-readable OpenAPI specification for the API.",
      "parameters": [],
      "auth_required": false
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "free_tier": {
        "requests_per_day": 1000,
        "lookback_days": 30,
        "max_results_per_request": 20
      },
      "plans": [
        {
          "name": "Builder",
          "monthly_price_usd": 69,
          "requests_per_month": 75000,
          "lookback_months": 6,
          "max_results_per_request": 50
        },
        {
          "name": "Professional",
          "monthly_price_usd": 150,
          "requests_per_month": 300000,
          "lookback_months": 12,
          "max_results_per_request": 100
        },
        {
          "name": "Enterprise Self-Service",
          "monthly_price_usd": 300,
          "requests_per_month": 600000,
          "lookback_months": 12,
          "max_results_per_request": 200
        }
      ]
    }
  },
  "rate_limits": {
    "free": {
      "requests_per_day": 1000
    },
    "builder": {
      "requests_per_month": 75000,
      "burst": "not documented"
    },
    "professional": {
      "requests_per_month": 300000,
      "burst": "not documented"
    },
    "enterprise": {
      "requests_per_month": 600000,
      "burst": "not documented"
    }
  },
  "capabilities": [
    "Real-time news aggregation from 70+ countries",
    "Monitored news sources including blogs and forums",
    "Searchable archive of historical articles",
    "Multi-language support (20+ languages)",
    "Filtering by country, language, and category",
    "JSON responses",
    "OpenAPI specification",
    "Agent skills for LLM assistants (Mistral Vibe, Codex, OpenClaw, OpenCode, Hermes, OpenHands, Pi)",
    "Free tier with daily request limit",
    "Scalable pricing plans"
  ],
  "raw_analysis": "Currents is a commercial news aggregation API that provides real-time and historical news data from a wide range of sources across 70+ countries. It is positioned as a developer-friendly service with a free tier and multiple paid plans. The platform is mature, with a comprehensive documentation site, OpenAPI specification, and recently added agent skills for popular AI assistant frameworks, indicating an active development roadmap. The API is RESTful with straightforward endpoints for latest news and archive search, plus availability listing. Authentication is via API key. Pricing follows a freemium model with clear tiered plans based on monthly request volume, lookback period, and max results per request. Rate limits are primarily request-based, with daily limits for free and monthly for paid plans. The service offers significant value for developers needing structured news data, especially for applications requiring multi-language and multi-country coverage. However, the lack of detailed documentation on burst limits and response formats beyond samples might require contacting support for advanced use cases. Overall, it is a robust, production-ready news API suitable for startups, enterprises, and hobbyists."
}

3/3 tests passed

{
  "overall": 86,
  "dimensions": {
    "token_efficiency": 9.5,
    "first_try_success": 8.5,
    "response_parseability": 9.5,
    "error_clarity": 8.0,
    "doc_quality": 9.0,
    "auth_simplicity": 9.0,
    "latency": 7.5,
    "consistency": 9.0
  },
  "pricing_normalized": {
    "free_tier_requests_per_day": 1000,
    "builder_monthly_usd": 69,
    "professional_monthly_usd": 150,
    "enterprise_monthly_usd": 300
  },
  "issues": [
    "Latency slightly above 0.5s threshold (731ms homepage, 157ms for llms.txt) — acceptable but not ideal",
    "Some docs pages missing security headers (robots.txt test)",
    "Only 3 checks performed — limited validation"
  ],
  "recommendations": [
    "Ensure all pages including docs have consistent security headers",
    "Consider providing a status page or uptime history for users",
    "Add more examples and code snippets for quick integration"
  ]
}