Premium News Clusters (Full)
1 creditGET /api/premium/history/news/clusters/fullRemoves the 25-cluster cap on the free /api/history/news/clusters endpoint. Returns every cluster (single, limited, broad) for a single UTC date or up to a 30-day range.
When to use this endpoint
When the agent needs every story cluster on a date, not just the top-25, e.g. for full-day news synthesis or RAG over the cross-source clustered corpus.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| date | query | string | Single UTC date YYYY-MM-DDe.g. 2026-05-09 |
| from | query | string | Range start (max 30 days)e.g. 2026-05-01 |
| to | query | string | Range ende.g. 2026-05-09 |
* required
Example response
{ "ok": true, "date": "2026-05-09", "total_clusters": 117, "clusters": [ { "cluster_id": "k3mn8q", "source_count": 5, "corroboration_band": "broad", "hero": { "title": "..." } } ], "billing": { "credits_charged": 1, "credits_remaining": 49 } }Code samples
Python SDK
tf._get("/premium/history/news/clusters/full", date="2026-05-09")TypeScript SDK
await fetch("https://tensorfeed.ai/api/premium/history/news/clusters/full?date=2026-05-09", { headers: { Authorization: "Bearer tf_live_..." } });FAQ
When should I use this vs the verified feed?
Verified is filtered to broad-corroboration (4+ sources). Full returns every cluster including singles. Use full when you want the long tail; verified when you want only confirmed-by-multiple-sources.