当社独自のアクセス統計は常に有効です。Google Analyticsは、公開ページ(ログイン後のワークスペースは対象外)の利用状況を把握するためのもので、許可をいただいた場合のみ有効になります。詳しくは プライバシーポリシーをご覧ください。

X (Twitter) API

キーワードやハンドルで投稿、ユーザープロフィール、会話の返信を検索し、議論の動向把握やコンテンツのキュレーションに活用できます。

キーワードで投稿を、ハンドルでユーザープロフィールを取得します。検索では、デフォルトでXの「話題」の結果が返されます。

プラットフォームの稼働状況

24時間の稼働状況
86%
利用可能

過去30日間

利用可能な機能

X (Twitter)の各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。

機能できること1,000リクエストあたり24時間の稼働状況
検索searchキーワードでツイートを検索し、JSONで取得します。各投稿には、本文、投稿者、フォロワー数、エンゲージメント数が含まれます。クエリにはfrom:やsince:などの演算子を使用できます。デフォルトでは上位の結果が先頭に表示されます。最新の投稿は厳密な時系列順にならない場合があります。1,000リクエストあたり$0.56良好・稼働状況100%
プロフィールprofileX(Twitter)のハンドルについて、プロフィール文、所在地、フォロワー数・フォロー数・投稿数、認証状況、アカウント作成日を確認します。ユーザー名は@の有無を問わず指定できますが、プロフィールURLは指定できません。結果は本人確認、現在の活動状況、オーディエンス構成を保証するものではありません。1,000リクエストあたり$0.56正常
ユーザーの投稿user_postsX(Twitter)アカウントの投稿を、各投稿のいいね数・リポスト数・返信数・表示回数と投稿日時とともに取得します。1回の取得ですべての投稿、返信、リポストが含まれるとは限りません。ダイレクトメッセージは一切含まれません。1,000リクエストあたり$0.56正常
投稿詳細postX(Twitter)の投稿1件を数値IDで取得し、全文、投稿者、投稿日時、いいね数・リポスト数・返信数・表示回数を返します。JavaScriptでの丸めを避けるためIDは文字列のまま扱い、完全なリンクは渡さないでください。1,000リクエストあたり$0.56正常
コメントcommentsX(Twitter)の投稿に付いた返信を収集します。各返信には本文、投稿者、投稿者のフォロワー数、その返信自体のエンゲージメント数が含まれます。元の投稿の数値IDをidに指定してください。会話全体が取得できるとは限りません。1,000リクエストあたり$0.56正常
トレンドtrendingX(Twitter)のトレンドを、順位、話題量、対象期間、取得日時とともに一覧表示します。地域はcountryで選択でき、デフォルトは全世界です。rankとvolumeはある時点での観測値であり、アルゴリズムや履歴を表すものではありません。1,000リクエストあたり$0.56正常
フォロワー一覧followers_listX(Twitter)アカウントのフォロワーから、そのアカウントのオーディエンスを把握します。各フォロワーには自己紹介、所在地、各種カウント、認証状態、非公開設定の有無が含まれます。リストはXが表示しているフォロワーが対象で、一部のみの場合があります。各行のカウントはそのフォロワー自身のものです。1,000リクエストあたり$0.56正常
フォロー一覧following_listX(Twitter)ユーザーがフォローしているアカウントを、それぞれの自己紹介、所在地、フォロワー数、投稿数、認証状態とともに取得します。フォロー関係はいつでも変わる可能性があり、親近感や交流を証明するものではありません。1,000リクエストあたり$0.56正常
メディア付き投稿user_mediausernameを指定して、X(Twitter)アカウントの「メディア」タブの投稿を一覧表示します。写真や動画を含む投稿が新しい順に並びます。各投稿には、本文、media、いいね数・リポスト数・返信数・表示回数、投稿日時、投稿者情報が含まれます。1ページあたり約12件で、件数は変動します。次のページはnext_page_tokenで取得します。1,000リクエストあたり$0.81正常
返信タブuser_repliesusernameを指定して、X(Twitter)アカウントの「返信」タブの投稿を新しい順に一覧表示します。各投稿には、本文、is_replyとreply_to_id、エンゲージメント数、ハッシュタグ、メンション、リンクが含まれます。返されるのはそのアカウント自身の投稿のみで、返信先の投稿は含まれません。1ページあたり約30件で、件数は変動します。次のページはnext_page_tokenで取得します。1,000リクエストあたり$0.81正常
リポストしたユーザーretweetersX(Twitter)の投稿1件を数値のidで指定し、その投稿をリポストしたアカウントを一覧表示します。各アカウントには、ユーザー名、名前、プロフィール文、フォロワー数・フォロー数・投稿数が含まれます。1ページあたり最大100件で、次のページはnext_page_tokenで取得します。一覧に含まれるのは、Xで現在も表示されているリポストのみです。1,000リクエストあたり$0.81正常
ユーザーID指定のプロフィールprofiles_by_idsuser_idsに数値のユーザーIDを指定し、X(Twitter)アカウントを最大20件まとめて検索します。各アカウントには、ユーザー名、表示名、プロフィールリンク、所在地、認証状況、非公開フラグ、アバター、作成日、account_statusが含まれます。プロフィール文とフォロワー数は含まれないため、必要な場合は返されたユーザー名でprofileを呼び出してください。1,000リクエストあたり$0.81正常
このアカウントについてuser_aboutusernameを指定して、X(Twitter)ユーザーの「このアカウントについて」ページを読み取ります。アカウントの所在国とその正確性、登録方法、ユーザー名の変更回数と最終変更日時、認証された時期を取得できます。所在国、登録元、最終変更は、Xに表示されている場合のみ含まれます。1,000リクエストあたり$0.81正常
フォロー確認check_followX(Twitter)のあるアカウントが、別のアカウントをフォローしているかを確認します。フォローしている可能性のあるアカウントをusernameに、確認対象のアカウントをtarget_usernameに指定すると、is_followingがtrueまたはfalseで返されます。結果は呼び出し時点の関係を反映します。1,000リクエストあたり$0.81正常
リポスト確認check_retweetX(Twitter)のアカウントが特定の投稿をリポストしたかを確認します。アカウントをusernameに、投稿の数値IDをidに指定すると、is_retweetedがtrueまたはfalseで返されます。結果は呼び出し時点でXに表示されているリポストを反映します。1,000リクエストあたり$0.81正常
コミュニティ詳細community_info数値のcommunity_idを指定して、X(Twitter)のコミュニティ1件の情報を取得します。名前、説明、トピック、メンバー数、NSFWフラグ、バナー、作成日、ルールが含まれます。1,000リクエストあたり$0.81正常
コミュニティ検索search_communitieskeywordでX(Twitter)のコミュニティを検索します。各コミュニティには、ID、リンク、名前、トピック、メンバー数、NSFWフラグ、バナーが含まれます。1ページあたり約10件で、次のページはnext_page_tokenで取得します。1,000リクエストあたり$0.81正常
ユーザー検索search_users「アカウント」タブと同様に、keywordでX(Twitter)のアカウントを検索します。ユーザー名、表示名、プロフィール文が検索対象です。各アカウントには、プロフィール文、アバター、フォロワー数・フォロー数・投稿数、認証状況、作成日が含まれます。1ページあたり約20件で、次のページはnext_page_tokenで取得します。投稿は返されません。1,000リクエストあたり$0.56正常
動画の文字起こしvideo_transcriptX(Twitter)の動画投稿の音声を、投稿リンクまたはIDから文字起こしします。投稿ID、リンク、textに格納された文字起こし全文、そのword_countが返されます。セグメントごとのタイムスタンプはありません。動画のない投稿や、発話のない動画では空の結果が返されます。1,000リクエストあたり$0.96正常
スレッドthreadX(Twitter)の投稿リンクを1件指定すると、その投稿者が投稿したスレッド全体を最初の投稿から最大100件まで取得します。各投稿には、本文、メディア、エンゲージメント数、投稿日時、投稿者情報が含まれます。他のアカウントからの返信は含まれません。1,000リクエストあたり$2.15正常
コミュニティ投稿community_posts数値のcommunity_idを指定して、X(Twitter)のコミュニティ1件の最新投稿を取得します。各投稿には本文、メディア、エンゲージメント数、投稿日時、投稿者のユーザー名と認証状態が含まれます。1ページあたり約20件で、next_page_tokenで次のページに進みます。1,000リクエストあたり$0.81正常

