100 free credits. No credit card required

Telegram Search API

Scrape Telegram Search data with one API call. Finds public Telegram channels by keyword, so you can pick the channels to read with `/v1/telegram/profile` and `/v1/telegram/profile/posts`. Channels are discovered through a public web search index limited to t.me pages, so this finds what that index has already seen: it is not real time, a channel or message from the last few days may not appear yet, and private channels and invite-only groups never appear. Returns one row per channel, in the order the search found them, on the same Author shape `/v1/telegram/profile` returns: `author.username` is the public handle (pass it as `handle`), `author.url` is `https://t.me/<handle>`, and `author.display_name` is the channel's title when the search result carried it (null when the result showed only the handle). `author.ext.search_hit` says how the channel was found: `match` is `channel_page` (the channel's own page) or `post_in_channel` (a message or the message preview), `title` and `snippet` are the hit as the index showed it, `evidence_url` is the first page that matched, and `matched_urls` lists every t.me page the search matched for that channel, so you can open the exact messages. The snippet is the index's text, not the channel's description, so `author.bio` stays null on a plain call, as do `author.followers`, `author.avatar_url` and `author.verified`. Send `include=details` and every channel is joined, in the same call, to the profile lookup: the exact subscriber count (`author.followers`), the description (`author.bio`), the avatar, the verified flag and, where it was null, the title land on each row. Words in `query` match loosely; put a phrase in double quotes to require it, and add `-word` to exclude a word. Cost: 2 credits for the page, plus 1 credit per channel filled from a fresh lookup with `include=details` (at most 10 a page, so 12 credits at most); channels already in cache are free, channels that could not be filled are refunded, and a search that finds no public channel is a 404 at 0 credits. Time: a plain page takes about 2 to 12 seconds; `include=details` adds a few seconds on a fresh page (the lookups run in parallel and the call waits for the slowest, never more than 10 seconds) and nothing when the channels are already cached. The response carries a `hydration` block itemising rows, lookups, cache hits, credits and milliseconds. A page holds up to 10 channels, fewer when several hits belong to one channel. Forward `pagination.next_cursor` as `cursor` for the next page; the same channel can appear again on a later page.

Last updated October 2026 · Maintained by the SocialCrawl team