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は公開チャンネルのデータを、保存・比較・組み合わせしやすい正規化されたレコードとして返します。
| 機能 | SocQ | Telegram API |
|---|---|---|
| アクセス | SocQのAPIキー | TelegramアプリIDとログイン済みアカウント、またはボットトークン |
| 入力 | 公開されている t.me のチャンネルリンクと投稿リンク | クライアントセッション内で解決するTelegramのオブジェクト識別子 |
| 出力 | 数値が整数で入った正規化JSONレコード | Telegramのネイティブオブジェクト |
| 処理方式 | 結果を保存しページングで読める非同期タスク | 自前のクライアントからのリアルタイム呼び出し |
Telegram APIの仕組み
6つのエンドポイントはすべて、同じ非同期の送信・ポーリング・読み取りの流れで動きます。
1. リンクから始める
チャンネルリンクを Channel Info、Channel Scraper、Similar Channels、Channel Search に、投稿リンクを Post Detail か Comments に送信します。
2. タスクをポーリングする
返された task_id で /v1/tasks/{task_id} を呼び出し、処理が成功または失敗するまで待ちます。
3. 結果をつなぐ
Channel Scraper や Channel Search の投稿 url を Comments や Post Detail に、Similar Channels のチャンネル url を Channel Info に渡します。
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つの非同期ワークフローで取得できます。