機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。

X (Twitter)の各アクションではどのような入力を指定できますか?

以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。

公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。

アクション必須任意提供方式上限1,000件あたりレスポンスフィールド
search

検索

キーワードでツイートを検索し、JSONで取得します。各投稿には、本文、投稿者、フォロワー数、エンゲージメント数が含まれます。クエリにはfrom:やsince:などの演算子を使用できます。デフォルトでは上位の結果が先頭に表示されます。最新の投稿は厳密な時系列順にならない場合があります。

keywordsortSync配信カタログ値:defaultLimit=25、maxLimit=200。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。1,000リクエストあたり$0.56id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_reply · is_quote · is_repost · is_pinned · reply_to_id · reply_to_user_id · reply_to · source · media · hashtags · mentions · links · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · platform
profile

プロフィール

X(Twitter)のハンドルについて、プロフィール文、所在地、フォロワー数・フォロー数・投稿数、認証状況、アカウント作成日を確認します。ユーザー名は@の有無を問わず指定できますが、プロフィールURLは指定できません。結果は本人確認、現在の活動状況、オーディエンス構成を保証するものではありません。

username—Sync配信—1,000リクエストあたり$0.56user_id · username · display_name · bio · url · follower_count · following_count · post_count · is_verified · location · avatar_url · created_at · platform
user_posts

ユーザーの投稿

X(Twitter)アカウントの投稿を、各投稿のいいね数・リポスト数・返信数・表示回数と投稿日時とともに取得します。1回の取得ですべての投稿、返信、リポストが含まれるとは限りません。ダイレクトメッセージは一切含まれません。

username—Sync配信カタログ値:defaultLimit=20、maxLimit=200。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。1,000リクエストあたり$0.56id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_reply · is_quote · is_repost · is_pinned · reply_to_id · reply_to_user_id · reply_to · source · media · hashtags · mentions · links · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · platform
post

