telegram/
post-comments

公開Telegramチャンネルの投稿にディスカッショングループで寄せられたコメントを最大100件取得し、投稿者名、本文、日時、リアクション数、返信先のコメントを返します。

Telegram Comments API

最大100件のコメント
返信のスレッド
投稿者と日時
ディスカッショングループのコメント
結果1件あたり0.3クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Telegram Comments

Telegram Comments は、チャンネルに紐づくディスカッショングループを通じて読者が投稿に残す返信で、それぞれに投稿者名、本文、日時、リアクション数、返信先のコメントがあります。このスレッドを読むと、告知がコミュニティにどう受け止められたか、どんな質問が繰り返されるか、どの返信が最も反応を集めたかがわかり、フィードバック分析、サポートの振り分け、コミュニティ調査に役立ちます。

Telegram Comments API の主な機能

  • ディスカッショングループのコメント投稿リンクを1件渡すと、そのチャンネルに紐づくグループのスレッドを1タスク最大100件取得します。
  • parent_id による返信スレッドparent_id には返信先のコメントが入るのでスレッドを再構成でき、tginfo/4455 のような post_id で各行が投稿に結び付きます。
  • コメントごとのリアクションmetrics.likes_count が各コメントのリアクション合計を示し、コミュニティが最も共感した返信を見つけられます。
  • コメントへの直接リンクurl は t.me/channel/post?comment=id の形式でコメント自体を開くため、モデレーションや引用にそのまま使えます。

Telegram Comments API のパラメータ

パラメータ必須説明
url必須Telegram投稿のリンクを1件。例:https://t.me/tginfo/4455。コメントは、投稿がある公開チャンネルに紐づくディスカッショングループから取得されます。
results_limit任意取得するコメント数。1〜100の整数、既定値は100です。

Telegram Comments API の使い方

投稿リンクを1件送信し、そのディスカッションスレッドのコメントを読み取ります。

  1. {"url": "https://t.me/tginfo/4455", "results_limit": 100} を /v1/telegram/post-comments に 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/post-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://t.me/tginfo/4455","results_limit":100}'

Telegram Comments API の主なユースケース

  • 告知への反応の把握: リリースやポリシー変更の投稿についたコメントを集めてテーマ別に分類し、読者の受け止め方を確認します。
  • 繰り返される質問の発見: 複数の投稿のコメント本文を調べ、ユーザーが何度も尋ねる質問を見つけて、ドキュメントやヘルプセンターで回答します。
  • サポートの振り分け: ブランドチャンネルの投稿コメントのうち、不具合、支払い、アカウントの問題に触れたものをサポートの受付キューに回します。
  • コミュニティ調査: 投稿ごとのコメント数とリアクションを比べ、特定のジャンルでどの話題が会話を生むかを把握します。

Telegram Comments API 活用のヒント

  • コメントが有効なチャンネルを選びましょう。コメントはチャンネルに紐づいたディスカッショングループから読み取られ、課金は返ったコメントの件数分です。
  • parent_id で返信を親コメントにつなげてスレッドを再構成し、metrics.likes_count で並べ替えると支持の多い返信が上に来ます。

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

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

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

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

Telegram Comments API — よくある質問

Telegram Comments APIは、公開Telegramチャンネルの投稿についたコメントを、そのディスカッショングループから1リクエスト最大100件取得するためのプログラムインターフェースです。各コメントには投稿者名、本文、日時、リアクション数、返信先のコメントが含まれます。

ディスカッショングループを紐づけたチャンネルでは読者が各投稿にコメントでき、そのスレッドからコメントを読み取ります。課金は返ったコメントの件数分です。

1タスク最大100件で、results_limit で指定します。既定値は100です。

author.name にスレッドに表示される表示名が入り、コメントの本文、日時、リアクション数も一緒に返ります。

返されたコメント1件につき0.3クレジットで、100件のスレッド全体なら30クレジットです。投稿が見つからない場合はタスクが失敗し、クレジットは返金されます。