Telegram Analytics API Plans and Limits
Credits API keys and Subscription API keys use different access and billing models. Check key_type in /v1/usage/info before applying a table to your integration.
Credits API access
Credit spending and the following monthly usage ceilings apply separately:
| API access | Requests per period | Unique channels per period | History depth | Catalog | Post search |
|---|---|---|---|---|---|
| Free | 1,000 | 10 | 7 days | No | No |
| Pro | 10,000 | 100 | 30 days | No | No |
| Advanced | 100,000 | 1,000 | 365 days | Yes | Yes |
| Team | 1,000,000 | 10,000 | Up to 10 years | Yes | Yes |
Free access is restricted to verified channels. The table's history depth applies to chart, publication and mention access; the relevant endpoint determines the returned data. Search history is subject to the API plan as well.
A credit top-up does not increase these ceilings or grant additional feature access. The applicable API entitlement can be provided by your service subscription; use the actual API usage response for your account's current limits and billing dates.
Credit charges
Ordinary requests, first access to a channel, catalog searches, post searches and first use of a search term have separate charge rules. Catalog and post-search prices are inclusive of the base request fee. See credit units and charging.
Read the actual settled amount from x-credits-cost and the available balance from x-credits-remaining, both in milli-credits. Dictionaries and usage information are free of request quota and credit charges.
Snapshot allowances
| API access | Channels in a matching set | Active snapshots | Active diffs | Retention |
|---|---|---|---|---|
| Free / Pro | No access | 0 | 0 | — |
| Advanced | 50,000 | 5 | 200 | 30 days |
| Team | 100,000 | 10 | 400 | 30 days |
These are resource limits, separate from prices and the unique-channel allowance above. See snapshot availability and workflow before integrating.
Subscription API packages
| Free | S | M | L | XL |
|---|---|---|---|---|
| $0 | $25 | $65 | $199 | $499 |
| 5 verified channels | 50 channels | 500 channels | 2,500 channels | 10,000 channels |
| 1000 requests per month | 1000 requests per month | 100,000 requests per month | 500,000 requests per month | 2 million requests per month |
| for 7 days of mentioning the channel | for 30 days of mentioning the channel | for 60 days of mentioning the channel | for 90 days of mentioning the channel | all channel mentions |
| in 7 days, a list of channel publications | a list of channel publications for 60 days | a list of channel publications for 180 days | a list of channel publications for 365 days | a complete list of channel publications |
| dynamics of indicators in 7 days | dynamics of indicators in 14 days | dynamics of indicators over 90 days | dynamics of indicators for 180 days | ♾️ dynamics of indicators |
Subscription API Search packages
Pricing for searching posts by keywords in Telegram channels (/v1/search/messages). Billed monthly.
| S | M | L | XL | XXL | XXXL | |
|---|---|---|---|---|---|---|
| Price | $15 | $35 | $100 | $190 | $310 | Contact our sales team |
| Price per word | $3.00 | $0.70 | $0.67 | $0.63 | $0.62 | — |
| Price per request | $0.015 | $0.00233 | $0.001 | $0.00063 | $0.00062 | — |
| Unique words per month | 5 | 50 | 150 | 300 | 500 | Any amount |
| Requests per month | 1,000 | 15,000 | 100,000 | 300,000 | 500,000 | Unlimited access |
| Period, days | 7 | 14 | 30 | 60 | 90 | Unlimited access |
Sales: via Telegram @telemetrio_contact or write to telemetrio.support@gmail.com.
Subscription API keys have individually configured limits. Catalog access is enabled separately; snapshots additionally require their own permission and size/count allowances. Changing an API Search package does not automatically grant catalog or snapshot access. Confirm the applicable package and individual settings with sales.