投稿詳細

X(Twitter)の投稿1件を数値IDで取得し、全文、投稿者、投稿日時、いいね数・リポスト数・返信数・表示回数を返します。JavaScriptでの丸めを避けるためIDは文字列のまま扱い、完全なリンクは渡さないでください。

idtweet_idSync配信—1,000リクエストあたり$0.56id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_reply · is_quote · is_repost · is_pinned · reply_to_id · reply_to_user_id · reply_to · source · media · hashtags · mentions · links · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · platform
comments

コメント

X(Twitter)の投稿に付いた返信を収集します。各返信には本文、投稿者、投稿者のフォロワー数、その返信自体のエンゲージメント数が含まれます。元の投稿の数値IDをidに指定してください。会話全体が取得できるとは限りません。

idtweet_idSync配信カタログ値:defaultLimit=20、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。1,000リクエストあたり$0.56id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_reply · is_quote · is_repost · is_pinned · reply_to_id · reply_to_user_id · reply_to · source · media · hashtags · mentions · links · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · platform
trending

トレンド

X(Twitter)のトレンドを、順位、話題量、対象期間、取得日時とともに一覧表示します。地域はcountryで選択でき、デフォルトは全世界です。rankとvolumeはある時点での観測値であり、アルゴリズムや履歴を表すものではありません。

countrySync配信—1,000リクエストあたり$0.56id · name · rank · volume · period · collected_at · platform
followers_list

フォロワー一覧

X(Twitter)アカウントのフォロワーから、そのアカウントのオーディエンスを把握します。各フォロワーには自己紹介、所在地、各種カウント、認証状態、非公開設定の有無が含まれます。リストはXが表示しているフォロワーが対象で、一部のみの場合があります。各行のカウントはそのフォロワー自身のものです。

username—Sync配信カタログ値:defaultLimit=200、maxLimit=2000。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。1,000リクエストあたり$0.56id · username · url · name · text · location · avatar_url · follower_count · following_count · post_count · is_verified · is_protected · created_at · platform
following_list

フォロー一覧

X(Twitter)ユーザーがフォローしているアカウントを、それぞれの自己紹介、所在地、フォロワー数、投稿数、認証状態とともに取得します。フォロー関係はいつでも変わる可能性があり、親近感や交流を証明するものではありません。

username—Sync配信カタログ値:defaultLimit=200、maxLimit=2000。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。1,000リクエストあたり$0.56id · username · url · name · text · location · avatar_url · follower_count · following_count · post_count · is_verified · is_protected · created_at · platform
user_media

メディア付き投稿

usernameを指定して、X(Twitter)アカウントの「メディア」タブの投稿を一覧表示します。写真や動画を含む投稿が新しい順に並びます。各投稿には、本文、media、いいね数・リポスト数・返信数・表示回数、投稿日時、投稿者情報が含まれます。1ページあたり約12件で、件数は変動します。次のページはnext_page_tokenで取得します。

usernamepage_tokenSync配信1回の呼び出しで最大12行の1ページを返します。行数はページごとに異なるため、行数が少なくても最後のページとは限りません。次のページを取得するには、レスポンスのトップレベルにあるnext_page_tokenをpage_tokenとして渡し、next_page_tokenがなくなったら終了します。limitは指定できますが、効果はありません。1,000リクエストあたり$0.81next_page_token · id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_quote · is_repost · is_pinned · source · media · author_id · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · platform
user_replies

返信タブ

usernameを指定して、X(Twitter)アカウントの「返信」タブの投稿を新しい順に一覧表示します。各投稿には、本文、is_replyとreply_to_id、エンゲージメント数、ハッシュタグ、メンション、リンクが含まれます。返されるのはそのアカウント自身の投稿のみで、返信先の投稿は含まれません。1ページあたり約30件で、件数は変動します。次のページはnext_page_tokenで取得します。

usernamepage_tokenSync配信1回の呼び出しで最大30行の1ページを返します。行数はページごとに異なるため、行数が少なくても最後のページとは限りません。次のページを取得するには、レスポンスのトップレベルにあるnext_page_tokenをpage_tokenとして渡し、next_page_tokenがなくなったら終了します。limitは指定できますが、効果はありません。1,000リクエストあたり$0.81next_page_token · id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_reply · is_quote · is_repost · is_pinned · reply_to_id · media · hashtags · mentions · links · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · platform
retweeters

リポストしたユーザー

X(Twitter)の投稿1件を数値のidで指定し、その投稿をリポストしたアカウントを一覧表示します。各アカウントには、ユーザー名、名前、プロフィール文、フォロワー数・フォロー数・投稿数が含まれます。1ページあたり最大100件で、次のページはnext_page_tokenで取得します。一覧に含まれるのは、Xで現在も表示されているリポストのみです。

idpage_token, urlSync配信1回の呼び出しで最大100行の1ページを返します。行数はページごとに異なるため、行数が少なくても最後のページとは限りません。次のページを取得するには、レスポンスのトップレベルにあるnext_page_tokenをpage_tokenとして渡し、next_page_tokenがなくなったら終了します。limitは指定できますが、効果はありません。1,000リクエストあたり$0.81media_count · next_page_token · id · username · url · name · text · follower_count · following_count · post_count · platform
profiles_by_ids

