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 の使い方
チャンネルリンクと検索語を送信し、一致した投稿を読み取ります。
- {"url": "https://t.me/durov", "query": "TON", "results_limit": 20} を /v1/telegram/channel-search に 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-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 を使ってください。
関連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件取得し、タイトル、認証バッジ、正確な登録者数を返します。