API Docs

All endpoints return JSON. Use query parameters for filtering. Quotas and benchmarks below are placeholders and should be confirmed for production.

{
  "fetchedAt": 1710000000000,
  "articles": [
    {
      "title": "Headline",
      "link": "https://...",
      "source": "Reuters",
      "publishedAt": "2024-05-01T10:12:00Z",
      "sentiment_label": "Positive",
      "sentiment_scores": { "pos": 52, "neu": 33, "neg": 15 },
      "confidence": 0.72,
      "top_phrases": ["market rally", "record high", "earnings"],
      "description": "...",
      "image": "..."
    }
  ]
}

{
  "fetchedAt": 1710000000000,
  "stories": [
    {
      "storyId": "abcd1234",
      "canonicalTitle": "Election campaign begins",
      "storySentiment": { "pos": 44, "neu": 38, "neg": 18 },
      "storyConfidence": 0.63,
      "storyTopPhrases": ["campaign launch", "voter outreach", "manifesto"],
      "articles": ["..."]
    }
  ]
}

{
  "url": "https://...",
  "model": "transformer",
  "sentiment_label": "Neutral",
  "sentiment_scores": { "pos": 29, "neu": 50, "neg": 21 },
  "confidence": 0.58,
  "top_phrases": ["policy update", "minister said", "growth outlook"],
  "generatedAt": "2024-05-01T10:12:00Z"
}

{
  "fetchedAt": 1710000000000,
  "articles": [
    {
      "title": "Global markets steady",
      "link": "https://...",
      "source": "BBC",
      "publishedAt": "2024-05-01T10:12:00Z",
      "description": "..."
    }
  ]
}