ユーザーID指定のプロフィール

user_idsに数値のユーザーIDを指定し、X(Twitter)アカウントを最大20件まとめて検索します。各アカウントには、ユーザー名、表示名、プロフィールリンク、所在地、認証状況、非公開フラグ、アバター、作成日、account_statusが含まれます。プロフィール文とフォロワー数は含まれないため、必要な場合は返されたユーザー名でprofileを呼び出してください。

user_ids—Sync配信カタログ値:defaultLimit=20、maxLimit=20。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。1,000リクエストあたり$0.81user_id · username · display_name · url · location · is_verified · is_protected · affiliation · avatar_url · created_at · account_status · platform
user_about

このアカウントについて

usernameを指定して、X(Twitter)ユーザーの「このアカウントについて」ページを読み取ります。アカウントの所在国とその正確性、登録方法、ユーザー名の変更回数と最終変更日時、認証された時期を取得できます。所在国、登録元、最終変更は、Xに表示されている場合のみ含まれます。

username—Sync配信—1,000リクエストあたり$0.81user_id · username · display_name · url · account_based_in · is_location_accurate · signup_source · username_change_count · last_username_change_at · is_verified · verified_since · is_protected · affiliation · avatar_url · account_status · platform
check_follow

フォロー確認

X(Twitter)のあるアカウントが、別のアカウントをフォローしているかを確認します。フォローしている可能性のあるアカウントをusernameに、確認対象のアカウントをtarget_usernameに指定すると、is_followingがtrueまたはfalseで返されます。結果は呼び出し時点の関係を反映します。

username, target_username—Sync配信—1,000リクエストあたり$0.81username · target_username · is_following · platform
check_retweet

リポスト確認

X(Twitter)のアカウントが特定の投稿をリポストしたかを確認します。アカウントをusernameに、投稿の数値IDをidに指定すると、is_retweetedがtrueまたはfalseで返されます。結果は呼び出し時点でXに表示されているリポストを反映します。

username, idurlSync配信—1,000リクエストあたり$0.81username · post_id · is_retweeted · platform
community_info

コミュニティ詳細

数値のcommunity_idを指定して、X(Twitter)のコミュニティ1件の情報を取得します。名前、説明、トピック、メンバー数、NSFWフラグ、バナー、作成日、ルールが含まれます。

community_idurlSync配信—1,000リクエストあたり$0.81id · url · name · description · topic · member_count · is_nsfw · banner_url · created_at · rules · platform
search_communities

コミュニティ検索

keywordでX(Twitter)のコミュニティを検索します。各コミュニティには、ID、リンク、名前、トピック、メンバー数、NSFWフラグ、バナーが含まれます。1ページあたり約10件で、次のページはnext_page_tokenで取得します。

keywordpage_tokenSync配信1回の呼び出しで最大10行の1ページを返します。行数はページごとに異なるため、行数が少なくても最後のページとは限りません。次のページを取得するには、レスポンスのトップレベルにあるnext_page_tokenをpage_tokenとして渡し、next_page_tokenがなくなったら終了します。limitは指定できますが、効果はありません。1,000リクエストあたり$0.81id · url · name · topic · member_count · is_nsfw · banner_url · platform · next_page_token
search_users

ユーザー検索

「アカウント」タブと同様に、keywordでX(Twitter)のアカウントを検索します。ユーザー名、表示名、プロフィール文が検索対象です。各アカウントには、プロフィール文、アバター、フォロワー数・フォロー数・投稿数、認証状況、作成日が含まれます。1ページあたり約20件で、次のページはnext_page_tokenで取得します。投稿は返されません。

keywordpage_tokenSync配信1回の呼び出しで最大20行の1ページを返します。行数はページごとに異なるため、行数が少なくても最後のページとは限りません。次のページを取得するには、レスポンスのトップレベルにあるnext_page_tokenをpage_tokenとして渡し、next_page_tokenがなくなったら終了します。limitは指定できますが、効果はありません。1,000リクエストあたり$0.56next_page_token · id · username · url · name · text · avatar_url · follower_count · following_count · post_count · is_verified · created_at · platform
video_transcript

動画の文字起こし

X(Twitter)の動画投稿の音声を、投稿リンクまたはIDから文字起こしします。投稿ID、リンク、textに格納された文字起こし全文、そのword_countが返されます。セグメントごとのタイムスタンプはありません。動画のない投稿や、発話のない動画では空の結果が返されます。

urlidSync配信—1,000リクエストあたり$0.96id · url · text · word_count
thread

スレッド

X(Twitter)の投稿リンクを1件指定すると、その投稿者が投稿したスレッド全体を最初の投稿から最大100件まで取得します。各投稿には、本文、メディア、エンゲージメント数、投稿日時、投稿者情報が含まれます。他のアカウントからの返信は含まれません。

urlidSync配信カタログ値:defaultLimit=100、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。1,000リクエストあたり$2.15id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_reply · reply_to_id · source · media · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_created_at · author_banner_url · platform
community_posts

コミュニティ投稿

