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行を読み取ります。
- {"urls": ["https://t.me/durov", "https://t.me/tginfo"]} を /v1/telegram/channel-info に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- 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 に送信してください。
関連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件、本文、日付、閲覧数、リアクションとともに返します。