Telegram Channel Search
Telegram Channel Search looks through every post a public channel has published for a word or phrase, returning the matching posts with their text, publish date, views and reactions. Finding those mentions, however far back they sit, shows whether an influential channel ever covered a project, how often it returns to a topic and how much attention each mention drew.
Telegram Channel Search API Features
- Searches the whole historyquery runs over every post the channel has published, so a mention from years ago is found as readily as one from today.
- Up to 100 matching postsresults_limit sets how many matches to return, from 1 to 100 with a default of 20.
- Views and reactions per matchEach matching post carries metrics.views_count and metrics.likes_count, showing how much attention the mention received.
- Pay only for matchesEach matching post costs 0.5 credits, and a search that finds nothing costs nothing.
Telegram Channel Search API Parameters
| Parameters | Required | Description |
|---|---|---|
url | Required | One public Telegram channel link to search, such as https://t.me/durov; t.me/s/, telegram.me and telegram.dog links work too. |
query | Required | Word or phrase to look for in the channel's posts, such as TON. |
results_limit | Optional | Number of matching posts to return. Integer from 1 to 100, default 20. |
How to Use the Telegram Channel Search API
Send a channel link and a search term to the Telegram Channel Search API, then read the matching posts.
- POST {"url": "https://t.me/durov", "query": "TON", "results_limit": 20} to /v1/telegram/channel-search.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- Read the matching posts from results.items, and while has_more is true pass results.next_cursor to load the next page.
curl -X POST "https://api.socq.ai/v1/telegram/channel-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://t.me/durov","query":"TON","results_limit":20}'Telegram Channel Search API Use Cases
- Checking a channel's coverage of a project: Search an influencer or news channel for your token, product or brand name before proposing a partnership.
- Collecting a launch's coverage: Pull every post a channel published about a product launch or event into one list for a recap.
- Due diligence before advertising: Search a channel for past promotions of a competitor or a topic to understand its history before buying a placement.
- Topic research across channels: Run the same query against several channels through the Telegram Channel Search API and compare how often each mentions it and how many views those posts earned.
Telegram Channel Search API Pro Tips
- Run separate queries for a ticker and the full project name to cover both ways a channel may write it.
- Photos in search results link to the post that shows them; send that post url to Telegram Post Detail API when you need the image files.
- Each search covers one channel; to discover more channels around a topic, start from a known one with Telegram Similar Channels API.
Related APIs
Beyond the Telegram Channel Search API, use these APIs when you need a different type of public Telegram data.
- Telegram Channel Info API — Look up up to 50 public Telegram channels by link for title, description, avatar, verification badge and subscriber count as a whole number.
- Telegram Channel Scraper API — Collect up to 1,000 posts from a public Telegram channel, newest first, with text, publish time, views, reaction totals, photos and videos.
- Telegram Post Detail API — Fetch up to 50 specific Telegram posts by link, from any mix of public channels, with full text, publish time, views, reactions and media.
- Telegram Comments API — Collect up to 100 comments under a Telegram channel post from its discussion group, with author name, text, time, reactions and reply target.
- Telegram Similar Channels API — Find the channels Telegram recommends next to a public channel, usually around ten, each with title, verification badge and exact subscriber count.