数値のcommunity_idを指定して、X(Twitter)のコミュニティ1件の最新投稿を取得します。各投稿には本文、メディア、エンゲージメント数、投稿日時、投稿者のユーザー名と認証状態が含まれます。1ページあたり約20件で、next_page_tokenで次のページに進みます。

community_idpage_token, urlSync配信1回の呼び出しで最大20行の1ページを返します。行数はページごとに異なるため、行数が少なくても最後のページとは限りません。次のページを取得するには、レスポンスのトップレベルにあるnext_page_tokenをpage_tokenとして渡し、next_page_tokenがなくなったら終了します。limitは指定できますが、効果はありません。1,000リクエストあたり$0.81next_page_token · id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · quote_count · language · is_quote · is_repost · is_pinned · source · media · author_id · author_is_verified · platform

X (Twitter)のsearchのパラメータはそれぞれどういう意味ですか?

キーワードでツイートを検索し、JSONで取得します。各投稿には、本文、投稿者、フォロワー数、エンゲージメント数が含まれます。クエリにはfrom:やsince:などの演算子を使用できます。デフォルトでは上位の結果が先頭に表示されます。最新の投稿は厳密な時系列順にならない場合があります。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
keyword必須
Xの投稿検索クエリ文字列です。from:やsince:などのプラットフォームの検索演算子を含めることができます。並び順についてはsortを参照してください。
sort任意
並び順の指定です。latestを指定すると、最新の投稿を先頭に返すよう要求します。Xはデフォルトで「話題」(Top)の結果を返します。また、latestを指定しても厳密な時系列順になるとは限りません。

X (Twitter)のprofileのパラメータはそれぞれどういう意味ですか?

X(Twitter)のハンドルについて、プロフィール文、所在地、フォロワー数・フォロー数・投稿数、認証状況、アカウント作成日を確認します。ユーザー名は@の有無を問わず指定できますが、プロフィールURLは指定できません。結果は本人確認、現在の活動状況、オーディエンス構成を保証するものではありません。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
username必須
Xのユーザー名です。先頭に@を付けることもできます。プロフィールの完全なURLは入力しないでください。profileは最近の投稿に含まれる投稿者情報からデータをまとめます。followers_listとfollowing_listは、それぞれ表示可能なフォロワーとフォロー中のアカウントを取得します。
X:ユーザー名(ハンドル)と表示名 — Xではユーザー名(ハンドル)と表示名を区別しています。ユーザー名は@付きの識別子とプロフィールリンクに使われ、変更すると元のユーザー名を他のユーザーが取得できる場合があります。アーカイブする際は、表示名や変更可能なユーザー名だけで本人確認をしないでください。 · 確認日

X (Twitter)のuser_postsのパラメータはそれぞれどういう意味ですか?

X(Twitter)アカウントの投稿を、各投稿のいいね数・リポスト数・返信数・表示回数と投稿日時とともに取得します。1回の取得ですべての投稿、返信、リポストが含まれるとは限りません。ダイレクトメッセージは一切含まれません。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
username必須
Xのユーザー名です。先頭に@を付けることもできます。プロフィールの完全なURLは入力しないでください。profileは最近の投稿に含まれる投稿者情報からデータをまとめます。followers_listとfollowing_listは、それぞれ表示可能なフォロワーとフォロー中のアカウントを取得します。
X:ユーザー名(ハンドル)と表示名 — Xではユーザー名(ハンドル)と表示名を区別しています。ユーザー名は@付きの識別子とプロフィールリンクに使われ、変更すると元のユーザー名を他のユーザーが取得できる場合があります。アーカイブする際は、表示名や変更可能なユーザー名だけで本人確認をしないでください。 · 確認日

X (Twitter)のpostのパラメータはそれぞれどういう意味ですか?

X(Twitter)の投稿1件を数値IDで取得し、全文、投稿者、投稿日時、いいね数・リポスト数・返信数・表示回数を返します。JavaScriptでの丸めを避けるためIDは文字列のまま扱い、完全なリンクは渡さないでください。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
id必須
postまたはcommentsで使用する数値の投稿IDで、x.com/username/status/に続く数字に当たります。JavaScriptで大きな整数の精度が失われないよう、文字列として保持することをおすすめします。idに完全なURLは指定しないでください。
X:表示回数はユニークユーザー数と同じではない — Xでは、同じ人が複数回閲覧した場合、それぞれが表示回数としてカウントされることがあり、表示回数が提供されていない投稿もあると説明しています。これは指標の定義を説明するもので、このエンドポイントが非公開のコンテンツや非公開のアナリティクスデータにアクセスできることを意味するものではありません。 · 確認日
tweet_id任意
idの互換用入力です。idより優先度が低く、公開仕様上の必須のidフィールドの代わりにはなりません。

X (Twitter)のcommentsのパラメータはそれぞれどういう意味ですか?

