News

{
  "service_type": "platform",
  "base_url": "https://newsapi.org",
  "auth_method": "api_key",
  "auth_config": {
    "api_key_location": "query",
    "api_key_param": "apiKey",
    "description": "API key required for all requests, obtained by registering on the site."
  },
  "endpoints": [
    {
      "path": "/v2/top-headlines",
      "method": "GET",
      "description": "Returns live top and breaking headlines for a country, specific category in a country, single source, or multiple sources. Required parameters: country, category, sources, or q. Optional: pageSize, page, q."
    },
    {
      "path": "/v2/everything",
      "method": "GET",
      "description": "Search through millions of articles from over 150,000 large and small news sources and blogs. Requires 'q' or 'sources' parameter. Optional: from, to, sortBy, language, pageSize, page."
    },
    {
      "path": "/v2/sources",
      "method": "GET",
      "description": "Returns the subset of news publishers that top headlines are available from. Mainly used to discover sources and their metadata. Optional: category, language, country."
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "free_tier": "Developer plan (free): 100 requests per day, 2.5k requests per 24 hours (increments of 6 hours), only available for localhost or development.",
      "paid_plans": [
        "Startup: $99/month, 1,000 requests per day, 15k per 24 hours, available for non-commercial and commercial use.",
        "Professional: $249/month, 2,000 requests per day, 30k per 24 hours, includes premium features.",
        "Enterprise: Custom pricing, higher limits and support."
      ]
    }
  },
  "rate_limits": {
    "free_tier": "100 requests per day (UTC time window), 2.5k requests per 24 hours (increments of 6 hours)",
    "startup": "1,000 requests per day, 15k per 24 hours",
    "professional": "2,000 requests per day, 30k per 24 hours",
    "enterprise": "Custom limits",
    "rate_limit_headers": "X-RateLimit-Remaining: number of requests remaining in current window; X-RateLimit-Limit: total allowed for window"
  },
  "capabilities": [
    "Live top headlines from multiple sources",
    "Search across millions of articles from over 150,000 news sources",
    "Filter by country, category, source, language, and date",
    "Discover available news sources with metadata",
    "Sort results by relevance, popularity, or publication date",
    "Pagination with pageSize and page parameters",
    "JSON response format with article metadata (author, title, description, url, image, publishedAt, content)",
    "Category support: business, entertainment, general, health, science, sports, technology",
    "Country support: over 30 countries",
    "Language support: over 10 languages (via everything endpoint)"
  ],
  "raw_analysis": "NewsAPI.org is a SaaS platform that aggregates headlines and articles from a wide range of news sources and blogs, providing a programmatic API for developers and businesses. It serves as a meta-aggregator, offering access to live top headlines and historical article search. It targets developers building news aggregators, media monitoring tools, or content-based applications. The platform is mature, having been established since 2015 and widely used in the industry. It supports RESTful endpoints with API key authentication. Integrations are primarily through REST calls, and there are official client libraries in many programming languages (e.g., Python, JavaScript, Node.js, PHP) as well as community contributions. It does not provide a web dashboard for browsing data directly; it's purely an API. Pricing is freemium with a free developer plan limited to development use, and paid subscriptions starting at $99/month for commercial use. The API is straightforward to use, with detailed documentation and a rate-limited request model. Potential limitations include throttling on free tier and lack of real-time streaming; it provides snapshot of headlines. Overall, it's a dependable and reliable source for news aggregation."
}

2/3 tests passed

```json
{
  "overall": 62,
  "dimensions": {
    "token_efficiency": 8.0,
    "first_try_success": 6.5,
    "response_parseability": 9.5,
    "error_clarity": 5.0,
    "doc_quality": 6.5,
    "auth_simplicity": 7.0,
    "latency": 9.0,
    "consistency": 4.0
  },
  "pricing_normalized": {
    "free_tier": "100 requests/day, localhost only",
    "entry_paid": "$99/month for 1,000 requests/day",
    "mid_tier": "$249/month for 2,000 requests/day",
    "enterprise": "Custom"
  },
  "issues": [
    "No llms.txt file - no structured AI-readable documentation",
    "robots.txt disallows /v1/ and /v2/ which may block AI crawlers from accessing API docs",
    "Free tier limited to localhost development only - can't build production apps without paid plan",
    "Pricing seems high relative to free alternatives (e.g., GNews, current news via RSS)",
    "No explicit error code documentation mentioned in capabilities"
  ],
  "recommendations": [
    "Add llms.txt with API docs for AI agents",
    "Allow free tier to work on production domains with lower limits",
    "Document error codes and rate limit headers more prominently",
    "Consider adding a 'recent news' endpoint that doesn't require API key for simple queries",
    "Add webhook support or streaming for real-time news delivery"
  ]
}
```