telegram/
post-detail

リンクを指定してTelegramの投稿を取得します。1タスク最大50件、どの公開チャンネルの投稿も混在でき、それぞれ全文、投稿日時、閲覧数、リアクション合計、メディアを返します。

Telegram Post Detail API

1リクエスト最大50投稿
複数チャンネルを混在
閲覧数とリアクション
写真と動画
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Telegram Post Detail

Telegram Post Detail はチャンネル投稿1件の完全なレコードで、本文、投稿日時、閲覧数、リアクション合計、添付の写真や動画を含みます。すでに把握している投稿についてこれらの値を読み取れば、キャンペーン投稿の数値更新、告知内容の記録、手元のリンクへのリーチ数値の付与ができます。

Telegram Post Detail API の主な機能

  • 複数チャンネルの投稿を一度にurls には t.me/channel/post_id 形式の投稿リンクを最大50件指定でき、同じリクエスト内で別々のチャンネルのリンクを混在できます。
  • 現在の閲覧数とリアクションmetrics.views_count と metrics.likes_count が、取得時点の閲覧数とリアクション合計を整数で返します。
  • 全文とメディアtext に投稿本文がすべて入り、media には写真や動画ごとに種類とファイルURLが入ります。
  • 見つからない投稿はスキップして課金なし削除済みの投稿や非公開チャンネルの投稿は除外され、課金されません。タスクが失敗して返金されるのは、どのリンクも読み取れない場合だけです。

Telegram Post Detail API のパラメータ

パラメータ必須説明
urls必須t.me/channel/post_id 形式のTelegram投稿リンクを最大50件。例:https://t.me/durov/510。異なる公開チャンネルのリンクを混在できます。

Telegram Post Detail API の使い方

必要な投稿のリンクを送信し、見つかった投稿ごとに完全なレコードを1件読み取ります。

  1. {"urls": ["https://t.me/durov/510"]} を /v1/telegram/post-detail に 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-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://t.me/durov/510"]}'

Telegram Post Detail API の主なユースケース

  • キャンペーン投稿の数値更新: スポンサー投稿や告知投稿のリンクを保存しておき、定期的に再取得して閲覧数とリアクションの推移を追います。
  • 投稿内容の記録: レポート、紛争対応、ニュースで引用された投稿の本文と投稿日時を、collected_at と一緒に保存します。
  • 共有された投稿リンクの補完: チャット、記事、スプレッドシートから集めた投稿リンクを、投稿元チャンネル、リーチ、メディアを含む完全なレコードに変えます。

Telegram Post Detail API 活用のヒント

  • 複数チャンネルのリンクは1件ずつ送らず、最大50件の1リクエストにまとめてください。
  • author.username は各投稿が属するチャンネルを示すので、混在したバッチをチャンネル別にまとめるのに便利です。
  • リンクがわからないままチャンネルの最新投稿を集めたいときは Telegram Channel Scraper API を使い、Post Detail はすでに特定できている投稿に使ってください。

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

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

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

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

Telegram Post Detail API — よくある質問

Telegram Post Detail APIは、公開Telegramチャンネルの特定の投稿をリンクから1リクエスト最大50件まで取得するためのプログラムインターフェースです。各投稿の本文、投稿日時、閲覧数、リアクション合計、メディアを返します。

https://t.me/durov/510 のように、チャンネル名と投稿番号を含むリンクを指定します。同じリンクの t.me/s/、telegram.me、telegram.dog 形式も使えます。

はい。最大50件のリンクを自由に混在でき、各行の author フィールドで投稿元のチャンネルがわかります。

スキップされて課金されず、残りの投稿は通常どおり返ります。どのリンクも読み取れない場合はタスクが失敗し、クレジットは返金されます。

返された投稿1件につき0.5クレジットで、読み取れる投稿50件のフルバッチなら25クレジットです。