Skip to main content

​
Overview

The get_domain tool returns a comprehensive profile of a news outlet, including publication stats, coverage timeline, top persons and organizations covered, and recent articles.

​
Parameters

​
domain
string
required
Domain name to profile. Examples: reuters.com, apnews.com, bbc.com, cnn.com, nytimes.com.
​
days
integer
default:"1"
Lookback window in days. Values ≤ 7 use a 7-day aggregation; 8–30 use a 30-day aggregation. Max 30.
​
article_limit
integer
default:"10"
Number of recent articles to include, sorted by date DESC. Max 50.

​
Response Shape

{
  "success": true,
  "domain": {
    "domain": "reuters.com",
    "title": "Reuters",
    "basket": "Global Flagship",
    "category": "wire_service"
  },
  "stats": {
    "total_articles": 4521,
    "total_entities": 892,
    "avg_sentiment": -0.8
  },
  "timeline": [
    { "date": "2025-02-27", "article_count": 142, "avg_tone": -1.2 }
  ],
  "top_persons": [
    { "name": "donald trump", "article_count": 87 }
  ],
  "top_organizations": [
    { "name": "united nations", "article_count": 52 }
  ],
  "recent_articles": [
    {
      "source_url": "https://...",
      "page_title": "...",
      "article_date": "2025-02-27"
    }
  ]
}

​
Usage Examples

# Reuters profile — last 7 days
GET /api/v1/domain?domain=reuters.com&days=7

# BBC profile with more articles
GET /api/v1/domain?domain=bbc.com&days=30&article_limit=25