{"uid":"cap_97I-0khKoQx6mT7ulCvFD","slug":"telemost-telegram-reach-analytics-c258a078","name":"Telemost Telegram Reach Analytics","description":"Telegram reach analytics: average post reach chart for a channel, how many people typical posts reach over time.","url":"https://api.telemost.io/v1/stats/reach","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0165","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0165/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0165","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0165","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9Jjm2fGEWKIeR1uG3ewWF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0165","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a time-series chart of average post reach for a given Telegram channel, showing how many people typical posts reach over time.","exampleAgentPrompt":"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?","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:39:15.026Z","isFirstParty":false}