X(Twitter)の投稿に付いた返信を収集します。各返信には本文、投稿者、投稿者のフォロワー数、その返信自体のエンゲージメント数が含まれます。元の投稿の数値IDをidに指定してください。会話全体が取得できるとは限りません。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
id必須
postまたはcommentsで使用する数値の投稿IDで、x.com/username/status/に続く数字に当たります。JavaScriptで大きな整数の精度が失われないよう、文字列として保持することをおすすめします。idに完全なURLは指定しないでください。
X:元ポストのID、会話ID、返信の関係 — Xではconversation_idを使って会話の起点となった元ポストのIDを示し、階層の深い返信も同じ値を共有できます。親子関係を再構築するには親ポストの識別子が必要です。このエンドポイントはこうした関係のフィールドを公開していないため、公式の例にあるような返信ツリーは現在の出力では得られません。 · 確認日
tweet_id任意
idの互換用入力です。idより優先度が低く、公開仕様上の必須のidフィールドの代わりにはなりません。

X (Twitter)のtrendingのパラメータはそれぞれどういう意味ですか?

X(Twitter)のトレンドを、順位、話題量、対象期間、取得日時とともに一覧表示します。地域はcountryで選択でき、デフォルトは全世界です。rankとvolumeはある時点での観測値であり、アルゴリズムや履歴を表すものではありません。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況

X (Twitter)のfollowers_listのパラメータはそれぞれどういう意味ですか?

X(Twitter)アカウントのフォロワーから、そのアカウントのオーディエンスを把握します。各フォロワーには自己紹介、所在地、各種カウント、認証状態、非公開設定の有無が含まれます。リストはXが表示しているフォロワーが対象で、一部のみの場合があります。各行のカウントはそのフォロワー自身のものです。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
username必須
Xのユーザー名です。先頭に@を付けることもできます。プロフィールの完全なURLは入力しないでください。profileは最近の投稿に含まれる投稿者情報からデータをまとめます。followers_listとfollowing_listは、それぞれ表示可能なフォロワーとフォロー中のアカウントを取得します。
X:フォロワーとフォロー中の向き — Xでは、フォローは相互である必要がないため、あなたをフォローしているユーザーとあなたがフォローしているユーザーを分けて説明しています。非公開ポストには追加のアクセス制限があります。リストの取得は一括フォローのアクションではなく、アクセス権限の拡大を意味するものでもありません。 · 確認日

X (Twitter)のfollowing_listのパラメータはそれぞれどういう意味ですか?

X(Twitter)ユーザーがフォローしているアカウントを、それぞれの自己紹介、所在地、フォロワー数、投稿数、認証状態とともに取得します。フォロー関係はいつでも変わる可能性があり、親近感や交流を証明するものではありません。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
username必須
Xのユーザー名です。先頭に@を付けることもできます。プロフィールの完全なURLは入力しないでください。profileは最近の投稿に含まれる投稿者情報からデータをまとめます。followers_listとfollowing_listは、それぞれ表示可能なフォロワーとフォロー中のアカウントを取得します。
X:フォロワーとフォロー中の向き — Xでは、フォローは相互である必要がないため、あなたをフォローしているユーザーとあなたがフォローしているユーザーを分けて説明しています。非公開ポストには追加のアクセス制限があります。リストの取得は一括フォローのアクションではなく、アクセス権限の拡大を意味するものでもありません。 · 確認日

X (Twitter)のuser_mediaのパラメータはそれぞれどういう意味ですか?

usernameを指定して、X(Twitter)アカウントの「メディア」タブの投稿を一覧表示します。写真や動画を含む投稿が新しい順に並びます。各投稿には、本文、media、いいね数・リポスト数・返信数・表示回数、投稿日時、投稿者情報が含まれます。1ページあたり約12件で、件数は変動します。次のページはnext_page_tokenで取得します。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
username必須
写真や動画の投稿を取得するアカウントです(例:NASA)。先頭の@は削除されます。
page_token任意
user_media、user_replies、retweeters、search_communities、community_posts、search_usersで使用するページトークンです。最初のページでは省略し、以降は前のレスポンスのnext_page_tokenを受け取ったとおりそのまま渡します。最後のページには含まれません。

X (Twitter)のuser_repliesのパラメータはそれぞれどういう意味ですか?

usernameを指定して、X(Twitter)アカウントの「返信」タブの投稿を新しい順に一覧表示します。各投稿には、本文、is_replyとreply_to_id、エンゲージメント数、ハッシュタグ、メンション、リンクが含まれます。返されるのはそのアカウント自身の投稿のみで、返信先の投稿は含まれません。1ページあたり約30件で、件数は変動します。次のページはnext_page_tokenで取得します。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
username必須
返信を取得するアカウントです(例:NASA)。先頭の@は削除されます。
page_token任意
user_media、user_replies、retweeters、search_communities、community_posts、search_usersで使用するページトークンです。最初のページでは省略し、以降は前のレスポンスのnext_page_tokenを受け取ったとおりそのまま渡します。最後のページには含まれません。

X (Twitter)のretweetersのパラメータはそれぞれどういう意味ですか?

X(Twitter)の投稿1件を数値のidで指定し、その投稿をリポストしたアカウントを一覧表示します。各アカウントには、ユーザー名、名前、プロフィール文、フォロワー数・フォロー数・投稿数が含まれます。1ページあたり最大100件で、次のページはnext_page_tokenで取得します。一覧に含まれるのは、Xで現在も表示されているリポストのみです。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
id必須
投稿の数値IDで、リンク内の /status/ に続く数字です。文字列のまま指定してください。
page_token任意
user_media、user_replies、retweeters、search_communities、community_posts、search_usersで使用するページトークンです。最初のページでは省略し、以降は前のレスポンスのnext_page_tokenを受け取ったとおりそのまま渡します。最後のページには含まれません。
url任意
互換性のための入力で、投稿リンク https://x.com/<username>/status/<ID> を指定します。idが優先されます。

