Premium Attention Series
1 creditGET /api/premium/attention/seriesThe /api/premium/attention/series endpoint returns the daily attention score for one provider over the requested date range, plus first/last/delta/min/max/avg summary. Backed by the daily snapshot at 7 AM UTC. Range capped at 90 days, default 30 days back. The historical series compounds with time and cannot be backfilled, so this is the natural premium tier for the free attention index.
When to use this endpoint
When your agent wants to know whether attention on a specific provider is trending up or down over time, not just the live snapshot. The summary block makes "is it growing or shrinking" a one-field check.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| provider* | query | string | Provider id (anthropic, openai, google, meta, mistral, cohere, deepseek, xai, perplexity, nvidia, huggingface, cursor)e.g. anthropic |
| from | query | string | Start date YYYY-MM-DD (default: 30 days ago)e.g. 2026-04-01 |
| to | query | string | End date YYYY-MM-DD (default: today)e.g. 2026-04-30 |
* required
Example response
{
"ok": true,
"provider": "anthropic",
"range": { "from": "2026-04-01", "to": "2026-04-30", "days": 30 },
"summary": {
"first": 87.3, "last": 100, "delta": 12.7,
"min": 71.2, "max": 100, "avg": 88.1, "captured_days": 30
},
"series": [
{ "date": "2026-04-01", "attention_score": 87.3, "rank": 2, "news_24h": 4, "news_7d": 18, "trending_repos": 2, "agent_hits": 11 }
],
"billing": { "credits_charged": 1, "credits_remaining": 49 }
}Code samples
Python SDK
from tensorfeed import TensorFeed
tf = TensorFeed(token="tf_live_...")
series = tf._get(
"/premium/attention/series",
provider="anthropic",
**{"from": "2026-04-01", "to": "2026-04-30"},
)
print(f"Anthropic attention: {series['summary']['first']} -> {series['summary']['last']} ({series['summary']['delta']:+.1f})")TypeScript SDK
const res = await fetch(
"https://tensorfeed.ai/api/premium/attention/series?provider=anthropic&from=2026-04-01&to=2026-04-30",
{ headers: { Authorization: "Bearer tf_live_..." } }
);
const series = await res.json();
console.log(series.summary);FAQ
Can I get a series across multiple providers in one call?
Not in v1. Issue parallel requests per provider id. Each call is one credit.
How far back can I query?
The system enforces a 90-day max range per request. The earliest available date is the day daily capture started in late April 2026; query /api/attention/history first to discover the oldest captured date.
What is the delta field?
The change between the first non-null attention_score in the range and the last non-null score. Positive means growing attention, negative means shrinking.