2026-11-17、SocQは公開Telegramチャンネル向けに6つのエンドポイントを備えたTelegramプラットフォームを追加しました。これらを組み合わせると、チャンネルの見極め、フィードの読み取り、特定の投稿の取得、投稿に寄せられたディスカッションの確認、関連チャンネルの発見、チャンネルの過去投稿からのキーワード検索まで、リサーチの流れをひととおりカバーできます。
このガイドでは、各エンドポイントが返すデータ、リクエストの形、料金、使いどころを説明します。どのエンドポイントも公開されているt.meリンクを入力に使い、SocQの非同期タスクとして実行されます。
結論:
Authorization: Bearer $SOCQ_API_KEYを付けて、公開チャンネルまたは投稿のリンクを6つのPOST /v1/telegram/...エンドポイントのいずれかに送信します。返されたtask_idを保存し、statusがsucceededになるまでGET /v1/tasks/{task_id}をポーリングして、data.results.itemsのレコードを読み取ります。すべてのエンドポイントは結果1件ごとの課金で、1行あたり0.3または0.5クレジットです。1クレジット$0.005で換算すると、$0.0015または$0.0025になります。
新しく追加された6つのTelegramエンドポイント
| エンドポイント | 返すデータ | 入力 | 料金 |
|---|---|---|---|
| Channel Info | タイトル、説明文、アバター、認証バッジ、購読者数 | 最大50件のチャンネルリンク | チャンネル1件あたり0.5クレジット($0.0025) |
| Channel Scraper | 新しい順の投稿。テキスト、日時、閲覧数、リアクション合計、写真、動画を含む | チャンネルリンク1件 | 投稿1件あたり0.3クレジット($0.0015) |
| Post Detail | 指定した投稿の全文、日時、閲覧数、リアクション、メディア | 最大50件の投稿リンク | 投稿1件あたり0.5クレジット($0.0025) |
| Comments | リンクされたディスカッショングループの最大100件のコメント。投稿者、テキスト、日時、リアクション、返信先を含む | 投稿リンク1件 | コメント1件あたり0.3クレジット($0.0015) |
| Similar Channels | Telegramがチャンネルの横に表示するおすすめチャンネル。ユーザー名、タイトル、バッジ、購読者数を含む | チャンネルリンク1件 | チャンネル1件あたり0.5クレジット($0.0025) |
| Channel Search | 1つのチャンネルの全履歴から、単語やフレーズに一致する投稿 | チャンネルリンク1件+クエリ | 一致した投稿1件あたり0.5クレジット($0.0025) |
6つとも課金対象は返された行のみで、リクエストごとの基本料金はかかりません。
Telegram Channel Info:チャンネルをまとめて見極める
Telegram Channel Info APIは、t.me/nameまたはt.me/s/nameのリンクで公開チャンネルを照会し、チャンネルごとに1行を返します。内容は名前、説明文、アバター、認証バッジ、購読者数(metrics.followers_count)です。スポンサー契約の前にチャンネルを見極めたり、ニュースや暗号資産関連チャンネルのウォッチリストを更新したり、ほかの方法で集めたチャンネルリンクに情報を付け加えたりする用途に使えます。生の結果ファイルには、各チャンネルが共有した写真、動画、リンクの数も含まれます。
curl -X POST "https://api.socq.ai/v1/telegram/channel-info" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://t.me/durov", "https://t.me/tginfo"]
}'
1回のリクエストで最大50件のリンクを送信できます。公開されていないチャンネルへのリンクはスキップされ、1件も読み取れなかった場合にのみタスクが失敗し、返金されます。詳しくはChannel Infoのドキュメントをご覧ください。
Telegram Channel Scraper:チャンネルのフィードを読み取る
Telegram Channel Scraper APIは、公開チャンネルを最新の投稿からさかのぼって読み取ります。各投稿には、テキスト、公開日時、閲覧数、絵文字リアクションとStarリアクションの合計、添付された写真と動画が付きます。直近数日分を取得してデイリーダイジェストを作ることも、上限を引き上げてチャンネルの過去投稿をまとめて取り込むこともできます。
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
}'
results_limitのデフォルトは20で、1〜1,000を指定できます。読み取れないチャンネルの場合はタスクが失敗し、返金されます。詳しくはChannel Scraperのドキュメントをご覧ください。
Telegram Post Detail:既知の投稿を更新する
重要な投稿がすでに分かっている場合は、Telegram Post Detail APIにそのリンクを渡すと、各投稿の全文、公開日時、閲覧数、リアクション合計、写真、動画をまとめて返します。異なるチャンネルの投稿を1回のリクエストに混在させられるため、追跡しているお知らせやキャンペーン投稿の数値を更新する用途に向いています。生の結果ファイルには、絵文字ごとのリアクション数と転送元が保持されます。
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"]
}'
t.me/channel/post_idの形式のリンクを最大50件送信できます。削除された投稿や非公開チャンネルの投稿はスキップされます。詳しくはPost Detailのドキュメントをご覧ください。
Telegram Comments:投稿に寄せられたディスカッションを読む
ディスカッショングループをリンクしているチャンネルでは、読者が各投稿の下にコメントできます。Telegram Comments APIは、1つの投稿のスレッドを読み取り、各コメントの投稿者名、テキスト、日時、リアクション合計、返信先のコメント(parent_id)を返します。お知らせに対するコミュニティの反応を把握したり、コメントをサポートやリサーチのワークフローに取り込んだりするのに使えます。
curl -X POST "https://api.socq.ai/v1/telegram/post-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://t.me/tginfo/4455",
"results_limit": 100
}'
results_limitのデフォルトは100で、これが上限でもあります。料金は返されたコメントの分だけです。詳しくはCommentsのドキュメントをご覧ください。
Telegram Similar Channels:ニッチの全体像をつかむ
Telegramでは、すべての公開チャンネルに関連チャンネルの一覧が表示されます。Telegram Similar Channels APIは、1つのチャンネルについてその一覧(通常は10件前後)をTelegramの表示順で返し、それぞれにユーザー名、タイトル、認証バッジ、購読者数が付きます。競合や、すでに広告を出しているチャンネルを起点にして、メディアリストを広げられます。
curl -X POST "https://api.socq.ai/v1/telegram/similar-channels" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://t.me/durov"
}'
詳しくはSimilar Channelsのドキュメントをご覧ください。
Telegram Channel Search:チャンネルの過去投稿を検索する
Telegram Channel Search APIは、公開チャンネルの全履歴を対象に単語やフレーズで検索し、一致した投稿をテキスト、日付、閲覧数、リアクションとともに返します。影響力のあるチャンネルがあるプロジェクトに言及したことがあるかを確かめたり、あるローンチについてチャンネルが公開したすべての投稿を集めたりできます。
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
}'
results_limitのデフォルトは20で、1〜100を指定できます。一致する投稿がない検索には料金がかかりません。検索結果に含まれる写真は、その写真を表示している投稿にリンクしています。詳しくはChannel Searchのドキュメントをご覧ください。
認証と非同期タスクの流れ
すべてのリクエストには、APIキーとJSONのContent-Typeを付けます。
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
送信リクエストごとに、バックグラウンドタスクが開始されます。
submit -> task_id -> queued -> running -> succeeded
\-> failed
送信時のレスポンスにはdata.task_idとdata.statusが含まれます。同じキーでタスクをポーリングします。
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
タスクがqueued、running、failedの間、レスポンスにはタスクのメタデータのみが含まれます。failedの場合はerror_messageを確認してください。succeededになると、同じレスポンスのdata.results.itemsに正規化されたレコードの最初のページが含まれます。limitのデフォルトは50で、最大500まで指定できます。has_moreがtrueの場合は、results.next_cursorをcursorとして渡すと次のページを読み取れます。取得するフィールドを絞りたい場合は、fieldsにカンマ区切りで最大50個のフィールドまたはドットパスを指定できます。
クライアント側でタイムアウトしてもタスクはキャンセルされません。重複したタスクを送信して二重に支払うのではなく、同じtask_idで照会を再開してください。ポーリングを避けたい場合は、送信ボディにcallback_urlを追加します。タスクが完了するとSocQがタスクの概要をPOSTで1回送信するので、その後タスクのエンドポイントからレコードを読み取ります。
典型的なジョブの料金
- Channel Infoで50チャンネルを見極める:50 × 0.5 = 25クレジット、$0.125。
- 1つのチャンネルから1,000件の投稿をさかのぼって取得する:1,000 × 0.3 = 300クレジット、$1.50。
- お知らせ投稿の下にある100件のコメントを読む:30クレジット、$0.15。
- 1つのチャンネルを検索して20件ヒットする:10クレジット、$0.05。
よくある質問(FAQ)
非公開のチャンネルやグループにも使えますか?
いいえ。これらのエンドポイントは、t.meリンクで公開チャンネルを読み取ります。Channel InfoとPost Detailは読み取れないリンクをスキップし、Commentsは公開チャンネルが投稿にリンクしているディスカッショングループを読み取ります。
Channel Scraperはどこまでさかのぼれますか?
新しい順に読み取り、results_limitには1回のリクエストあたり最大1,000件の投稿を指定できます。特定のテーマに関する古い投稿を探す場合は、チャンネルの全履歴を対象にするChannel Searchを使ってください。
リアクション数には何が含まれますか?
チャンネル投稿の場合、metrics.likes_countには絵文字リアクションとStarリアクションの合計が入ります。Post Detailの生の結果ファイルには、絵文字ごとの数が保持されます。
見つからなかったチャンネルや投稿にも料金がかかりますか?
いいえ。課金は返された行ごとで、基本料金はありません。一致する投稿がないChannel Searchは無料で、リンクを1件も読み取れなかったタスクは失敗となり返金されます。
追跡する新しいチャンネルはどうやって見つければよいですか?
知っているチャンネルを1つ起点にしてSimilar Channelsを呼び出し、返されたリンクをChannel Infoに渡して購読者数を比較します。すべてのエンドポイントはTelegramプラットフォームのページで、最新の料金は料金ページでご確認いただけます。