X (Twitter)のprofiles_by_idsのパラメータはそれぞれどういう意味ですか?

user_idsに数値のユーザーIDを指定し、X(Twitter)アカウントを最大20件まとめて検索します。各アカウントには、ユーザー名、表示名、プロフィールリンク、所在地、認証状況、非公開フラグ、アバター、作成日、account_statusが含まれます。プロフィール文とフォロワー数は含まれないため、必要な場合は返されたユーザー名でprofileを呼び出してください。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
user_ids必須
profiles_by_idsで使用するXの数値ユーザーIDです。1〜20件を、リストまたはカンマ区切りの文字列(44196397,11348282など)で指定します。

X (Twitter)のuser_aboutのパラメータはそれぞれどういう意味ですか?

usernameを指定して、X(Twitter)ユーザーの「このアカウントについて」ページを読み取ります。アカウントの所在国とその正確性、登録方法、ユーザー名の変更回数と最終変更日時、認証された時期を取得できます。所在国、登録元、最終変更は、Xに表示されている場合のみ含まれます。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
username必須
情報を取得するアカウントです(例:NASA)。先頭の@は削除されます。

X (Twitter)のcheck_followのパラメータはそれぞれどういう意味ですか?

X(Twitter)のあるアカウントが、別のアカウントをフォローしているかを確認します。フォローしている可能性のあるアカウントをusernameに、確認対象のアカウントをtarget_usernameに指定すると、is_followingがtrueまたはfalseで返されます。結果は呼び出し時点の関係を反映します。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
username必須
フォローしている可能性のあるアカウントです(例:NASA)。先頭の@は削除されます。
target_username必須
check_followで確認する相手のアカウントです。usernameがこのアカウントをフォローしているかを確認します。例:NASAHubble。先頭の@は取り除かれます。

X (Twitter)のcheck_retweetのパラメータはそれぞれどういう意味ですか?

X(Twitter)のアカウントが特定の投稿をリポストしたかを確認します。アカウントをusernameに、投稿の数値IDをidに指定すると、is_retweetedがtrueまたはfalseで返されます。結果は呼び出し時点でXに表示されているリポストを反映します。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
username必須
確認するアカウントです(例:NASA)。先頭の@は削除されます。
id必須
投稿の数値IDで、リンク内の /status/ に続く数字です。文字列のまま指定してください。
url任意
互換性のための入力で、投稿リンク https://x.com/<username>/status/<ID> を指定します。idが優先されます。

X (Twitter)のcommunity_infoのパラメータはそれぞれどういう意味ですか?

数値のcommunity_idを指定して、X(Twitter)のコミュニティ1件の情報を取得します。名前、説明、トピック、メンバー数、NSFWフラグ、バナー、作成日、ルールが含まれます。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
community_id必須
community_infoおよびcommunity_postsで使用する数値のコミュニティIDです。リンク内の/i/communities/に続く数字(1508567430188126209など)を指定します。
url任意
互換性のための入力で、コミュニティのリンク https://x.com/i/communities/<ID> を指定します。community_idが優先されます。

X (Twitter)のsearch_communitiesのパラメータはそれぞれどういう意味ですか?

keywordでX(Twitter)のコミュニティを検索します。各コミュニティには、ID、リンク、名前、トピック、メンバー数、NSFWフラグ、バナーが含まれます。1ページあたり約10件で、次のページはnext_page_tokenで取得します。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
keyword必須
コミュニティの名前やトピックを検索するキーワードです(例:crypto、photography)。
page_token任意
user_media、user_replies、retweeters、search_communities、community_posts、search_usersで使用するページトークンです。最初のページでは省略し、以降は前のレスポンスのnext_page_tokenを受け取ったとおりそのまま渡します。最後のページには含まれません。

X (Twitter)のsearch_usersのパラメータはそれぞれどういう意味ですか?

「アカウント」タブと同様に、keywordでX(Twitter)のアカウントを検索します。ユーザー名、表示名、プロフィール文が検索対象です。各アカウントには、プロフィール文、アバター、フォロワー数・フォロー数・投稿数、認証状況、作成日が含まれます。1ページあたり約20件で、次のページはnext_page_tokenで取得します。投稿は返されません。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
keyword必須
アカウントを検索するためのトピック、名前、またはユーザー名です(例:ai agents)。投稿ではなくアカウントを返します。
page_token任意
user_media、user_replies、retweeters、search_communities、community_posts、search_usersで使用するページトークンです。最初のページでは省略し、以降は前のレスポンスのnext_page_tokenを受け取ったとおりそのまま渡します。最後のページには含まれません。

X (Twitter)のvideo_transcriptのパラメータはそれぞれどういう意味ですか?

