プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Telegramの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
チャンネルの投稿channel_posts | 公開Telegramチャンネルに投稿されたメッセージを読み取ります。各投稿には本文、閲覧数、メディア、リアクション、転送元が含まれます。非公開の招待リンクには対応していません。1回の取得でチャンネルの全履歴を取得できるとは限りません。 | 1,000リクエストあたり$0.56 | 正常 |
プロフィールprofile | 公開Telegramチャンネルの規模を確認します。登録者数、写真・動画・リンクの件数、自己紹介、アバター、認証ステータスを取得できます。チャンネル名、@name、t.me/name、t.me/s/nameのいずれの形式でも指定できます。プライベートチャット、電話番号、メンバー名は取得できません。 | 1,000リクエストあたり$0.56 | 正常 |
検索search | 公開Telegramチャンネル全体から、キーワードでメッセージを検索します。各結果には、チャンネル名、種類、登録者数、閲覧数、リアクション、メディアが含まれます。sinceとuntilで期間を絞り込めます。プライベートチャットは検索対象外で、結果はTelegram全体を網羅するものではありません。 | 1,000リクエストあたり$0.56 | 正常 |
グループgroup | Telegramのグループやチャンネルの情報カードを取得します。タイトル、説明、メンバー数とオンライン数、作成日、詐欺・偽装・認証済みのフラグが含まれます。非公開の招待リンクには対応しておらず、グループへの参加や制限付きコンテンツの閲覧は行いません。 | 1,000リクエストあたり$0.56 | 正常 |
メンバーmembers | 公開Telegramグループの表示可能なメンバーを、ユーザー名、名前、アカウント種別、Premium・詐欺・偽装のフラグ、最終接続時刻とともに一覧で取得します。一覧は一部のみの場合があり、電話番号はメンバーが公開している場合にのみ表示されます。 | 1,000リクエストあたり$0.56 | 正常 |
投稿詳細post_detail | 公開Telegramチャンネルのメッセージ1件を、https://t.me/durov/520のようなリンクから読み取ります。テキスト、閲覧数、投稿日時、メディアの種類とリンク、投稿者の署名、転送元、返信先リンク、リンクプレビュー、リアクションとその数を取得できます。 | 1,000リクエストあたり$0.81 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Telegramの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
channel_postsチャンネルの投稿 公開Telegramチャンネルに投稿されたメッセージを読み取ります。各投稿には本文、閲覧数、メディア、リアクション、転送元が含まれます。非公開の招待リンクには対応していません。1回の取得でチャンネルの全履歴を取得できるとは限りません。 | username | — | Sync配信 | カタログ値：defaultLimit=20、maxLimit=200。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$0.56 | id · url · channel_username · channel_title · text · view_count · posted_at · media_type · media_url · author · is_forwarded · forwarded_from · reply_to_url · platform · link_preview_url · reactions |
profileプロフィール 公開Telegramチャンネルの規模を確認します。登録者数、写真・動画・リンクの件数、自己紹介、アバター、認証ステータスを取得できます。チャンネル名、@name、t.me/name、t.me/s/nameのいずれの形式でも指定できます。プライベートチャット、電話番号、メンバー名は取得できません。 | username | — | Sync配信 | — | 1,000リクエストあたり$0.56 | username · name · bio · subscriber_count · photo_count · video_count · link_count · is_verified · avatar_url · url · platform |
search検索 公開Telegramチャンネル全体から、キーワードでメッセージを検索します。各結果には、チャンネル名、種類、登録者数、閲覧数、リアクション、メディアが含まれます。 | keyword | since, until | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$0.56 | id · url · text · posted_at · view_count · media_url · reactions · channel_username · channel_title · channel_type · channel_subscriber_count · channel_description · platform |
groupグループ Telegramのグループやチャンネルの情報カードを取得します。タイトル、説明、メンバー数とオンライン数、作成日、詐欺・偽装・認証済みのフラグが含まれます。非公開の招待リンクには対応しておらず、グループへの参加や制限付きコンテンツの閲覧は行いません。 | username | — | Sync配信 | — | 1,000リクエストあたり$0.56 | id · type · username · url · title · name · description · member_count · online_count · created_at · is_verified · is_scam · is_fake · is_forum · is_restricted · admin_bots · platform |
membersメンバー 公開Telegramグループの表示可能なメンバーを、ユーザー名、名前、アカウント種別、Premium・詐欺・偽装のフラグ、最終接続時刻とともに一覧で取得します。一覧は一部のみの場合があり、電話番号はメンバーが公開している場合にのみ表示されます。 | username | — | Sync配信 | カタログ値：defaultLimit=100、maxLimit=5000。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$0.56 | id · username · url · name · type · is_verified · is_premium · is_scam · is_fake · last_seen_at · phone · platform |
post_detail投稿詳細 公開Telegramチャンネルのメッセージ1件を、https://t.me/durov/520のようなリンクから読み取ります。テキスト、閲覧数、投稿日時、メディアの種類とリンク、投稿者の署名、転送元、返信先リンク、リンクプレビュー、リアクションとその数を取得できます。 | url | — | Sync配信 | — | 1,000リクエストあたり$0.81 | id · url · channel_username · text · view_count · posted_at · media_type · media_url · author · is_forwarded · forwarded_from · reply_to_url · platform · link_preview_url · reactions |
Telegramのchannel_postsのパラメータはそれぞれどういう意味ですか？
公開Telegramチャンネルに投稿されたメッセージを読み取ります。各投稿には本文、閲覧数、メディア、リアクション、転送元が含まれます。非公開の招待リンクには対応していません。1回の取得でチャンネルの全履歴を取得できるとは限りません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況username必須- 対象の公開チャンネルまたはグループを、name、@name、t.me/name、t.me/s/nameなどの形式で指定します。channel_postsとprofileでは公開チャンネルの指定に、groupでは公開エンティティのメタデータの取得に、membersでは表示可能なグループメンバーの取得に使用します。非公開の招待リンクには対応しておらず、メンバーリストの完全性は保証されません。Telegram公式：チャンネル、公開ユーザー名、閲覧数 — Telegramの公式ドキュメントでは、公開チャンネルと招待制のプライベートチャンネルを区別し、チャンネルはブロードキャスト用のツールであること、閲覧数には転送されたコピーも含まれ概算値であることを説明しています。これはチャンネルオブジェクトとview_countパラメータを説明するものですが、このエンドポイントがチャンネルの全履歴や非公開コンテンツを読み取れることを裏付けるものではありません。 · 確認日Telegram公式：コンテンツへのアクセスに引き続き適用されるライセンス条件 — サードパーティクライアント、ボット、ミニアプリに公式に認められた限定的な例外でも、対象となるのは各機能の動作に不可欠なデータのみであり、引き続き規約、著作権、プライバシーに関するルールが適用されます。APIエンドポイントが存在するというだけでは、プラットフォームデータのスクレイピング、再販売、任意の再利用が許可されることにはなりません。 · 確認日
Telegramのprofileのパラメータはそれぞれどういう意味ですか？
公開Telegramチャンネルの規模を確認します。登録者数、写真・動画・リンクの件数、自己紹介、アバター、認証ステータスを取得できます。チャンネル名、@name、t.me/name、t.me/s/nameのいずれの形式でも指定できます。プライベートチャット、電話番号、メンバー名は取得できません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況username必須- 対象の公開チャンネルまたはグループを、name、@name、t.me/name、t.me/s/nameなどの形式で指定します。channel_postsとprofileでは公開チャンネルの指定に、groupでは公開エンティティのメタデータの取得に、membersでは表示可能なグループメンバーの取得に使用します。非公開の招待リンクには対応しておらず、メンバーリストの完全性は保証されません。Telegram公式：チャンネル、公開ユーザー名、閲覧数 — Telegramの公式ドキュメントでは、公開チャンネルと招待制のプライベートチャンネルを区別し、チャンネルはブロードキャスト用のツールであること、閲覧数には転送されたコピーも含まれ概算値であることを説明しています。これはチャンネルオブジェクトとview_countパラメータを説明するものですが、このエンドポイントがチャンネルの全履歴や非公開コンテンツを読み取れることを裏付けるものではありません。 · 確認日
Telegramのsearchのパラメータはそれぞれどういう意味ですか？
公開Telegramチャンネル全体から、キーワードでメッセージを検索します。各結果には、チャンネル名、種類、登録者数、閲覧数、リアクション、メディアが含まれます。sinceとuntilで期間を絞り込めます。プライベートチャットは検索対象外で、結果はTelegram全体を網羅するものではありません。
keyword必須- searchアクションで、公開チャンネル内のメッセージを検索するクエリを指定します。連絡先リストや非公開チャットは検索対象外です。Telegram公式：コンテンツのライセンスとAI利用の制限 — Telegramの公式規約では、プラットフォーム本来の通常の利用範囲を超えるコンテンツへのアクセスを制限し、AIモデルの学習、検証、改善、ベンチマーク、デプロイを目的としたプラットフォームデータのスクレイピングや集約を禁止しています。例外として認められるには、コンテンツごと、利用状況ごとに、関係するユーザーから明示的かつ継続的な同意を得る必要があります。公開されているからといって、一般的な利用ライセンスが与えられるわけではありません。 · 確認日
since任意- searchアクションで、メッセージの日付の下限を設定します。グループの作成日による絞り込みには使用されません。また、channel_postsには日付フィルターがありません。
until任意- searchアクションで、メッセージの日付の上限（beforeDate）を設定します。sinceと組み合わせて、公開メッセージの検索結果を絞り込みます。指定期間内のメッセージをすべて取得できることは保証されません。
Telegramのgroupのパラメータはそれぞれどういう意味ですか？
Telegramのグループやチャンネルの情報カードを取得します。タイトル、説明、メンバー数とオンライン数、作成日、詐欺・偽装・認証済みのフラグが含まれます。非公開の招待リンクには対応しておらず、グループへの参加や制限付きコンテンツの閲覧は行いません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況username必須- 対象の公開チャンネルまたはグループを、name、@name、t.me/name、t.me/s/nameなどの形式で指定します。channel_postsとprofileでは公開チャンネルの指定に、groupでは公開エンティティのメタデータの取得に、membersでは表示可能なグループメンバーの取得に使用します。非公開の招待リンクには対応しておらず、メンバーリストの完全性は保証されません。Telegram公式：グループ、ユーザー名、最終オンラインのプライバシー設定 — Telegramの公式ドキュメントでは、公開ユーザー名とt.meリンクについて詳しく説明し、最終オンラインのステータスは非表示にしたり、おおよその時間帯のみを表示するよう設定したりできるとしています。メンバーのlast_seen_atフィールドから正確なアクティビティ履歴を再構成することはできず、公開ユーザー名があっても公開された電話番号にアクセスできることを意味するものではありません。 · 確認日
Telegramのmembersのパラメータはそれぞれどういう意味ですか？
公開Telegramグループの表示可能なメンバーを、ユーザー名、名前、アカウント種別、Premium・詐欺・偽装のフラグ、最終接続時刻とともに一覧で取得します。一覧は一部のみの場合があり、電話番号はメンバーが公開している場合にのみ表示されます。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況username必須- 対象の公開チャンネルまたはグループを、name、@name、t.me/name、t.me/s/nameなどの形式で指定します。channel_postsとprofileでは公開チャンネルの指定に、groupでは公開エンティティのメタデータの取得に、membersでは表示可能なグループメンバーの取得に使用します。非公開の招待リンクには対応しておらず、メンバーリストの完全性は保証されません。Telegram公式：グループ、ユーザー名、最終オンラインのプライバシー設定 — Telegramの公式ドキュメントでは、公開ユーザー名とt.meリンクについて詳しく説明し、最終オンラインのステータスは非表示にしたり、おおよその時間帯のみを表示するよう設定したりできるとしています。メンバーのlast_seen_atフィールドから正確なアクティビティ履歴を再構成することはできず、公開ユーザー名があっても公開された電話番号にアクセスできることを意味するものではありません。 · 確認日Telegram公式：コンテンツへのアクセスに引き続き適用されるライセンス条件 — サードパーティクライアント、ボット、ミニアプリに公式に認められた限定的な例外でも、対象となるのは各機能の動作に不可欠なデータのみであり、引き続き規約、著作権、プライバシーに関するルールが適用されます。APIエンドポイントが存在するというだけでは、プラットフォームデータのスクレイピング、再販売、任意の再利用が許可されることにはなりません。 · 確認日
Telegramのpost_detailのパラメータはそれぞれどういう意味ですか？
公開Telegramチャンネルのメッセージ1件を、https://t.me/durov/520のようなリンクから読み取ります。テキスト、閲覧数、投稿日時、メディアの種類とリンク、投稿者の署名、転送元、返信先リンク、リンクプレビュー、リアクションとその数を取得できます。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況url必須post_detailで使用する、公開チャンネルの個別メッセージへのリンクです（https://t.me/<channel>/<message ID>）。t.me/s/形式のリンクも使用できます。
Telegram APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"telegram","action":"channel_posts","params":{"username":"<username>"}}'
Telegram APIに関する質問
Telegram APIでは何を取得できますか？
platformをtelegramに設定します。現在のカタログにはチャンネルの投稿、プロフィール、検索、グループ、メンバー、moreが掲載されています。これらのアクション名はそれぞれ異なるTelegramのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Telegramのchannel_postsリクエストを開始するには、どの入力を使用しますか？
対象の公開チャンネルまたはグループを、name、@name、t.me/name、t.me/s/nameなどの形式で指定します。channel_postsとprofileでは公開チャンネルの指定に、groupでは公開エンティティのメタデータの取得に、membersでは表示可能なグループメンバーの取得に使用します。非公開の招待リンクには対応しておらず、メンバーリストの完全性は保証されません。params内のusernameとして送信してください。
Telegramのchannel_postsはどのフィールドを返しますか？
宣言されたスキーマにはchannel_username、channel_title、text、view_countが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Telegramのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。