telegram/
similar-channels

公開チャンネルの横にTelegramがおすすめするチャンネルを通常約10件取得し、それぞれのユーザー名、タイトル、認証バッジ、正確な登録者数を返します。

Telegram Similar Channels API

1回で約10チャンネル
Telegramの表示順
正確な登録者数
認証バッジ
結果1件あたり0.5クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

Telegram Similar Channels

Telegram Similar Channels は、Telegramが公開チャンネル上でおすすめする関連チャンネルの一覧で、各チャンネルにユーザー名、タイトル、認証バッジ、登録者数が付いています。競合や取引のあるチャンネルを起点にすれば、この一覧で出稿先リストを広げ、ジャンルの全体像を整理し、新しいスポンサー候補を見つけられます。

Telegram Similar Channels API の主な機能

  • Telegram自身のおすすめ行はTelegramが関連チャンネルを並べる順に返り、起点のチャンネル1件につき通常約10件です。
  • 正確な登録者数metrics.followers_count はおすすめされた各チャンネルの参加者数から取得するため、丸めた表示ではなく正確な整数です。
  • 次のステップに使えるリンク各行の url はチャンネルリンクなので、Telegram Channel Info API や Telegram Channel Scraper API にそのまま渡して説明文や投稿を取得できます。

Telegram Similar Channels API のパラメータ

パラメータ必須説明
url必須起点にする公開Telegramチャンネルのリンクを1件。例:https://t.me/durov。t.me/s/、telegram.me、telegram.dog のリンクも使えます。

Telegram Similar Channels API の使い方

チャンネルリンクを1件送信し、その横でTelegramがおすすめするチャンネルを読み取ります。

  1. {"url": "https://t.me/durov"} を /v1/telegram/similar-channels に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items からおすすめチャンネルを読み取り、has_more が true の間は results.next_cursor を渡して次のページを読み込みます。
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 の主なユースケース

  • 出稿先リストの拡大: 広告の成果が出ているチャンネルを起点におすすめチャンネルを集め、次に試す掲載先を見つけます。
  • ジャンルの全体像の整理: 複数のシードチャンネルから照会して結果をまとめ、Telegramがどのチャンネルを同じテーマにまとめているかを確認します。
  • 競合の周辺チャンネルの把握: 競合チャンネルの横にどのチャンネルが表示されるか、その規模と認証状況を確認します。

Telegram Similar Channels API 活用のヒント

  • おすすめの行にはタイトル、バッジ、登録者数が入ります。説明文やアイコンも必要な場合は、リンクを Telegram Channel Info API に送ってください。
  • 有望な結果に対して照会を繰り返すと、シードチャンネルから外側へ広げていけます。リストが増えたら username で重複を除いてください。

Telegram Similar Channels API 以外に別の種類の公開Telegramデータが必要な場合は、これらのAPIをご利用ください。

  • Telegram Channel Info API — リンクから公開Telegramチャンネルを最大50件照会し、タイトル、説明文、アイコン、認証バッジ、整数の登録者数を取得します。
  • Telegram Channel Scraper API — 公開Telegramチャンネルの投稿を新しい順に最大1000件取得し、本文、投稿日時、閲覧数、リアクション合計、写真と動画を返します。
  • Telegram Post Detail API — リンクを指定してTelegramの投稿を最大50件取得します。複数の公開チャンネルを混在でき、全文、投稿日時、閲覧数、リアクション、メディアを返します。
  • Telegram Comments API — Telegramチャンネル投稿のコメントをディスカッショングループから最大100件取得し、投稿者名、本文、日時、リアクション、返信先を返します。
  • Telegram Channel Search API — 公開Telegramチャンネルの全投稿履歴から単語やフレーズを検索し、一致した投稿を最大100件、本文、日付、閲覧数、リアクションとともに返します。

他のプラットフォームを見る

Telegramのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Telegram Similar Channels API — よくある質問

Telegram Similar Channels APIは、公開チャンネルの横にTelegramがおすすめするチャンネルを、1回の照会で通常約10件取得するためのプログラムインターフェースです。おすすめされた各チャンネルのユーザー名、タイトル、認証バッジ、登録者数を返します。

通常は約10件で、そのチャンネルに対するTelegramのおすすめに沿い、Telegramの表示順で返ります。

返されたリンクを Telegram Channel Info API に渡すと、各チャンネルの説明文とアイコンが加わります。

返されたおすすめチャンネル1件につき0.5クレジットで、一般的な10件の一覧なら約5クレジットです。