X(Twitter)の動画投稿の音声を、投稿リンクまたはIDから文字起こしします。投稿ID、リンク、textに格納された文字起こし全文、そのword_countが返されます。セグメントごとのタイムスタンプはありません。動画のない投稿や、発話のない動画では空の結果が返されます。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
url必須
動画投稿のリンク(https://x.com/<username>/status/<ID>)、または数値の投稿IDです。
id任意
互換性のための入力で、数値の投稿IDを指定します。urlが優先されます。

X (Twitter)のthreadのパラメータはそれぞれどういう意味ですか?

X(Twitter)の投稿リンクを1件指定すると、その投稿者が投稿したスレッド全体を最初の投稿から最大100件まで取得します。各投稿には、本文、メディア、エンゲージメント数、投稿日時、投稿者情報が含まれます。他のアカウントからの返信は含まれません。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
url必須
スレッド内の任意の投稿のリンク(https://x.com/<username>/status/<ID>)、または数値の投稿IDです。
id任意
互換性のための入力で、数値の投稿IDを指定します。urlが優先されます。

X (Twitter)のcommunity_postsのパラメータはそれぞれどういう意味ですか?

数値のcommunity_idを指定して、X(Twitter)のコミュニティ1件の最新投稿を取得します。各投稿には本文、メディア、エンゲージメント数、投稿日時、投稿者のユーザー名と認証状態が含まれます。1ページあたり約20件で、next_page_tokenで次のページに進みます。

完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況
community_id必須
community_infoおよびcommunity_postsで使用する数値のコミュニティIDです。リンク内の/i/communities/に続く数字(1508567430188126209など)を指定します。
page_token任意
user_media、user_replies、retweeters、search_communities、community_posts、search_usersで使用するページトークンです。最初のページでは省略し、以降は前のレスポンスのnext_page_tokenを受け取ったとおりそのまま渡します。最後のページには含まれません。
url任意
互換性のための入力で、コミュニティのリンク https://x.com/i/communities/<ID> を指定します。community_idが優先されます。

X (Twitter) APIの使い方

  1. 01公開カタログからプラットフォームのアクションを選択します。
  2. 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
  3. 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
  4. 04アプリケーションで必要なレスポンスフィールドを保存します。
twitter_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"twitter","action":"search","params":{"keyword":"<keyword>"}}'

X (Twitter)のガイド

これらのアクションを使った実践例と手法です。まずこのページで現在のアクション、パラメータ、フィールドを確認してください。記事内の例や制限は、最新のカタログに代わるものではありません。

Build

マルチプラットフォームの評判モニタリング設計:ネガティブな変化を評価する前に範囲を決める

監視対象リスト、コメントの識別子、増分カーソルを起点に、追跡可能な評判モニタリングのワークフローを設計します。オフラインのサンプルで重複排除と取り込み漏れを示しつつ、人によるレビューを維持します。

記事を読む
Build

統合データAPI入門:機能カタログから最初の有効な結果を得るまで

platform、action、paramsで複数プラットフォームのデータにアクセスします。機能カタログの読み方、最小限のリクエストの送信、非同期タスク・部分的な結果・課金の扱い方、追跡可能なデータ記録の作り方を解説します。

記事を読む

X (Twitter) APIに関する質問

X (Twitter) APIでは何を取得できますか?

platformをtwitterに設定します。現在のカタログには検索、プロフィール、ユーザーの投稿、投稿詳細、コメント、moreが掲載されています。これらのアクション名はそれぞれ異なるX (Twitter)のオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。

X (Twitter)に公式APIはありますか?

はい。X API v2は、X Developer Consoleを通じてどの開発者でも利用できます。2026年2月以降は従量課金制で、クレジットを購入してリソースごとに支払います。たとえば投稿の読み取りごとに$0.005、ユーザーの読み取りごとに$0.010で、Enterpriseプランが必要になるまでの上限は月間3百万件の投稿読み取りです(2026年10月時点の公表価格)。

公式情報源: X APIの料金 · X API:アクセス方法 · 確認日

X (Twitter)の開発者アカウントやAPIキーは必要ですか?

いいえ、不要です。リクエストはEveryInfraのAPIキーを使ってEveryInfra経由で送信します。新規登録後、コンソールでキーを作成し、Authorization: Bearer <API_KEY>として送信してください。X (Twitter)の開発者アプリの登録、X (Twitter) APIへのアクセス申請、X (Twitter)アカウントでのログインは必要ありません。また、アクションが返すのはX (Twitter)の公開データのみです。

X (Twitter) APIの料金は1,000リクエストあたりいくらですか?

アクションに応じて1,000リクエストあたり$0.56から、各アクションの料金は、このページの表と公開カタログに記載されています。サブスクリプションはなく、USD残高をチャージして呼び出しごとに料金を支払います。失敗した呼び出しや結果が空の場合は課金されません。

X (Twitter)のsearchリクエストを開始するには、どの入力を使用しますか?

Xの投稿検索クエリ文字列です。from:やsince:などのプラットフォームの検索演算子を含めることができます。並び順についてはsortを参照してください。params内のkeywordとして送信してください。

X (Twitter)のsearchはどのフィールドを返しますか?

宣言されたスキーマにはtext、like_count、retweet_count、reply_countが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。

X (Twitter)のアクションはすべて即座に結果を返しますか?

非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。