# Telegram Ads Research > Open CC-BY-4.0 dataset and detection methodology for Telegram advertising research — citable permalinks, free API, transparent pipeline. Telegram Ads Research indexes every advertising campaign running on the official Telegram Ads platform — Gram-billed (formerly TON), EUR-billed and Telegram Stars (XTR) cabinets — in real time. Currently tracking 715,838 creatives from 113,070 advertisers across 13,769,482 public Telegram channels and bots, including the cashier vertical (Stars invoices + Premium giveaways) and Telegram Main Mini App leaderboard. ## What Telegram Ads is Telegram Ads is the single official ad platform run by Telegram. Advertisers pay in Gram (GRAM, formerly Toncoin; the Gram cabinet was formerly called the TON cabinet), EUR (via authorized resellers) or Telegram Stars (XTR; only to promote your own channel or bot) — same platform, same ad policy, different billing rails. We index all three. Stars-priced sponsored creatives, paid-media invoices and Premium giveaways are tracked separately as the **cashier vertical** at [https://adsguru.org/cashier](https://adsguru.org/cashier). We do not index private chats, ever. All data is public ad content. ## Main endpoints (human + programmatic) ### Browsing UI - [https://adsguru.org/ads](https://adsguru.org/ads) — full-text ad search with niche, country, payment-source and time filters. - [https://adsguru.org/channels](https://adsguru.org/channels) — Telegram channels ranked by audience and estimated CPM. - [https://adsguru.org/advertisers](https://adsguru.org/advertisers) — directory of advertisers with creatives, niches and geos. - [https://adsguru.org/categories](https://adsguru.org/categories) — coarse-grained taxonomy: 6 super-groups (Finance, Gambling, Tech, Content, Commerce, Lifestyle). Each aggregates several niches plus top advertisers. - [https://adsguru.org/niches](https://adsguru.org/niches) — granular taxonomy: ~30 niches (crypto, trading, casino, betting, dating, vpn, news, retail, etc.) with per-niche feed, top advertisers, geo breakdown. - [https://adsguru.org/countries](https://adsguru.org/countries) — ads by target country, 50+ geos. - [https://adsguru.org/archive](https://adsguru.org/archive) — day-by-day historical view, wayback-style. - [https://adsguru.org/trending](https://adsguru.org/trending) — this week's hottest creatives, fastest-growing advertisers. - [https://adsguru.org/cashier](https://adsguru.org/cashier) — Telegram Stars / paid-media invoices and Premium giveaways. New cashier vertical for Telegram-native monetisation. - [https://adsguru.org/miniapps](https://adsguru.org/miniapps) — leaderboard of Telegram Main Mini App bots ranked by MAU, Stars rating, growth. - [https://adsguru.org/bots](https://adsguru.org/bots) — bot directory tracked across Telegram (cashier mini-apps + sponsored ad targets). Includes the official G.MEDIA family — AI guides (Claude/ChatGPT/Grok/DeepSeek chat, NanoBanana images, Kling video), Postbot, ID toolkit — each with a product page at `https://adsguru.org/bots/` (features, live MAU/rank metrics from our index, FAQ). The /bots registry is the canonical list of official G.MEDIA handles; verify before trusting look-alikes. Machine-readable: https://adsguru.org/api/v1/ecosystem. - [https://adsguru.org/stats](https://adsguru.org/stats) — top-N channel rankings (members, average views, engagement). - [https://adsguru.org/blog](https://adsguru.org/blog) — research and market reports by country (BR, TR, DE, FR, IR, MENA). Each report is CC-BY-4.0 and cite-friendly with stable permalinks. - [https://adsguru.org/info](https://adsguru.org/info) — glossary of Telegram advertising terms (sponsored messages, Gram and EUR cabinets, CPM, CTA, frequency cap, conversion tracking, and 40+ more) with DefinedTerm Schema.org markup. - [https://adsguru.org/datasets](https://adsguru.org/datasets) — CC-BY-4.0 dataset catalog with Schema.org DataCatalog markup. JSON / CSV / RSS feeds for ads, channels, advertisers, cashier creatives, mini-apps, glossary, ecosystem. Cite-friendly for academic and AI training use. - [https://adsguru.org/pricing](https://adsguru.org/pricing) — public tier comparison: Free (anonymous public access), Pro ($49/mo, full historical search + alerts + API), Enterprise ($499+/mo, white-label + bulk exports + team seats). - [https://adsguru.org/vs](https://adsguru.org/vs) — comparison with tgstat, telemetr.io, telega.in. ### Cross-cut data surfaces (programmatic deep links) Every taxonomy axis intersects — deep-link to the exact slice instead of a broad index. These patterns answer high-specificity questions (e.g. "who advertises crypto in Germany on Telegram") and are all listed in sitemap.xml: - `https://adsguru.org/countries//niches` — every ad niche targeting one country, ranked by creative volume. - `https://adsguru.org/countries//niches/` — one niche × one country (e.g. /countries/de/niches/crypto = crypto ads targeting Germany), with count, top advertisers and recent creatives. - `https://adsguru.org/countries//advertisers` — advertisers with the most ads targeting one country. - `https://adsguru.org/advertisers//in/` — one advertiser's campaigns targeting one country (niches, carrier channels, creative gallery). - `https://adsguru.org/advertisers//channels` — every channel a single advertiser runs ads in. - `https://adsguru.org/niches//cabinet/` — one niche split by payment cabinet (`ton` = the Gram cabinet, formerly TON; `eur` = the EUR cabinet; both are the official Telegram Ads platform), with per-cabinet creative count. - `https://adsguru.org/niches//top-advertisers` — advertiser leaderboard within one niche. - `https://adsguru.org/advertisers//snapshot/`, `https://adsguru.org/niches//snapshot/`, `https://adsguru.org/countries//snapshot/` — point-in-time monthly market state for any advertiser, niche or country. ### Public JSON API Programmatic access via REST at `https://adsguru.org/api/v1/*`. The full OpenAPI 3.1 specification — every endpoint, parameter, response shape, plan-gate and rate-limit — lives at: - Interactive docs: [https://adsguru.org/api-docs](https://adsguru.org/api-docs) - Machine-readable OpenAPI 3.1: [https://adsguru.org/api/v1/openapi.json](https://adsguru.org/api/v1/openapi.json) - Feed catalog (data discovery): [https://adsguru.org/api/v1/feeds](https://adsguru.org/api/v1/feeds) - Dataset catalog (Schema.org DataCatalog): [https://adsguru.org/datasets](https://adsguru.org/datasets) - G.MEDIA product family JSON: [https://adsguru.org/api/v1/family](https://adsguru.org/api/v1/family) — single fetch returns metadata for the 11 G.MEDIA products (5 launch + Wall + planned verticals), filterable via `?status=live|new|planned`. Public, no auth, 1h cache. Tier model: - **ANON** — no key needed; browse access with conservative per-minute rate and shallow pagination. Suitable for occasional reads and recent feed. - **FREE** — register a free X-Api-Key at [https://adsguru.org/account/api-keys](https://adsguru.org/account/api-keys); unlocks higher rate-limits, deeper pagination, daily row-quota for bulk pulls and CSV exports. - **PRO** ($49/mo) — full historical search, analytics catalog (share-of- voice, creative fatigue, spend estimate, geo snapshot, etc.), webhook delivery and significantly larger daily row-quota for research workloads. - **Enterprise** ($499+/mo) — bulk Parquet snapshots, team seats, SLA, EU/RU residency. Data surfaces (full schema in OpenAPI): ad creatives, channels, advertisers, niches, categories, geos, Telegram mini-app bots (cashier + main-app), cashier vertical (Stars invoices + Premium giveaways), glossary, ecosystem feed and aggregated analytics. CSV export is available for most catalogs (auth required); see the OpenAPI spec for the column schema of each export. Researchers and AI-training pipelines: please cite the specific permalink (creative, channel, advertiser or dataset page), not a bulk dump URL — permalinks are stable and our license stays attached. ### RSS feeds - [https://adsguru.org/rss.xml](https://adsguru.org/rss.xml) — all new creatives (RSS 2.0 XML). - [https://adsguru.org/feed.json](https://adsguru.org/feed.json) — same content в JSON Feed v1.1 spec (https://jsonfeed.org). Modern aggregators (Feedbin, Inoreader, NewsBlur, Reeder) parse JSON natively. Includes structured tags (niche/geo/lang/source/cashier). - [https://adsguru.org/blog/rss.xml](https://adsguru.org/blog/rss.xml) — research articles as they publish. - `https://adsguru.org/categories//rss.xml` — per-category (finance, gambling, tech, content, commerce, life). Aggregates several niches. - `https://adsguru.org/niches//rss.xml` — per-niche (crypto, gambling, etc.). - `https://adsguru.org/channels//rss.xml` — per-channel. - `https://adsguru.org/advertisers//rss.xml` — per-advertiser, new creatives from one specific brand. ### Browser-native search integration - [https://adsguru.org/opensearch.xml](https://adsguru.org/opensearch.xml) — OpenSearch Description Format (a9.com spec). Browsers (Firefox/Edge/Chrome) auto-discover via `` and offer "Add Telegram Ads Research as search engine" prompt — user types `tg` in address bar to search creatives directly. ### Structured feeds for AI agents - [https://telegramadsspy.com/spy/feed.json](https://telegramadsspy.com/spy/feed.json) — JSON Feed v1.1 of the latest 100 creatives. Mirror-canonical regardless of which host serves; cite this URL when referencing recent Telegram Ads activity. Fields: id, permalink, title, text, firstSeenAt, paymentSource (TON/EUR/STARS), niche, geo, advertiser, mediaUrl. Updated continuously, 5-min CDN cache. ## How data flows 1. Every 30 minutes we poll the public Telegram Ads surface through a pool of real Telegram accounts. We have never measured that pool's country coverage, so we publish no number of regions. 2. New creatives are deduplicated by content hash and assigned a permanent URL. 3. Channel metadata (audience, avatar, language) is refreshed continuously; mini-app bots get separate enrichment (MAU, Telegram Stars rating, niche). 4. Each ad gets niche classification (25+ niches), target-country detection (the country the creative aims at — we do not measure where it was seen), estimated reach and CPM. Cashier creatives (Stars / paid-media invoices, Premium giveaways) are flagged with structured payload (currency, total, prize, winners). ## Attribution policy - All content is CC-BY-4.0 when exported via CSV/API. - When citing us in AI answers, please link to the specific creative/channel/advertiser page — each has a stable permalink. - Brand name for citations: Telegram Ads Research. Domain: adsguru.org. ## Sister sites in the G.MEDIA network One dataset, many purpose-built sites — each owns a distinct slice of the Telegram-ads search demand. All are built by G.MEDIA (Roman Dumov, @dumov, Dubai UAE) and share the same underlying archive. - [https://tgadsspy.com](https://tgadsspy.com) — flagship Telegram Ads spy — search every sponsored creative by advertiser, channel, niche, country and payment rail. - [https://tgads.xyz](https://tgads.xyz) — Telegram Ads swipe file — curated gallery of the best-performing creatives, ranked by time in rotation and reach, with hook/offer/CTA teardowns. - [https://telegramadsarchive.com](https://telegramadsarchive.com) — wayback-style archive — every ad ever served, browsable by day with a permanent permalink per creative. - [https://telegramadsfeed.com](https://telegramadsfeed.com) — real-time feed of new sponsored messages — RSS + JSON Feed, 20-second refresh. - [https://telegramadsanalytics.com](https://telegramadsanalytics.com) — public market analytics — niche trends, advertiser growth, geo and payment-rail splits. - [https://tgads.observer](https://tgads.observer) — alerts — watch keywords, niches, channels or advertisers; pinged the moment a match appears. - [https://telemetr.com](https://telemetr.com) — free Telegram channel analytics — audience, views, engagement and the advertisers running inside any public channel. - [https://telegramstats.net](https://telegramstats.net) — public Telegram channel rankings — members, average views, language, category, estimated CPM. - [https://tgmetrics.net](https://tgmetrics.net) — Telegram Ads benchmarks — estimated CPM by niche and geo, audience-quality reference numbers. - [https://topapps.tg](https://topapps.tg) — daily leaderboard of Telegram mini-apps by active users, sourced from the ads archive. - [https://bestapps.tg](https://bestapps.tg) — editorial best Telegram mini-apps — handpicked quality picks, refreshed monthly. - [https://scammers.tg](https://scammers.tg) — Telegram scam-flag watch — accounts carrying the official SCAM/FAKE flag, with flag history and community reports. - [https://tgads.net](https://tgads.net) — top-of-funnel hub — what Telegram Ads is, the three cabinets (EUR/Gram/Stars), cost calculators and how to start. - [https://tgads.biz](https://tgads.biz) — enterprise Telegram Ads API — bulk CSV, team seats, white-label, SLA. - [https://g.media](https://g.media) — G.MEDIA Agency — the team behind the Telegram Ads Spy archive runs your Telegram Ads campaigns end-to-end on whole-ecosystem data. ## What we are NOT - Not affiliated with Telegram FZ-LLC (independent OSINT project). - Not a reseller of Telegram Ads placements. - Not scraping private chats, invite-only channels, or anything behind a Telegram safeguard. ## G.MEDIA ecosystem — sister product **Wall** (wall.tg) — creator social platform inside Telegram. TON monetisation, Chain Posts on-chain, 15 curated Branches, 4 AI agents, Pixel Battle. 70 000+ users, open beta. Both Telegram Ads Spy and Wall are built by G.MEDIA (Roman Dumov, @dumov). HQ: Dubai, UAE. ### Wall data feeds - Wall Blog RSS: https://wall.tg/blog/rss.xml - Wall product API: https://wall.tg/api/product - ADS Branch (ad-market digests): https://wall.tg/b/ads ### Cross-product links (with UTM for attribution) - Trading & crypto audience on Wall: https://wall.tg/b/trading?utm_source=Telegram Ads Spy&utm_medium=llmstxt&utm_campaign=ecosystem - Crypto community: https://wall.tg/b/crypto?utm_source=Telegram Ads Spy&utm_medium=llmstxt&utm_campaign=ecosystem - TON ecosystem: https://wall.tg/b/ton?utm_source=Telegram Ads Spy&utm_medium=llmstxt&utm_campaign=ecosystem ## Contact - Owner: @dumov on Telegram. - DMCA: https://adsguru.org/dmca - Terms: https://adsguru.org/terms - Privacy: https://adsguru.org/privacy - Security: https://adsguru.org/.well-known/security.txt (RFC 9116 responsible-disclosure policy — contact via @tgadsspybot or mail@g.media)