# Tanod utilpeek – Topic Attention Trends

> Tanod utilpeek – Topic Attention Trends is a paid API for AI agents from tanod.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-12).

Returns time-series attention signals (Wikipedia page views by language, Hacker News stories/comments, news mentions) for up to 5 topics over a configurable date range, with trend direction and spike detection.

## Facts

- Endpoint: POST https://tanod.dev/v1/trends/attention?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tanod-utilpeek-topic-attention-trends-3391f932
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yL1RNUkmPR9Iu1Gv_jIvC

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tanod-utilpeek-topic-attention-trends-3391f932 -d '<json body>'
```

Example prompt: Has interest in 'large language models' been rising or falling over the last 90 days? Show me the Wikipedia page view trend, Hacker News activity, and news mentions, and flag any spike days.

## When to prefer this

Choose this endpoint when you need objective, open-data proxies for public interest in a topic over time — specifically Wikipedia page views, Hacker News engagement, and news mention counts. It is not Google Trends data and does not reflect search volume, but it provides multilingual Wikipedia signals across up to 6 languages and cross-source corroboration. Prefer it over general web-search trend APIs when you need reproducible, citation-backed attention data, multilingual audience signals, or spike detection grounded in Wikimedia and GDELT data.

## Known failure modes

- Topic not found on Wikipedia — returns found:false with no daily data
- Requested date range exceeds 365 days — clamped or rejected
- Language code has no Wikipedia article for the topic — listed under languages_skipped
- News coverage not yet available for the full date range — unavailable_reason returned
- More than 5 topics submitted — request rejected by schema validation
- End date in the future — clamped to yesterday automatically

## How this service works

Use when an agent must tell if interest in a topic is rising or fading: Wikipedia, Hacker News and news over time. Topic trends and attention over time: Wikipedia page views per language, Hacker News…

## Output

A JSON object per topic containing: resolved Wikipedia article title and URL, daily time-series rows with Wikipedia views per language, Hacker News story and comment counts, and news mention counts; aggregate 7-day and 28-day percentage changes; trend direction (rising/stable/falling); spike days with ratio above trailing median; optional related top/rising topics; caveats and data attribution.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "end": {
   "anyOf": [
    {
     "type": "string",
     "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Last day, YYYY-MM-DD (UTC), at most yesterday (later is clamped to it). Default: yesterday. The range is at most 365 days."
  },
  "start": {
   "anyOf": [
    {
     "type": "string",
     "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "First day, YYYY-MM-DD (UTC). Default: 90 days ending at `end`."
  },
  "topics": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 100,
    "minLength": 1
   },
   "maxItems": 5,
   "minItems": 1,
   "description": "1 to 5 topics (words or a name, up to 100 characters each). Each is resolved to the top English Wikipedia search hit, reported as `article.title`. Several topics are compared: each gets its relative share."
  },
  "related": {
   "anyOf": [
    {
     "type": "boolean"
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Default false. True (one topic only) adds `related`: up to 10 `top` and 10 `rising` related Wikipedia topics, ranked by page views; not search queries and not Google Trends data."
  },
  "languages": {
   "anyOf": [
    {
     "type": "array",
     "items": {
      "type": "string",
      "pattern": "^[A-Za-z]{2,3}$"
     },
     "maxItems": 6,
     "minItems": 1
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Optional Wikipedia language codes, at most 6 (en, de, ja ...). Default: en plus the four most-read languages that have the article. A language without the article is listed under `languages_skipped`."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "end": "2026-10-11",
  "days": 90,
  "label": "public attention signals (Wikipedia views, Hacker News, news mentions) - not Google Trends data",
  "start": "2026-07-14",
  "method": "wikipedia: Wikimedia daily page views of the article found by search and of its interlanguage titles ...",
  "topics": [
   {
    "news": {
     "mentions": 1840,
     "available": true,
     "coverage_start": "2026-09-28",
     "unavailable_reason": null
    },
    "daily": [
     {
      "date": "2026-10-10",
      "wikipedia": {
       "en": 2612,
       "ja": 1050,
       "total": 5701
      },
      "hn_stories": 2,
      "hn_comments": 31,
      "news_mentions": 52
     },
     {
      "date": "2026-10-11",
      "wikipedia": {
       "en": 2599,
       "ja": 1102,
       "total": 5710
      },
      "hn_stories": 1,
      "hn_comments": 24,
      "news_mentions": 47
     }
    ],
    "found": true,
    "topic": "bitcoin",
    "trend": {
     "basis": "wikipedia",
     "direction": "rising",
     "change_7d_pct": 12,
     "direction_28d": "stable",
     "change_28d_pct": -6.3,
     "stable_within_pct": 10
    },
    "change": {
     "news": {
      "7d": {
       "last": 640,
       "previous": 590,
       "change_pct": 8.5
      },
      "28d": null
     },
     "wikipedia": {
      "7d": {
       "last": 41200,
       "previous": 36800,
       "change_pct": 12
      },
      "28d": {
       "last": 160300,
       "previous": 171000,
       "change_pct": -6.3
      }
     },
     "hacker_news": {
      "7d": {
       "last": 150,
       "previous": 120,
       "change_pct": 25
      },
      "28d": null
     }
    },
    "article": {
     "url": "https://en.wikipedia.org/wiki/Bitcoin",
     "title": "Bitcoin",
     "language": "en",
     "alternatives": [
      "Bitcoin Cash",
      "History of bitcoin"
     ],
     "disambiguation_page": false
    },
    "wikipedia": {
     "languages": [
      {
       "title": "Bitcoin",
       "views": 241180,
       "language": "en"
      },
      {
       "title": "ビットコイン",
       "views": 98544,
       "language": "ja"
      }
     ],
     "total_views": 515210,
     "languages_skipped": []
    },
    "spike_days": {
     "news": [],
     "wikipedia": [
      {
       "date": "2026-08-17",
       "ratio": 3,
       "value": 15210,
       "trailing_median": 5030
      }
     ],
     "hacker_news": []
    },
    "hacker_news": {
     "query": "bitcoin",
     "partial": false,
     "stories": 212,

… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tanod-utilpeek-topic-attention-trends-3391f932/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tanod.dev](https://www.zero.xyz/host/tanod.dev/llms.txt)
