Retrieve a paginated list of Islamic finance and market news articles.

Returns news articles from all configured sources, optionally filtered by source, category, or free-text search query. Results are sorted by publication date (most recent first) and include sentiment scores.

curl example:

curl -X GET "http://localhost:8000/api/news?category=islamic_finance&page=1&page_size=10"

Python requests example:

import requests

resp = requests.get(
    "http://localhost:8000/api/news",
    params={"category": "islamic_finance", "page": 1, "page_size": 10},
)
data = resp.json()
for article in data["articles"]:
    print(article["title"], article["sentiment"])

{
  "articles": [
    {
      "category": "islamic_finance",
      "link": "https://example.com/articles/aaoifi-sukuk-update",
      "published": "2026-03-20T14:30:00Z",
      "sentiment": "positive",
      "sentiment_score": 0.72,
      "source_id": "islamic_finance_news",
      "source_name": "Islamic Finance News",
      "summary": "Revised standards for Sukuk structuring released.",
      "title": "AAOIFI Updates Shariah Standards for Sukuk Issuance"
    }
  ],
  "count": 2,
  "page": 1,
  "page_size": 20,
  "total": 2
}