Telegram Channel Scraper
Telegram Channel Scraper は公開ブロードキャストチャンネルのフィードを読み取るもので、各投稿には本文、投稿日時、閲覧数、リアクション合計、写真や動画が含まれます。一連の投稿の閲覧数とリアクションから、チャンネルの読者が実際に何を読み、何に反応しているかがわかり、日次ダイジェスト、コンテンツのベンチマーク、過去分のアーカイブに活用できます。
Telegram Channel Scraper API の主な機能
- 新しい投稿から最大1000件results_limit で取得件数を1〜1000(既定20)の範囲で指定し、最新の投稿からさかのぼって読み取ります。
- 閲覧数を整数でmetrics.views_count は 661K のようなTelegramの短縮表示を整数に変換するため、投稿同士をそのまま比較・合計できます。
- Starを含むリアクション合計metrics.likes_count は投稿についたすべてのリアクションを、絵文字リアクションも有料のStarリアクションもまとめて1つのエンゲージメント値にします。
- 投稿ごとの写真と動画media は添付ファイルごとに、image か video かの種類とファイルの直接URLを示します。
- 安定した投稿ID各行の id は durov/564 のようにチャンネルと投稿番号の組み合わせで、url は投稿に直接リンクします。
Telegram Channel Scraper API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
url | 必須 | 公開Telegramチャンネルのリンクを1件。例:https://t.me/durov。t.me/s/、telegram.me、telegram.dog の形式も使えます。 |
results_limit | 任意 | 取得する投稿数で、新しい順に並びます。1〜1000の整数、既定値は20です。 |
Telegram Channel Scraper API の使い方
チャンネルリンクと取得件数を送信し、投稿を新しい順に読み取ります。
- {"url": "https://t.me/durov", "results_limit": 20} を /v1/telegram/channel-posts に 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-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://t.me/durov","results_limit":20}'Telegram Channel Scraper API の主なユースケース
- チャンネルの日次ダイジェスト: 毎朝直近20〜50件の投稿を取得し、ニュースや相場のチャンネル群が夜間に発信した内容を要約します。
- 閲覧数によるコンテンツのベンチマーク: 直近の投稿を views_count と likes_count で並べ、読者を引きつける形式やテーマを見極めます。
- チャンネルのアーカイブ補完: 最初に大きな results_limit で過去分を取得し、以降の実行では新しい投稿だけを集めます。
- 告知チャンネルの監視: プロジェクトやブランドのチャンネルに新しい投稿が出たら、本文とリンクをアラートや調査データベースに流します。
Telegram Channel Scraper API 活用のヒント
- published_at を前回の実行時刻と比べ、保存済みの投稿に達したら保存を止めると、定期実行のデータ量と費用を抑えられます。
- 残したい写真や動画は取得後早めにダウンロードしてください。Telegramのファイルリンクは一定時間で失効します。
- 閲覧数とリアクションは取得時点の値なので、スナップショットごとに collected_at を保存し、投稿時期の近い投稿どうしで比較してください。
関連API
Telegram Channel Scraper API 以外に別の種類の公開Telegramデータが必要な場合は、これらのAPIをご利用ください。
- Telegram Channel Info API — リンクから公開Telegramチャンネルを最大50件照会し、タイトル、説明文、アイコン、認証バッジ、整数の登録者数を取得します。
- Telegram Post Detail API — リンクを指定してTelegramの投稿を最大50件取得します。複数の公開チャンネルを混在でき、全文、投稿日時、閲覧数、リアクション、メディアを返します。
- Telegram Comments API — Telegramチャンネル投稿のコメントをディスカッショングループから最大100件取得し、投稿者名、本文、日時、リアクション、返信先を返します。
- Telegram Similar Channels API — 公開チャンネルの横にTelegramがおすすめするチャンネルを通常約10件取得し、タイトル、認証バッジ、正確な登録者数を返します。
- Telegram Channel Search API — 公開Telegramチャンネルの全投稿履歴から単語やフレーズを検索し、一致した投稿を最大100件、本文、日付、閲覧数、リアクションとともに返します。