# Telemost Telegram Subscriber Growth Chart

> Telemost Telegram Subscriber Growth Chart 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 subscriber counts for a Telegram channel, showing audience growth or decline at day/week/month/year granularity.

## Facts

- Endpoint: GET https://api.telemost.io/v1/stats/subscribers
- 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-subscriber-growth-chart-7395b69c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_K1TdgT9oUefjzeDHECGt1

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-subscriber-growth-chart-7395b69c
```

Example prompt: Show me the daily subscriber growth chart for the Telegram channel @durov over the past period — I want to see if their audience has been growing or declining.

## When to prefer this

Use this endpoint when you need a historical time-series of subscriber counts for a specific Telegram channel. Prefer it over the general channel stats endpoint when you specifically want the subscriber growth chart with configurable time granularity. Choose this when building dashboards, comparing channel growth trajectories, or detecting inflection points in audience size.

## Known failure modes

- Channel not found or invalid channel handle — 404 or empty result
- Payment not included or insufficient — 402 Payment Required
- Invalid aggregation enum value — 400 Bad Request
- Channel is private or inaccessible — access denied or empty data
- Rate limit exceeded — 429 Too Many Requests

## How this service works

Telegram audience analytics: subscriber growth chart for a channel, track audience growth or decline over time (day/week/month/year).

## Output

A time-series array of data points showing subscriber counts at the requested granularity (day/week/month/year) for the specified Telegram channel, enabling trend analysis of audience growth or decline over time.

## 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": {
      "region": {
       "enum": [
        "cis",
        "worldwide"
       ],
       "type": "string",
       "description": "Optional routing region hint (cis|worldwide). Does not affect payment (not an x402 field)."
      },
      "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": {
   "series": [],
   "channel": "@durov"
  },
  "meta": {
   "cached": false,
   "resource": "/v1/stats/subscribers",
   "generated_at": "2026-07-07T12:00:00.000Z"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/telemost-telegram-subscriber-growth-chart-7395b69c/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)