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件読み取ります。
- {"urls": ["https://t.me/durov/510"]} を /v1/telegram/post-detail に 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-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 はすでに特定できている投稿に使ってください。
関連API
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件、本文、日付、閲覧数、リアクションとともに返します。