telegram/
channel-posts

公開Telegramチャンネルの投稿を最新から順にさかのぼって1タスク最大1000件取得し、本文、投稿日時、閲覧数、リアクション合計、添付の写真と動画を返します。

Telegram Channel Scraper API

最大1000件の投稿
新しい順
閲覧数とリアクション
写真と動画
結果1件あたり0.3クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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 の使い方

チャンネルリンクと取得件数を送信し、投稿を新しい順に読み取ります。

  1. {"url": "https://t.me/durov", "results_limit": 20} を /v1/telegram/channel-posts に 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-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 を保存し、投稿時期の近い投稿どうしで比較してください。

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件、本文、日付、閲覧数、リアクションとともに返します。

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

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

Telegram Channel Scraper API — よくある質問

Telegram Channel Scraper APIは、公開Telegramチャンネルの投稿を新しい順に1タスク最大1000件取得するためのプログラムインターフェースです。各投稿には本文、投稿日時、閲覧数、リアクション合計、添付メディアが含まれます。

results_limit で1〜1000件を指定でき、既定値は20件です。投稿は新しい順に返るため、小さい値にすれば最新の動きがわかります。

Telegramでは、likes_count は投稿についたすべてのリアクションの合計で、絵文字リアクションと有料のStarリアクションを1つの数値にまとめています。

公開チャンネルで、t.me/name、t.me/s/name、telegram.me、telegram.dog のいずれかの形式のリンクで指定します。非公開などでチャンネルを読み取れない場合、タスクは失敗し、クレジットは返金されます。

写真と動画のURLはTelegramのファイルサーバーを指しており、一定時間が経つと失効します。必要なファイルはタスク完了後すぐにダウンロードしてください。

返された投稿1件につき0.3クレジットで、既定の20件なら6クレジット、1000件なら300クレジットです。