API Documentation

Submit an article URL or text for multi-LLM analysis. Returns truth scores, bias detection, AI-generation markers, and a "Why Newsworthy" summary.

Request Body

{
  "url": "https://example.com/article",
  // OR
  "text": "Article content as plain text...",
  "options": {
    "models": ["gemini", "claude", "gpt4", "grok"], // optional, defaults to all
    "includeWhyNews": true,  // optional, default true
    "includeBias": true      // optional, default true
  }
}

Response

{
  "success": true,
  "data": {
    "articleId": "art_abc123",
    "url": "https://example.com/article",
    "title": "Extracted Article Title",
    "aggregateScore": 78,
    "consensusLevel": "medium",
    "ratings": [
      {
        "model": "gemini",
        "truthScore": 82,
        "biasDirection": "center",
        "biasStrength": 15,
        "aiGenerated": 25,
        "humanWritten": 75,
        "summary": "Factual reporting with minor promotional language."
      },
      // ... other models
    ],
    "whyNewsworthy": "This story signals a significant shift...",
    "analyzedAt": "2024-01-15T10:30:00Z"
  }
}

Retrieve a previously analyzed article by its ID. Useful for caching and avoiding re-analysis.

Response

{
  "success": true,
  "data": {
    "articleId": "art_abc123",
    "url": "https://example.com/article",
    "aggregateScore": 78,
    "ratings": [...],
    "cachedAt": "2024-01-15T10:30:00Z"
  }
}

Submit multiple articles for batch analysis. Ideal for agent workflows processing news feeds.

Request Body

{
  "articles": [
    { "url": "https://example.com/article1" },
    { "url": "https://example.com/article2" },
    { "text": "Raw article text..." }
  ],
  "webhook": "https://your-agent.com/callback" // optional async callback
}