adsguru.org · Open Datasets
Public datasets, detection methodology, and citable exports from the largest open archive of Telegram advertising. CC-BY-4.0. No paywall.
Monthly snapshots of every ad creative indexed. Download once, cite freely.
Every non-hidden ad with text, niche, geo, advertiser, payment source, first/last seen.
Download →Same archive in JSON, with media hashes, accent colour, CTA, target channel.
Download →Latest 50 creatives in jsonfeed.org spec — direct input for AI agents and aggregators.
Download →Aggregate creative count per niche — 27 verticals, with trend hints. Researcher-friendly CSV mirror at /api/v1/niches.csv.
Download →Telegram Stars (XTR) invoices, paid-media offerings, Premium giveaways. 27-column CSV.
Download →74+ Telegram-ads glossary terms with EN/RU definitions and cross-link graph.
Download →Crypto, trading, prop-firm and cashier verticals dominate. Each row links to the full per-niche feed (RSS + JSON-LD).
Telegram Ads is delivered through 30+ regional pools. Each country page lists local advertisers, niche mix and recent creatives.
Methodology
We publish how the data is collected because researchers don't cite black-box archives. Below is the four-step pipeline, end to end. Every step is reproducible from the same public Telegram surface anyone with an account in the relevant country can observe.
Our backend polls Telegram's sponsored-messages API every 30 minutes from accounts pinned to 30+ regional pools. We see ads targeted at users in Russia, the United States, Brazil, Iran, Turkey, Germany, the EU, India, MENA and the rest of the world — including ads that would never appear from a single IP.
Each creative receives a content hash so identical reposts collapse into a single record with multiple impressions. Banner photos and videos are mirrored to a permanent content-addressed URL within minutes. Original Telegram media expires after one hour; the mirrored copy survives for the lifetime of the archive.
A regex classifier (open source, see /info glossary) maps each ad to one of 25+ verticals. We tag the country where the ad was delivered and detect whether the advertiser paid in TON (crypto cabinet), EUR (Telegram Ads Cabinet) or Stars (XTR / cashier vertical). Every classification decision is reversible and auditable.
Every creative is given a stable /ads/<id> URL that does not change for the lifetime of the archive. Aggregate datasets are exported nightly as CSV, JSON and JSON Feed v1.1. All exports carry a CC-BY-4.0 license block — cite freely with attribution to adsguru.org.
Open research only works when the boundaries are clear. We are not a private-content scraper, not a black-box rebroadcaster of Telegram, and not a brand-monitoring tool that exfiltrates restricted data. The list below describes what is explicitly out of scope.
The same dataset, surfaced through six different lenses. Each use case below uses the same underlying CSV/JSON exports — only the angle of analysis differs.
Academic citation
Every dataset has a stable DOI-style URL, author, and CC-BY-4.0 license block — cite it in a paper or report.
Open-source investigations
Trace an advertiser across channels, countries, and time. Full permalink history, no data removed.
Market research
Cross-country niche comparison, spend estimates, channel ranking. Machine-readable API at /api/v1/ads.
Regulatory monitoring
Watch ad-policy compliance per market — gambling/financial/health verticals across regulated geos. Time-stamped permalinks for evidence trails.
Newsroom investigations
Follow money: which advertisers spend in which countries, in which languages, around political moments or product launches. Citable for journalism.
Builders and tooling
Free public REST API and JSON Feed v1.1. Build dashboards, alerts and analyses on top — same data the production app uses.
Suggested citation block for academic papers, regulatory filings or news pieces. CC-BY-4.0 means citation is required; commercial use is allowed.
adsguru.org. (2026). Telegram Ads Creative Archive [Dataset]. Retrieved from https://adsguru.org/datasets. Licensed under CC-BY-4.0.
For dataset-specific DOIs (per-month frozen snapshot), open the corresponding entry on /datasets and use its permalink. The aggregate live archive uses the URL above.
Frequently asked questions
CC-BY-4.0 — see creativecommons.org/licenses/by/4.0. Commercial use is allowed; only attribution is required ("Source: adsguru.org Telegram Ads Open Archive"). No data is paywalled.
Open /datasets and pick the dataset you want. Each entry has a stable URL; we publish nightly point-in-time aggregates and a monthly frozen tag. Your citation should pin the URL to a specific date for reproducibility.
Live. New creatives normally appear within 30–60 minutes of going live on Telegram. We poll every 30 minutes from each region, so even ads targeted at small geos are caught quickly. The /feed.json endpoint refreshes every 5 minutes.
No. We only index public sponsored messages that anyone with a Telegram account in the relevant region could already see. Nothing private, nothing behind a Telegram safeguard. See the "What we do NOT collect" section above.
Yes. The public REST API at /api-docs exposes JSON and CSV endpoints for ads, channels, advertisers, niches, trends, cashier creatives, mini-app bots and glossary. Anonymous calls are rate-limited; create a free API key on your account page for higher volume.
Every creative has a permanent URL `/ads/<id>` that never changes. Cite that URL with the date you accessed it, e.g. *adsguru.org. (2026, May 10). Ad creative #abc123. Retrieved from https://adsguru.org/ads/abc123*.
Telegram exposes a `can_report` flag plus invoice metadata on each sponsored message. We classify the payment source as TON (crypto), EUR (Telegram Ads Cabinet) or Stars (XTR / cashier vertical). The classification logic is open source and the result is exposed as a `paymentSource` field in every export.
Send a DMCA / 152-FZ takedown request via /dmca. Valid requests result in the creative being hidden from public feed, sitemap and exports — it stays in the DB only for completeness and audit trail.
One dataset — many tools
Each domain is built around a specific job: finding a single creative, tracking launches live, building a market deck, or piping data into your BI. Same database, tailored UI per role.
Flagship search across the whole Telegram Ads database — filters by niche, country, advertiser, payment rail.
Best for: deep competitive research; scouting working offers and funnels for your own campaigns.
tgadsspy.comEvery ad ever served on Telegram Ads, browsable by day, with a permanent URL per creative.
Best for: finding an ad you saw yesterday; checking what competitors ran a week or a month ago.
telegramadsarchive.comPaste any public channel name — see every advertiser targeting it, with full creative history.
Best for: fast recon on a competitor channel; checking a single advertiser in 10 seconds.
spyservice.orgTelegram accounts carrying the official SCAM or FAKE flag, plus community reports — flag history applied and cleared by Telegram.
Best for: checking whether a channel or bot is flagged before you trust it; tracking who got flagged and when.
scammers.tgPublic market reports: niche trends, advertiser growth, splits by country and payment rail.
Best for: spotting where demand is growing; building a Telegram Ads market deck for your team or investor.
telegramadsanalytics.comAudience, growth, estimated CPM and ranking for every public Telegram channel we track.
Best for: sizing up a channel before buying ads; benchmarking reach and engagement against peers.
telegramstats.net