Tagtaly API Documentation
Production-ready JSON endpoints for real-time news signals, sentiment movement, and trend coverage.
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.