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件送信し、そのディスカッションスレッドのコメントを読み取ります。
- {"url": "https://t.me/tginfo/4455", "results_limit": 100} を /v1/telegram/post-comments に 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/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 で並べ替えると支持の多い返信が上に来ます。
関連API
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件、本文、日付、閲覧数、リアクションとともに返します。