telegram/
channel-search

公開Telegramチャンネルの全投稿履歴から単語やフレーズを検索し、一致した投稿を最大100件、本文、投稿日、閲覧数、リアクションとともに返します。

Telegram Channel Search API

チャンネルの全履歴
最大100件の一致
閲覧数とリアクション
一致なしは課金なし
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Telegram Channel Search

Telegram Channel Search は、公開チャンネルがこれまでに発信したすべての投稿から単語やフレーズを探し、一致した投稿を本文、投稿日、閲覧数、リアクションとともに返します。どれほど前の言及でも見つかるため、影響力のあるチャンネルがあるプロジェクトを取り上げたことがあるか、あるテーマにどのくらいの頻度で触れているか、各言及がどれだけ注目を集めたかがわかります。

Telegram Channel Search API の主な機能

  • 全履歴を検索query はチャンネルが発信したすべての投稿が対象なので、数年前の言及も今日の投稿と同じように見つかります。
  • 最大100件の一致投稿results_limit で返す一致件数を1〜100(既定20)の範囲で指定します。
  • 一致ごとの閲覧数とリアクション一致した投稿にはそれぞれ metrics.views_count と metrics.likes_count が付き、その言及が集めた注目度がわかります。
  • 一致した分だけ課金一致した投稿1件につき0.5クレジットで、何も見つからなかった検索は無料です。

Telegram Channel Search API のパラメータ

パラメータ必須説明
url必須検索する公開Telegramチャンネルのリンクを1件。例:https://t.me/durov。t.me/s/、telegram.me、telegram.dog のリンクも使えます。
query必須チャンネルの投稿から探す単語やフレーズ。例:TON。
results_limit任意返す一致投稿の数。1〜100の整数、既定値は20です。

Telegram Channel Search API の使い方

チャンネルリンクと検索語を送信し、一致した投稿を読み取ります。

  1. {"url": "https://t.me/durov", "query": "TON", "results_limit": 20} を /v1/telegram/channel-search に 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-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://t.me/durov","query":"TON","results_limit":20}'

Telegram Channel Search API の主なユースケース

  • プロジェクトの言及状況の確認: 提携を持ちかける前に、インフルエンサーやニュースのチャンネルでトークン名、製品名、ブランド名を検索します。
  • リリース関連投稿の収集: 製品リリースやイベントについてチャンネルが発信した投稿をすべて1つのリストにまとめ、振り返りに使います。
  • 出稿前のデューデリジェンス: 掲載枠を買う前に、競合や特定テーマを過去に宣伝したことがあるかをチャンネル内で検索し、その経歴を把握します。
  • チャンネル横断のテーマ調査: 同じ検索語を複数のチャンネルで実行し、言及の頻度とそれらの投稿の閲覧数を比較します。

Telegram Channel Search API 活用のヒント

  • ティッカーとプロジェクトの正式名は別々に検索すると、チャンネルでの両方の書き方を拾えます。
  • 検索結果の写真は、その写真を表示している投稿にリンクします。画像ファイルが必要な場合は、その投稿の url を Telegram Post Detail API に送ってください。
  • 1回の検索の対象は1チャンネルです。テーマに沿ってほかのチャンネルを見つけるには、既知のチャンネルを起点に Telegram Similar Channels API を使ってください。

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

  • Telegram Channel Info API — リンクから公開Telegramチャンネルを最大50件照会し、タイトル、説明文、アイコン、認証バッジ、整数の登録者数を取得します。
  • Telegram Channel Scraper API — 公開Telegramチャンネルの投稿を新しい順に最大1000件取得し、本文、投稿日時、閲覧数、リアクション合計、写真と動画を返します。
  • Telegram Post Detail API — リンクを指定してTelegramの投稿を最大50件取得します。複数の公開チャンネルを混在でき、全文、投稿日時、閲覧数、リアクション、メディアを返します。
  • Telegram Comments API — Telegramチャンネル投稿のコメントをディスカッショングループから最大100件取得し、投稿者名、本文、日時、リアクション、返信先を返します。
  • Telegram Similar Channels API — 公開チャンネルの横にTelegramがおすすめするチャンネルを通常約10件取得し、タイトル、認証バッジ、正確な登録者数を返します。

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

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

Telegram Channel Search API — よくある質問

Telegram Channel Search APIは、1つの公開Telegramチャンネルの全投稿履歴から単語やフレーズを検索するためのプログラムインターフェースです。一致した投稿を最大100件、本文、投稿日、閲覧数、リアクションとともに返します。

url で渡したチャンネルの中を、そのチャンネルの全履歴にわたって検索します。テーマに沿って新しいチャンネルを探すには、既知のチャンネルを起点に Telegram Similar Channels API を使ってください。

一致した投稿を最大100件まで返せ、results_limit で指定します。既定値は20件です。

検索結果の写真は、その写真を表示している投稿にリンクしています。その投稿リンクを Telegram Post Detail API に渡すと、画像ファイル自体を取得できます。

返された一致投稿1件につき0.5クレジットで、既定の20件なら10クレジットです。一致がない検索は無料です。