API一覧に戻る
Telegramの公開チャンネルデータ

Telegram Public Data API

t.meリンクから公開Telegramチャンネルを読み取ります。登録者数付きのチャンネル情報、閲覧数とリアクション付きの投稿、個別の投稿、ディスカッショングループのコメント、類似チャンネル、全履歴の検索に対応します。

利用できるTelegram API

Channel Info、Channel Scraper、Similar Channels、Channel Search はチャンネルリンクから、Post Detail と Comments は投稿リンクから始めます。どの結果にも、次のエンドポイントにそのまま渡せるリンクが付きます。

取得できるTelegramデータ

各エンドポイントは、公開チャンネルが誰にでも表示している内容から作った安定したSocQレコードを返します。

チャンネル情報

ユーザー名、タイトル、説明文、アイコン、認証バッジ、整数の登録者数を、1リクエスト最大50チャンネル分返します。

投稿とメディア

本文、投稿日時、閲覧数、有料のStarリアクションを含むリアクション合計、写真と動画のリンクを、新しい順に最大1000件、またはリンク指定で最大50件取得できます。

ディスカッショングループのコメント

投稿1件につき最大100件のコメントの投稿者名、本文、日時、リアクションに加え、返信スレッドを再構成するための parent_id と post_id を返します。

類似チャンネル

Telegramがチャンネルの横におすすめするチャンネルを、通常約10件、Telegramの表示順で正確な登録者数とともに返します。

チャンネル内検索

1つのチャンネルの全履歴から単語やフレーズに一致する投稿を最大100件、閲覧数とリアクションとともに返します。

SocQとTelegram API

Telegram自身のAPIは、Telegramのアプリやボットを開発するためのものです。SocQは公開チャンネルのデータを、保存・比較・組み合わせしやすい正規化されたレコードとして返します。

機能SocQTelegram API
アクセスSocQのAPIキーTelegramアプリIDとログイン済みアカウント、またはボットトークン
入力公開されている t.me のチャンネルリンクと投稿リンククライアントセッション内で解決するTelegramのオブジェクト識別子
出力数値が整数で入った正規化JSONレコードTelegramのネイティブオブジェクト
処理方式結果を保存しページングで読める非同期タスク自前のクライアントからのリアルタイム呼び出し

Telegram APIの仕組み

6つのエンドポイントはすべて、同じ非同期の送信・ポーリング・読み取りの流れで動きます。

  1. 1. リンクから始める

    チャンネルリンクを Channel Info、Channel Scraper、Similar Channels、Channel Search に、投稿リンクを Post Detail か Comments に送信します。

  2. 2. タスクをポーリングする

    返された task_id で /v1/tasks/{task_id} を呼び出し、処理が成功または失敗するまで待ちます。

  3. 3. 結果をつなぐ

    Channel Scraper や Channel Search の投稿 url を Comments や Post Detail に、Similar Channels のチャンネル url を Channel Info に渡します。

1回のAPIリクエストから始める

SocQのAPIキーで認証します。Channel Scraper のデフォルトは20件で、最大1000件まで指定できます。

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}'

# Then read the comments under one post:
# POST /v1/telegram/post-comments
# {"url":"https://t.me/tginfo/4455"}
# Poll GET /v1/tasks/{task_id}

Telegram APIの主なユースケース

スポンサー前のチャンネル審査

Channel Info で登録者数と認証を確認し、Channel Scraper で直近の投稿の閲覧数を見てから、有料掲載を判断します。

チャンネルのダイジェストとアラート

ニュース、相場、プロジェクトのチャンネルの最新投稿を定期的に集め、新しい本文とリンクを要約やアラートに流します。

コミュニティのフィードバック

告知についたコメントを集めてテーマ別に分類し、読者の反応や繰り返される質問を把握します。

ジャンルの全体像の整理

Similar Channels でシードチャンネルから外側へ広げ、オーディエンス規模付きの関連チャンネルリストを作ります。

言及の調査

影響力のあるチャンネルでブランド名、トークン名、製品名を検索し、各言及が集めた注目度を測ります。

データの範囲

結果は、取得時点で公開Telegramチャンネルが誰にでも表示している内容を反映します。

  • すべてのエンドポイントは公開チャンネルを読み取り、チャンネルのユーザー名またはチャンネル内の投稿番号で対象を特定します。
  • コメントは、チャンネルが投稿に紐づけたディスカッショングループから取得し、1タスクで投稿1件につき最大100件です。
  • Similar Channels は、Telegramがそのチャンネルに表示するおすすめを返し、通常は約10件です。
  • Channel Search は1リクエストで1つのチャンネルの全履歴を検索し、一致を最大100件返します。
  • 数値は collected_at 時点のスナップショットで、写真と動画のファイルリンクは一時的なものです。残したいファイルは早めにダウンロードしてください。

Telegram APIに関するよくある質問

Telegram APIとは何ですか?

Telegram APIは、公開Telegramチャンネルをリンクから読み取り、チャンネル情報、投稿、ディスカッショングループのコメント、類似チャンネル、チャンネル内検索の結果を正規化されたJSONレコードとして返すSocQのエンドポイント群です。

どのTelegram APIを利用できますか?

Telegram Channel Info API、Telegram Channel Scraper API、Telegram Post Detail API、Telegram Comments API、Telegram Similar Channels API、Telegram Channel Search API の6つです。

Telegramのアカウントやボットトークンは必要ですか?

いいえ。リクエストにはSocQのAPIキーと、公開チャンネルまたは投稿のリンクを使います。

どのリンク形式に対応していますか?

t.me/durov や t.me/s/durov のようなチャンネルリンクと、その telegram.me・telegram.dog 形式に対応します。Post Detail と Comments では t.me/durov/510 のような投稿リンクを使います。

登録者数や閲覧数はどのような形で返りますか?

整数で返ります。9.95M や 661K のようなTelegramの短縮表示は整数に変換され、Similar Channels は正確な登録者数を返します。

各エンドポイントの料金はどうなっていますか?

Channel Info、Post Detail、Similar Channels、Channel Search は返された結果1件につき0.5クレジット、Channel Scraper と Comments は投稿またはコメント1件につき0.3クレジットです。読み取れないリンクはスキップまたは返金され、コメントのない投稿や一致のない検索は無料です。

さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。

Link in Bio API

クリエイターがInstagram、TikTok、YouTubeのプロフィール欄に置く1本のリンクを、表示名、紹介文、アイコン、掲載されている連絡先メール、連携SNS、各ボタンのタイトルとリンク先という構造化データに変えます。

Creator API

Instagram、TikTok、YouTube、X、Facebook、Threadsのプロフィール1件を起点に、クリエイターの公開ビジネスメール、ほかのSNSのアカウント、プロフィール写真からの年齢・性別の推定を取得します。

Google Hotels API

目的地でホテルを検索し、任意のホテルのGoogleホテル上のプロフィールと1泊料金カレンダーを取得します。3つはすべて同じホテルIDでつながります。

Brand Monitoring API

ブランド、製品、トピックに言及したWebページを探し、ページごとに感情をスコア化し、Web全体での語られ方を要約します。

AI Search API

AI概要、ChatGPT、GoogleのAIモードが市場の質問にどう答えているかを追跡します。ブランドに触れた回答、可視性の高さ、引用されているドメインとページがわかります。

Instagram API

公開プロフィールを検索・照会し、フォロワーリストのレコード、フォロー関係、投稿、プロフィールがタグ付けされた投稿、ハッシュタグの検索結果、リール、文字起こし、コメント、アカウント数値、エンゲージメント指標、メディアのメタデータを、1つの非同期ワークフローで取得できます。