Telegram Search Scraper

Search public Telegram by keyword and get what matches as rows you can sort: channels, groups, bots and individual posts, each with its t.me link, its name and its text. Optionally look every channel up on Telegram itself for the exact subscriber count. No Telegram account, no API key, no phone number.

{ "searchQueries": ["home coffee roasting"], "resultType": "channels", "maxResults": 100 }

Unofficial. This Actor is not affiliated with, endorsed by or sponsored by Telegram. It reads only publicly available pages, does not log in and does not bypass any access control. All product names and trademarks belong to their respective owners.

What one row looks like

A real row from a real run, unedited:

{
  "query": "home coffee roasting",
  "rank": 3,
  "kind": "channel",
  "title": "Coffee Roasters Club",
  "url": "https://t.me/coffeeroastersclub",
  "username": "coffeeroastersclub",
  "messageId": null,
  "snippet": "Home roasting tips, bean sources and profiles for small batch roasters",
  "matchedAllWords": true,
  "language": null,
  "totalResultsForQuery": 412,
  "channelSubscribers": 18432,
  "channelIsVerified": false,
  "enriched": true,
  "scrapedAt": "2026-09-30T16:12:04+00:00"
}

column	what it is
kind	channel, group, bot, post or article
url · username	the Telegram link and the @name behind it
messageId	for a post, the number in its own link
snippet	the description, or the matching text of a post
matchedAllWords	whether every word of your phrase is really in it
totalResultsForQuery	how many matches the search has in total
channelSubscribers	exact, read from Telegram — only with channel details on

The one thing worth knowing before you run it

The search matches your words, not your phrase. Ask for woodworking tools and you will also be offered places that carry only tools. That is how public Telegram search works, and nothing in its answer says so.

So every row here carries matchedAllWords — whether all of your words really appear in the name or the description — and the run tells you how many of your results were full matches. Sort on that column and you have the precise answers on top and the neighbourhood underneath, without anything thrown away.

If you would rather only pay for exact ones, turn on Only keep results containing every word: the rest are dropped before they are charged for. It is off by default because the search prints a description for about two results in three, and for the remaining third there is only a name to read — a multi-word phrase would drop them all whether or not they were any good.

What you can search

• Channels and groups — places to follow, with names and descriptions.
• Bots — by what they advertise themselves as.
• Messages — individual posts, each with its own link and the text that matched. Useful for watching a topic or a brand name.
• Telegraph articles — pages published through Telegram's publishing tool. They live on telegra.ph, not inside Telegram.

Add a two-letter language code to narrow any of these to one language.

Channel details

With Look each channel up on Telegram turned on, every channel found is also read from Telegram's own public page: exact subscriber count, the full description, the verified badge, the avatar.

Two honest notes about it. It costs a second request per result and is charged at the higher rate — leave it off if you only want links. And some names Telegram will not show a preview for at all: a group, a channel whose owner switched the preview off, or a name that no longer exists all look identical from outside. Those rows still come back, marked in enrichmentNote, and are charged at the plain rate rather than the enriched one.

How big is a search, really

Measured on 2026-09-30:

phrase	matches
bitcoin	199 458
bitcoin, channels only	3 859
woodworking, channels only	38

Broad topics are effectively bottomless; a narrow one can be a few dozen and then genuinely finished. Every row carries totalResultsForQuery so you can see which you are in, and a run that finds nothing says so plainly instead of failing.

Limits

• Up to 50 phrases and 5 000 results in one run.
• Channel lookups are capped at 500 per run.
• Results come from a public index of Telegram plus Telegram's own public pages. Private channels, invite-only groups and anything requiring an account are not visible and never will be.

Free plan

The free trial covers 100 results. Everything works the same on the free plan; only the row count differs, and a run stops cleanly when its charge limit is reached rather than failing.