telegram/
channel-info

最大50件のt.meリンクから公開Telegramチャンネルを照会し、チャンネルごとのタイトル、説明文、アイコン、認証バッジ、登録者数をまとめて返します。

Telegram Channel Info API

1リクエスト最大50チャンネル
登録者数を数値で取得
認証バッジ
t.me・t.me/sリンク
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Telegram Channel Info

Telegram Channel Info は、ブロードキャストチャンネルが公開しているプロフィールで、ユーザー名、タイトル、説明文、アイコン、認証バッジ、登録者数で構成されます。これらのシグナルから、チャンネルの規模、Telegramによる認証の有無、何を発信しているかがわかり、スポンサー前の審査、ウォッチリストの更新、チャンネルリストの補完に役立ちます。

Telegram Channel Info API の主な機能

  • 1タスクで最大50チャンネルurls には t.me/name、t.me/s/name、telegram.me、telegram.dog のリンクを混在でき、重複したチャンネルは1回だけ照会され、見つかったチャンネルごとに1行が返ります。
  • 登録者数を整数でmetrics.followers_count は、Telegramの 9.95M のような短縮表示を 9950000 のような整数に変換するため、並べ替えや絞り込み、しきい値の設定にそのまま使えます。
  • 識別情報と認証を1行にusername、name、text、avatar_url がチャンネル自体を表し、is_verified はTelegramの認証バッジが付いているかを示します。
  • 読み取れないリンクはスキップして課金なし非公開または削除済みのチャンネルへのリンクは結果から除かれ、課金もされません。同じバッチの他のチャンネルは通常どおり返ります。

Telegram Channel Info API のパラメータ

パラメータ必須説明
urls必須公開Telegramチャンネルのリンクを最大50件。例:https://t.me/durov、https://t.me/s/durov。telegram.me と telegram.dog のリンクも使え、重複したチャンネルは1回だけ照会されます。

Telegram Channel Info API の使い方

チャンネルリンクのリストを送信し、見つかったチャンネルごとに1行を読み取ります。

  1. {"urls": ["https://t.me/durov", "https://t.me/tginfo"]} を /v1/telegram/channel-info に 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/channel-info" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://t.me/durov","https://t.me/tginfo"]}'

Telegram Channel Info API の主なユースケース

  • スポンサー前のチャンネル審査: 有料掲載に合意する前に、登録者数、認証状況、チャンネルの説明文を並べて確認します。
  • チャンネルのウォッチリスト更新: 同じリストを定期的に再実行し、followers_count を collected_at と一緒に保存して、暗号資産、ニュース、特定ジャンルの各チャンネルの成長を追跡します。
  • 他で集めたリンクの補完: スプレッドシート、検索結果、パートナーのリストにある t.me リンクの列を、タイトル、説明文、オーディエンス規模に変換します。

Telegram Channel Info API 活用のヒント

  • 返された username をキーにしてください。t.me/name と t.me/s/name は同じチャンネルを指して同じ id になるため、繰り返しの照会結果をそのままマージできます。
  • https://t.me/durov/510 のような投稿リンクは、そのチャンネルとして読み取られます。投稿そのものを取得するには Telegram Post Detail API に送信してください。

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

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

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

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

Telegram Channel Info API — よくある質問

Telegram Channel Info APIは、チャンネルのリンクから公開Telegramチャンネルを1リクエスト最大50件まで照会するためのプログラムインターフェースです。チャンネルごとにユーザー名、タイトル、説明文、アイコン、認証バッジ、登録者数を返します。

t.me/name または t.me/s/name 形式のチャンネルリンクに加え、telegram.me と telegram.dog のリンクも使えます。チャンネルのユーザー名は英字で始まる5〜32文字です。

非公開または削除済みのチャンネルはスキップされて課金されず、バッチの残りは通常どおり返ります。どのリンクも読み取れない場合はタスクが失敗し、クレジットは返金されます。

Telegramは登録者数を 9.95M のような短縮形で表示することが多く、その値を対応する整数に変換して返します。Telegramが正確な数値を公開している場合は、その値をそのまま返します。

返されたチャンネル1件につき0.5クレジットで、読み取れるリンクが50件なら25クレジットです。スキップされたリンクは無料です。