# Telemost Telegram Reach Analytics

> Telemost Telegram Reach Analytics is a paid API for AI agents from api.telemost.io, paid per call via x402, $0.0165/call, status unknown (last checked 2026-09-14).

Returns a time-series chart of average post reach for a given Telegram channel, showing how many people typical posts reach over time.

## Facts

- Endpoint: GET https://api.telemost.io/v1/stats/reach
- Price: $0.0165/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/telemost-telegram-reach-analytics-c258a078
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_97I-0khKoQx6mT7ulCvFD

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 telemost-telegram-reach-analytics-c258a078
```

Example prompt: Can you pull the average post reach chart for the Telegram channel @durov, broken down by week, so I can see how many people their typical posts are reaching over time?

## When to prefer this

Use this endpoint when you specifically need average post reach data (how many unique people see a typical post) for a Telegram channel over time, as opposed to raw subscriber counts or engagement rates. Prefer this over general channel stats endpoints when the key metric of interest is audience reach rather than subscriber growth or engagement ratios.

## Known failure modes

- Channel not found or invalid username — returns error indicating channel does not exist or is inaccessible
- Channel is private or has insufficient data — may return empty dataset or error
- Missing required 'channel' query parameter — returns 400 validation error
- Invalid aggregation value outside the allowed enum — returns 400 validation error
- Payment not provided or insufficient — returns 402 Payment Required
- Rate limiting or quota exceeded — returns 429 Too Many Requests

## How this service works

Telegram reach analytics: average post reach chart for a channel, how many people typical posts reach over time.

## Output

A time-series chart of average post reach values for the specified Telegram channel, with data points spaced according to the requested aggregation granularity (day, week, month, or year). Each point represents how many unique viewers a typical post on that channel reaches during that period.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "channel"
     ],
     "properties": {
      "channel": {
       "type": "string"
      },
      "aggregation": {
       "enum": [
        "day",
        "week",
        "month",
        "year"
       ],
       "type": "string",
       "default": "day",
       "description": "Chart granularity: day/week/month/year. Controls point spacing, not a time window."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "data": {
   "channel": "@durov",
   "avg_reach": null
  },
  "meta": {
   "cached": false,
   "resource": "/v1/stats/reach",
   "generated_at": "2026-07-07T12:00:00.000Z"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/telemost-telegram-reach-analytics-c258a078/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.telemost.io](https://www.zero.xyz/host/api.telemost.io/llms.txt)