telegram/
channel-search

The Telegram Channel Search API searches a public Telegram channel's whole post history for a word or phrase and returns up to 100 matching posts with text, publish date, views and reactions.

Telegram Channel Search API

Full channel history
Up to 100 matches
Views and reactions
No charge without matches
0.5 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

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

ParametersRequiredDescription
urlRequiredOne public Telegram channel link to search, such as https://t.me/durov; t.me/s/, telegram.me and telegram.dog links work too.
queryRequiredWord or phrase to look for in the channel's posts, such as TON.
results_limitOptionalNumber 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.

  1. POST {"url": "https://t.me/durov", "query": "TON", "results_limit": 20} to /v1/telegram/channel-search.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. 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.

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.

Explore other platforms

Combine Telegram data with public data from other supported social platforms.

Telegram Channel Search API — FAQ

Telegram Channel Search API is a programmatic interface for searching the full post history of one public Telegram channel for a word or phrase. It returns up to 100 matching posts with their text, publish date, views and reactions.

It searches inside the channel you pass in url, across that channel's entire history. To find new channels around a topic, start from a known channel with Telegram Similar Channels API.

Up to 100 matching posts, set with results_limit; the default is 20.

Photos in search results link to the post that shows them. Pass that post link to Telegram Post Detail API to get the image file itself.

The Telegram Channel Search API charges 0.5 credits for each matching post returned, so the default 20 results cost 10 credits. A search with no match costs nothing.