Telegram Ads offers powerful advertising capabilities, but its platform doesn't provide a traditional public REST API. ADSLY bridges that gap — connecting securely to your Telegram Ads cabinets via session-based authentication and enabling automation, data export, and bulk management that the native interface simply can't deliver.
How the Telegram Ads API Works
Telegram's advertising platform lives at ads.telegram.org. Unlike platforms such as Google Ads or Meta, Telegram does not expose a documented public REST API for third-party developers. Instead, the platform operates through an authenticated web session tied to your Telegram account.
ADSLY connects to Telegram Ads securely using your session credentials. Once you link your advertising cabinet — whether it's a TON, Euro, or Stars account — ADSLY can read campaign data, execute changes, and sync statistics automatically. No password sharing is required. The connection is session-based, and each team member gets isolated cabinet access.
What ADSLY Automates via the Telegram Ads API
Once connected, ADSLY acts as a full automation layer on top of Telegram Ads. Here's what you can do programmatically instead of manually clicking through the web interface:
Campaign creation and management — Create, duplicate, and manage campaigns across multiple cabinets from a single dashboard. No need to log into each cabinet separately.
CPM and budget adjustments — Change bids and daily budgets across dozens of campaigns at once. Bulk edit 100+ campaigns in one click instead of adjusting each one individually.
Campaign pause, resume, and delete — Control campaign status in bulk. Pause all campaigns in a cabinet, resume specific groups, or clean up declined ads — all from one screen.
Statistics retrieval — Pull impressions, clicks, spend, CTR, CPM, and join data. ADSLY collects hourly performance data, giving you granularity that the native Telegram Ads interface doesn't provide.
Ad text and targeting changes — Update ad copy and targeting parameters without recreating campaigns. Test variations quickly across multiple ads.
Account balance monitoring — Track balances across all your cabinets in real time. Know exactly how much budget remains in each account without switching between tabs.
Data Export & Reporting
Telegram Ads provides limited native reporting. ADSLY significantly extends what you can extract and analyze:
CSV export of campaign data — Export full campaign lists with all metrics. Import into Google Sheets, Excel, or any BI tool for custom analysis.
Hourly performance data — ADSLY collects metrics every hour, so you can see exactly when your campaigns perform best. Identify peak hours and optimize your schedule accordingly.
Cross-cabinet aggregated reports — If you manage multiple Telegram Ads cabinets (common for agencies), ADSLY aggregates data across all of them into unified reports. No more combining spreadsheets manually.
Historical data retention — Campaign performance history is retained in ADSLY, so you can look back at trends over weeks and months — even after campaigns are deleted from Telegram Ads.
Automation Hooks
This is where ADSLY goes beyond simple data access. Automation hooks let you set rules that act on your campaigns without manual intervention:
IF/THEN rules engine — Define conditions and actions. IF CPM exceeds $2.50, THEN reduce the bid by 15%. IF CTR drops below 0.3% over 6 hours, THEN pause the campaign. Rules run automatically every hour across all your campaigns.
Scheduled operations — Set time-based campaign control. Pause campaigns at night, resume them in the morning. Increase budgets on weekdays, decrease on weekends. All runs on schedule without you touching anything.
IF/THEN Automation — For hands-off optimization, automation rules analyze your campaign performance and make CPM adjustments, budget reallocations, and pause/resume decisions automatically. Rules adapt based on your campaign data and optimize toward your goals.
Ad Text Optimization — When Telegram declines your ad, ADSLY can automatically generate text variations and resubmit. This keeps your campaigns running without manual intervention every time moderation flags an ad.
Integration Use Cases for Agencies
Agencies managing Telegram Ads for multiple clients face unique challenges. Here's how ADSLY's integration capabilities help:
Client reporting — Export campaign results as CSV for client-facing reports. Cross-cabinet aggregation means you can generate per-client reports even when campaigns span multiple cabinets.
Alerts and notifications — Set up automation rules to catch problems early. IF spend exceeds the daily limit, the rule triggers a pause — preventing budget overruns before they happen. Combine with Telegram bot notifications for real-time awareness.
Custom dashboards — Pull exported data into your own analytics tools or client dashboards. ADSLY's CSV exports and historical data make it straightforward to build custom reporting layers.
Budget allocation — Use automation rules to redistribute budget based on performance. Winner campaigns automatically get more budget while underperformers get paused — ensuring client spend goes to what works.
ADSLY REST API (Coming Soon)
We're building a REST API for full programmatic access to ADSLY. This will allow developers to integrate Telegram Ads management directly into their own tools and workflows.
Planned endpoints include:
- Campaigns CRUD — create, read, update, and delete campaigns programmatically
- Analytics retrieval — pull performance data via API calls
- Account management — manage cabinets and team access
- Webhook subscriptions — receive real-time notifications when campaign metrics change
The REST API is currently in development. Sign up through the ADSLY dashboard to get notified when early access becomes available.
Security & Access
Security is fundamental when connecting to advertising accounts that manage real budgets:
Session-based authentication — ADSLY connects using your Telegram Ads session. No passwords are stored or shared.
Team-level access control — Each team member has their own login with isolated cabinet access. Admins can control who sees and edits what.
Cabinet isolation — Cabinets are isolated per team member. One user's data is completely separate from another's, even within the same organization.
No password sharing required — Team members connect their own Telegram accounts. There's no need to share a single login across your team.
Frequently Asked Questions
Is there a public Telegram Ads API?
Telegram does not offer a traditional public REST API for its advertising platform. The Telegram Ads interface at ads.telegram.org operates through authenticated web sessions. ADSLY connects to Telegram Ads securely using your session credentials, providing automation, data export, and management capabilities on top of the existing platform.
How does ADSLY connect to my Telegram Ads account?
ADSLY connects using your Telegram Ads session credentials. You link your advertising cabinet (TON, Euro, or Stars) through the ADSLY dashboard. The connection is session-based — no password sharing is required. Each team member can have their own isolated cabinet access with team-level permissions.
Is my Telegram Ads data secure with ADSLY?
Yes. ADSLY uses session-based authentication with no password storage. Cabinets are isolated per team member, so one user cannot access another's data. Team-level access control ensures only authorized members can view or modify campaigns. All data is encrypted in transit.
Can I export Telegram Ads data to Google Sheets?
ADSLY supports CSV export of campaign data, including hourly performance metrics and cross-cabinet aggregated reports. You can import these CSV files directly into Google Sheets, Excel, or any analytics tool. Automated scheduled exports and direct Google Sheets integration are planned for a future update.
Does ADSLY support webhooks for Telegram Ads?
Webhook subscriptions are planned as part of the upcoming ADSLY REST API. Currently, you can set up IF/THEN automation rules that trigger actions based on campaign metrics — such as pausing campaigns, adjusting CPM, or changing budgets — which cover most real-time monitoring needs without traditional webhooks.
When will the ADSLY REST API be available?
The ADSLY REST API for programmatic access is currently in development. Planned endpoints include campaigns CRUD, analytics retrieval, account management, and webhook subscriptions. Sign up through the ADSLY dashboard to be notified when the API enters beta.