Tagtaly API Documentation

Base URL

GET https://tagtaly.com/api/v1/

Endpoints

Path	Description	Response
/stats-YYYY-MM-DD.json	Daily stats (sources, topics, sentiment)	Object
/stats-daily.json	Latest daily stats	Object
/articles-topic-*.json	Top articles for a topic	List
/articles-source-*.json	Top articles for a source	List
/articles-recent.json	Recent articles across all sources	List
/trends-1d.json	Topic trends for 1 day	List
/trends-7d.json	Topic trends for 7 days	List
/trends-14d.json	Topic trends for 14 days	List
/trends-30d.json	Topic trends for 30 days	List
/index.json	API index and metadata	Object

Example

fetch('https://tagtaly.com/api/v1/stats-daily.json')
  .then(res => res.json())
  .then(data => console.log(data));

Response Schema Examples

{
  "metadata": { "api_version": "v1", "generated_at": "2025-12-08T12:00:00Z" },
  "date": "2025-12-08",
  "article_count": 120,
  "sources": [ { "source": "BBC", "count": 32 } ],
  "topics": [ { "topic": "Politics", "count": 18, "avg_sentiment": 0.12 } ],
  "sentiment": { "positive": 42.5, "neutral": 38.3, "negative": 19.2 }
}

{
  "metadata": { "api_version": "v1", "generated_at": "2025-12-08T12:00:00Z" },
  "topic": "Politics",
  "article_count": 50,
  "articles": [
    { "headline": "Example headline", "source": "BBC", "viral_score": 12.4 }
  ]
}

{
  "metadata": { "api_version": "v1", "generated_at": "2025-12-08T12:00:00Z" },
  "period_days": 7,
  "topics": [
    { "topic": "Politics", "current_count": 82, "previous_count": 60, "percent_change": 36.7 }
  ]
}

Authentication

No API key is required. Endpoints are read-only and public.

CORS

CORS is enabled for all origins. You can call the API directly from browser-based apps.

Versioning Policy

API responses are versioned by URL path. We maintain backward compatibility for /api/v1/ with additive-only changes. Breaking changes will ship on a new major version (e.g. /api/v2/) with a 12-month deprecation notice.

Data Coverage

Daily stats files cover the last 30 days and are regenerated daily. Historical data is retained indefinitely in the database. Trend endpoints provide analysis windows of 1 day, 7 days, 14 days, and 30 days as separate files.

Rate Limits

Standard access: 60 requests per minute. Contact us for higher limits.

Pricing

Starter

Free for non-commercial projects.

Business

Custom pricing for newsroom and enterprise use.

Partner

Dedicated SLAs and custom datasets.

Request Access