telegram/
similar-channels

The Telegram Similar Channels API returns the channels Telegram recommends next to a public channel, usually around ten, each with its username, title, verification badge and exact subscriber count.

Telegram Similar Channels API

About 10 channels per lookup
Telegram's own order
Exact subscriber count
Verification badge
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 Similar Channels

Telegram Similar Channels is the row of related channels Telegram recommends on a public channel, each listed with its username, title, verification badge and subscriber count. Starting from a competitor or a channel you already work with, that list widens a media plan, maps a niche and turns up new sponsorship candidates.

Telegram Similar Channels API Features

  • Telegram's own recommendationsRows follow the order in which Telegram lists the related channels, usually around ten for one starting channel.
  • Exact subscriber countsmetrics.followers_count comes from each recommended channel's participant count, so it is a precise integer rather than a rounded label.
  • Links ready for the next stepEach row's url is a channel link that can go straight into Telegram Channel Info API or Telegram Channel Scraper API for descriptions and posts.

Telegram Similar Channels API Parameters

ParametersRequiredDescription
urlRequiredOne public Telegram channel link to start from, such as https://t.me/durov; t.me/s/, telegram.me and telegram.dog links work too.

How to Use the Telegram Similar Channels API

Send one channel link to the Telegram Similar Channels API and read the channels Telegram recommends beside it.

  1. POST {"url": "https://t.me/durov"} to /v1/telegram/similar-channels.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read the recommended channels 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/similar-channels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://t.me/durov"}'

Telegram Similar Channels API Use Cases

  • Widening a media list: Start from channels where your ads already perform and collect their recommendations with the Telegram Similar Channels API to find the next placements to test.
  • Mapping a niche: Run lookups from several seed channels and merge the results to see which channels Telegram groups together around a topic.
  • Discovering competitors' neighbours: See which channels appear beside a competitor's channel, and how large and how often verified they are.

Telegram Similar Channels API Pro Tips

  • Recommendation rows carry title, badge and subscriber count; send their links to Telegram Channel Info API when you also want descriptions and avatars.
  • Repeat the lookup on a promising result to walk outward from your seed channel, de-duplicating by username as the list grows.

Beyond the Telegram Similar Channels 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 Channel Search API — Search a public Telegram channel's full post history for a word or phrase and get up to 100 matching posts with text, date, views and reactions.

Explore other platforms

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

Telegram Similar Channels API — FAQ

Telegram Similar Channels API is a programmatic interface for retrieving the channels Telegram recommends next to a public channel, usually around ten per lookup. Each recommended channel comes with its username, title, verification badge and subscriber count.

Usually around ten, matching what Telegram recommends for that channel, in the order Telegram shows them.

Pass the returned links to Telegram Channel Info API, which adds each channel's description and avatar.

The Telegram Similar Channels API charges 0.5 credits for each recommended channel returned, so a typical list of ten costs about 5 credits.