GNews

{
  "service_type": "platform",
  "base_url": "https://gnews.io",
  "auth_method": "api_key",
  "auth_config": {
    "api_key_query_param": "apikey",
    "api_key_header": "X-Api-Key"
  },
  "endpoints": [
    {
      "path": "/api/v4/search",
      "method": "GET",
      "description": "Full-text search across global news articles with filtering and sorting.",
      "params": [
        "q", "lang", "country", "category", "from", "to", "sortby", "max", "page", "apikey"
      ]
    },
    {
      "path": "/api/v4/top-headlines",
      "method": "GET",
      "description": "Fetch top headlines filtered by category, language, and country.",
      "params": [
        "category", "lang", "country", "max", "page", "apikey"
      ]
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "free": {
        "price_monthly": 0,
        "requests_per_day": 100,
        "requests_per_second": 1,
        "articles_per_request": 10
      },
      "essential": {
        "price_monthly": 49.99,
        "requests_per_day": 1000,
        "requests_per_second": 10,
        "articles_per_request": 25
      },
      "business": {
        "price_monthly": 99.99,
        "requests_per_day": 5000,
        "requests_per_second": 10,
        "articles_per_request": 50
      },
      "enterprise": {
        "price_monthly": 249.99,
        "requests_per_day": 25000,
        "requests_per_second": 10,
        "articles_per_request": 100
      },
      "custom": {
        "description": "Higher volumes available on request"
      }
    }
  },
  "rate_limits": {
    "free": {
      "requests_per_day": 100,
      "requests_per_second": 1
    },
    "essential": {
      "requests_per_day": 1000,
      "requests_per_second": 10
    },
    "business": {
      "requests_per_day": 5000,
      "requests_per_second": 10
    },
    "enterprise": {
      "requests_per_day": 25000,
      "requests_per_second": 10
    }
  },
  "capabilities": [
    "real-time news aggregation from 80,000+ sources",
    "full-text search with query operators (AND, OR, NOT, quoted phrases)",
    "filtering by language (41 supported), country (71 supported), and category",
    "historical article access depending on plan",
    "configurable article count per request (up to 100 with higher tiers)",
    "JSON output format",
    "official SDKs for JavaScript and PHP",
    "community libraries",
    "REST API with simple authentication via API key"
  ],
  "raw_analysis": "GNews API is a mature, developer-friendly SaaS platform that aggregates news articles from over 80,000 sources across 41 languages and 71 countries. It offers a simple REST API with two main endpoints: /search for full-text search and /top-headlines for top headlines. Authentication is via an API key, either as a query parameter or header. The platform is well-documented with official SDKs for JavaScript and PHP, and community libraries. It supports advanced filtering (language, country, category, date range) and sorting, making it suitable for news aggregation dashboards, market monitoring, AI pipelines, and academic research. Pricing is freemium with free tier for development, and paid tiers starting at €49.99/month with increasing rate limits and article counts. Rate limits are clearly defined per plan. The platform is reliable and widely used as a Google News API replacement. Overall, it is a solid choice for integrating global news data into applications."
}

3/3 tests passed

```json
{
  "overall": 82,
  "dimensions": {
    "token_efficiency": 8.5,
    "first_try_success": 7.5,
    "response_parseability": 9.0,
    "error_clarity": 7.0,
    "doc_quality": 8.5,
    "auth_simplicity": 8.0,
    "latency": 9.5,
    "consistency": 8.0
  },
  "pricing_normalized": {
    "free_tier_viability": "Good for testing — 100 req/day, 10 articles per request, enough for demos",
    "entry_paid_cost": 49.99,
    "value_for_agents": "Moderate — 1000 req/day likely sufficient for most agent use cases",
    "scaling_cost": "Scales linearly but jumps — 5x requests cost 2x on business tier",
    "per_request_value": "Competitive with similar news APIs at $0.05-0.10 per 100 requests"
  },
  "issues": [
    "Free tier limits article count per request to 10, which may require multiple calls for comprehensive searches",
    "No explicit rate limit documentation beyond requests per second — possible 429 errors unhandled",
    "API key authentication is simple but not SSO — requires manual key generation",
    "No webhook or streaming support — polling required, adding latency to real-time use cases",
    "Historical article access is plan-dependent — free tier may have limited date range"
  ],
  "recommendations": [
    "Onboarding: Generate API key via dashboard — no email verification required, 5-minute setup",
    "First call: Use GET /search?q=technology&lang=en&apikey=YOUR_KEY — returns structured JSON",
    "For high-volume needs, use business tier ($99.99) with 25k req/day for batch processing",
    "Cache results client-side — 174ms latency suggests room for optimization",
    "Consider using llms.txt and robots.txt allowances for AI crawlers — indicates agent-friendly stance",
    "Provide documentation link: https://gnews.io/docs — clear examples in multiple languages"
  ]
}
```