Skip to main content

X BYO API キー

2026 年 3 月 31 日以降、すべての X/Twitter 操作には独自の API 認証情報が必要です。OAuth で X アカウントを連携した後、X を対象とするすべてのリクエストに次の 2 つのヘッダーを含めてください:まだ連携していませんか?X BYO キー設定ガイド を参照して X アカウントを接続してください。
Ayrshare は、X/Twitter の月次または日次のレート制限を独自に課すことはなくなりました。X リクエストは独自の認証情報 (BYO) を使用するため、使用状況は独自の X Developer App の制限によってのみ管理されます。詳細については X API rate limits ドキュメント を参照してください。

X (Twitter) への投稿

以前は Twitter API として知られていた X API を使用して、リンクと画像を含む基本的な投稿を行う JSON:
X Post
  • 画像や動画が含まれていない場合、X は自動的にツイート内のリンクをプレビューします。上記の例では画像が表示されます。画像を削除するとリンクプレビューが表示されます。
  • 動画が mp4 などの既知の動画拡張子で終わらない場合は、isVideo パラメーターを使用してください。詳細は /post エンドポイント を参照してください。
  • X は投稿テキストなしでメディアを送信することもサポートします。投稿テキストを含めない場合は、空の文字列 post: "" を送信します。
  • 1 つのツイートで最大 4 枚の画像または動画をアップロードできます。Twitter 動画の投稿 に関する重要なガイドラインと制限を必ずご確認ください。
  • 詳細は X Media GuidelinesX Authorization を参照してください。

X オプション

twitterOptions パラメーターを使用して、投稿に追加のオプションを設定できます。
X Options
X オプションは、投稿を制御するために使用できるオプションフィールドです。
array of strings
アクセシビリティとスクリーンリーダーを支援するための画像の代替テキスト。alt text 1 つあたり最大 1,000 文字。詳細については Alt Text を参照してください。
array of strings
特定の地域をブロックすることで、メディアを特定の国に制限します。国コード を使用します。allowCountries と一緒には使用できません。詳細については Geo Restrictions を参照してください。
array of strings
特定の地域を許可することで、メディアを特定の国に制限します。国コード を使用します。blockCountries と一緒には使用できません。詳細については Geo Restrictions を参照してください。
boolean
デフォルト:false
Premium ユーザー向けに、最大 25,000 文字の長い投稿の投稿を有効にします。詳細については Long Post を参照してください。
boolean
デフォルト:false
承認済みアカウントで、2 分 20 秒より長い動画の投稿を許可します。詳細については Long Video を参照してください。
object
カスタムオプションと期間で投票を実施します。必須フィールド: duration (分の数), options (文字列の配列)。詳細については Polls を参照してください。
string
Tweet ID を指定することで、別のツイートを引用します。詳細については Quote Tweet を参照してください。
string
誰が投稿に返信できるかを制御します。値: following, mentioned, subscribers, または verified詳細については Reply Settings を参照してください。
boolean
デフォルト:false
投稿をサブスクライバーにのみ表示します。詳細については Subscribers Only を参照してください。
boolean
デフォルト:false
投稿に AI 生成のメディアが含まれていることを開示するために、X の “Made with AI” ラベルを適用します。true"true" のいずれもラベルを適用します。それ以外の値ではラベルは適用されません。投稿は通常どおり公開され、レスポンスには理由を説明する warnings エントリが追加されます。
ラベルはメディアを含む投稿にのみ適用され、投稿後は変更できません。即時投稿、予約投稿、およびスレッド投稿に適用されます。
メディアタイプ: image, video詳細については Made with AI を参照してください。
string
SRT ファイルを使用して動画に字幕/キャプションを追加します。有効な SRT ファイル URL で .srt で終わる必要があります。詳細については Subtitles / Captions for Videos を参照してください。
string
デフォルト:"en"
字幕の言語。有効な 言語コード である必要があります。
string
キャプショントラックの名前。最大 150 文字。
string
動画のサムネイル(カバー画像)を設定します。JPEG、PNG、BMP、または WebP 画像ファイルへの URL である必要があります。詳細については Video Thumbnail を、画像の要件については X Media Guidelines を参照してください。
string
動画のタイトルを設定します。X Media Studio の title フィールドにマッピングされます。詳細については Video Metadata を参照してください。
string
動画の説明を設定します。X Media Studio の description フィールドにマッピングされます。詳細については Video Metadata を参照してください。
boolean
デフォルト:false
長い投稿を、オプションの番号付けとメディア付きの連続したスレッドシリーズに分割します。詳細については Threads を参照してください。
boolean
デフォルト:false
1/n の形式で、スレッドの末尾に自動的に番号を追加します。thread: true が必要です。
array of strings
スレッドにメディアオブジェクトを追加します。1 つのメディアオブジェクトが各スレッドに順に追加されます。特定のスレッドのメディアをスキップするには null を使用します。スレッドごとに複数のメディアを使用するには、複数の URL を持つオブジェクトを使用します。

Alt Text

ツイートの画像に代替テキスト(alt text とも呼ばれる)を追加します。X の alt text は、追加のユーザー情報とスクリーンリーダーに使用されるアクセシビリティ機能です。 twitterOptions オブジェクトの altText を使用します。
X Alt Text
各 alt text は mediaUrls 配列の画像に対応する必要があります。alt text は順番に各画像に適用されます。
alt text は動画には適用できません。altText 付きの mediaUrls に動画が含まれている場合、動画は投稿されません。alt text は 1,000 文字以下である必要があります。

地理的制限

blockCountriesallowCountries パラメーターに 国コード を指定することで、X のメディア(画像や動画など)を特定の国に制限できます。 投稿はすべての国で引き続き表示されますが、指定された国ではメディアが利用できません。
  • blockCountries: ブロックする国コードの配列。国コード を参照してください。
  • allowCountries: 許可する国コードの配列。国コード を参照してください。
blockCountries または allowCountries のいずれか 1 つのパラメーターのみを一度に使用する必要があります。 両方のパラメーターが使用されているか、国が X によってサポートされていない場合、地理的制限は無視されます。

長い投稿

Premium または Premium Plus など、Premium X アカウントを持つユーザーは、最大 25,000 文字の長い投稿を投稿する機能があります。Ayrshare は、Premium X アカウントを持つユーザーの長い投稿を自動的に許可します。 ユーザーが X Premium ステータスを変更した場合、Ayrshare に反映されるまで 24 時間お待ちください。ユーザーの Premium 購読ステータスは /user または /analytics エンドポイントで確認できます。 longPost ボディパラメーターで長い形式の投稿の受け入れを強制することもできます。これは、リクエストに次の JSON を含めることで実行できます:
X Long Post
ただし、Premium アカウントを持たないユーザーが長いツイートを投稿しようとすると、システムは code: 111 エラーを返します。

長い動画

Business または Enterprise プランが必要です。 X は動画の 最大動画長 を 2 分 20 秒に要求します。 ただし、ユーザーの X アカウントが Premium アカウントであるか Amplify Partner Program に参加しているなど、X から長い動画のアップロードを承認されている場合、10 分以上の動画を投稿できます。
longVideo パラメーターを使用する前に、ユーザーの X アカウントが Premium または Amplify Partner Program に参加していることを確認してください。ユーザーの X アカウントが長い動画の投稿を許可されていない場合、システムはエラーを返します。
長い動画を投稿する際は、longVideo twitterOptions パラメーターを使用します:
X Long Video

メンション

投稿テキストに @handle を追加することで、別の X ハンドルをメンションします。たとえば:
X Mention
メンションに関する 重要なルール をご確認ください。

投票

twitterOptionspoll パラメーターで X 投票を実施します。
X Poll
  • duration: 投票を実施する期間を指定する分数。
  • options: 投票オプションの文字列配列。

引用ツイート

低レベルの Tweet ID を指定することで、別のツイートを引用できます。ID は /post レスポンスの postIds フィールド、get history、またはツイート URL から直接取得できます: https://twitter.com/Ayrshare/status/1651601430669664256
X Quote Tweet

返信設定

投稿の返信設定を、特定のタイプのユーザーのみが返信できるように設定できます。
X Reply Settings
replySettings パラメーターは次のいずれかの値を取ります:
  • following: X アカウントがフォローしているユーザーのみが返信できます。
  • mentioned: 投稿でメンションされているユーザーのみが返信できます。
  • subscribers: 投稿を投稿した X アカウントのサブスクライバーのみが返信できます。
  • verified: X で認証済みのユーザーのみが投稿に返信できます。

サブスクライバー限定

subscribersOnly パラメーターを使用することで、投稿をサブスクライバーにのみ表示するように設定できます。
X Subscribers Only

Made with AI

投稿に AI 生成のメディアが含まれていることを開示するために、X ネイティブの “Made with AI” ラベルを適用します。twitterOptions オブジェクトの isAIGenerated フィールドを true に設定します。
X Made with AI

Accepted Values

boolean の true と文字列の "true" の両方でラベルが適用されます。false および "false" では適用されません。 それ以外の値、たとえば "yes"1 などでも適用されませんが、リクエストが失敗することはありません。 投稿は通常どおり公開され、レスポンスには受け入れられる値を列挙した warnings エントリが追加されます。
Ayrshare の MCP ServerisAIGenerated を厳密な boolean として受け取ります。 "true" ではなく true を渡してください。
ラベルはメディア(画像または動画)を含む投稿にのみ適用されます。テキストのみの投稿には影響せず、 投稿が公開された後は変更できません。
即時投稿、予約投稿、およびスレッド投稿に適用されます。予約投稿は、即時に投稿した場合と同じ “Made with AI” ラベルが付いた状態で公開されます。スレッドでは、メディアを含む各パートにラベルが付きます。

動画の字幕/キャプション

SRT ファイル を含めることで、動画に X の字幕(X キャプションとも呼ばれる)を追加できます。twitterOptions オブジェクトの subTitleUrl フィールドを使用して、SRT ファイルの URL を指定します。
X Subtitles
  • subTitleUrl: 有効な SRT ファイル。URL は https:// で始まり、.srt で終わる必要があり、有効な SRT ファイルである必要があります。
  • subTitleLanguage: オプション: 字幕の言語。有効な 言語コード である必要があります。デフォルト: “en”。
  • subTitleName: オプション: キャプショントラックの名前。名前は再生中にオプションとしてユーザーに表示されることを意図しています。サポートされる最大名前長は 150 文字です。デフォルト: “English”。

動画サムネイル

Twitter/X 動画のサムネイル(カバー画像)を設定します。サムネイルは動画が再生される前に表示され、ユーザーが動画の内容を理解するのに役立ちます。twitterOptions オブジェクトの thumbNail を使用します。
Twitter/X Video Thumbnail
  • “thumbNail”: サムネイル画像への URL。サポートされる画像形式は JPEG、PNG、BMP、WebP です。
  • サムネイル画像は動画の内容を表し、エンゲージメントを促すために視覚的に魅力的である必要があります。
  • 画像の要件については X Media Guidelines を参照してください。

動画メタデータ

X に投稿された動画のタイトルと説明を設定します。これらは X Media Studio のタイトルと説明フィールドにマッピングされます。twitterOptions オブジェクトの videoTitlevideoDescription フィールドを使用します。
X Video Metadata
  • videoTitle: 動画のタイトル。X Media Studio のタイトルフィールドにマッピングされます。
  • videoDescription: 動画の説明。X Media Studio の説明フィールドにマッピングされます。

動画収益化 (Pro Media)

Ayrshare は X の Pro Media プログラムを通じて、対象アカウントの X (Twitter) 動画収益化をサポートしています。これはアクセスが制限された機能です — アクセスをご希望の場合は お問い合わせ ください。

スレッド

X スレッド(tweetstorm とも呼ばれる)は X (旧 Twitter) の投稿の連続したシリーズで、単一の投稿の文字制限を超えた長いアイデアを共有でき、まとめて表示すると 1 つの連続したナラティブとして表示されます。

スレッドの投稿

X スレッドは API 経由で投稿できます。 スレッドは、一連の返信スレッドに分割され、X で線で関連付けられた投稿です。 自動的に投稿を分割することも、投稿テキストで スレッドの区切り を指定することもできます。
X Thread
  • thread: true を指定すると、改行に基づいて投稿テキストが自動的にスレッドに分割されます。
  • threadNumber: true を指定すると、スレッドの末尾に 1/n の形式で番号が自動的に追加されます。たとえば、5 つのスレッドのうち 2 番目には 2/5 が付加されます。
  • mediaUrls: [array of urls] を指定すると、各メディアオブジェクト(画像または動画)がスレッドに順に追加されます。1 つのメディアオブジェクトのみが順にスレッドに追加されます。
投稿が X スレッドとして送信された場合、返される投稿アナリティクスはツイートの配列 "twitter": [] になります。詳細については Post Analytics 200 Response を参照してください。

スレッドメディア

メディアをスキップする
配列内で null を使用することで、スレッドのメディアをスキップします。たとえば: ["https://site.com/image1.png", null, "https://site.com/image2.png"] これにより、最初のツイートには image1、2 番目のツイートには画像なし、3 番目のツイートには image2 が配置されます。
複数のメディア
mediaUrls 配列内にメディア URL を含むオブジェクト {} を追加することで、スレッド内のツイートに複数のメディアオブジェクトを追加できます。任意の一意のオブジェクトキーを使用できます。たとえば:
X Thread with Multiple Media URLs
この例では、最初のツイートには photo-1.jpg、2 番目のツイートには photo-2.jpg と photo-3.jpg、3 番目のツイートには photo-4.jpg が含まれます。

スレッドの区切り

Ayrshare は自動的に投稿テキストを適切な長さのツイート(> 280 文字)に分割します。 スレッドを作成する際、可能な限り 1 つの投稿に完全な文を維持することを優先します。 文が収まらない場合、文の間で分割します。 非常に長い文の場合、単語の間で分割します。 単語が長すぎる稀なケースでは、単語自体を分割します。 投稿テキストに \n\n を追加して、一意のスレッドを作成する必要があることを示すこともできます。 投稿テキストに \n\n がある場合、投稿は自動的にスレッドに分割されません。 たとえば:
Example X Thread
はスレッド内に 2 つのツイートを生成します。 段落を追加したいがツイートに分割したくない場合は、\u2063\n\u2063\n を使用します。
X Thread with Paragraphs
投稿が 280 文字未満のため、2 つの段落を持つ 1 つのツイートが生成されます。

スレッドの削除

Tweet Storm を削除するには、レスポンスで返されたトップレベルの投稿 ID を指定して /post delete エンドポイント を呼び出します。すべてのスレッドが削除されます。

文字数制限

詳細については X/Twitter Character Limits を参照してください。

X の動画互換性

一部の動画ソフトウェアは、X と互換性のない MP4 ファイルを作成します。たとえば、2019.0.9 より古い Camtasia バージョンでは、X が拒否する MP4 ファイルが作成されます。また、複数のオーディオトラックがあると、しばしば問題が発生します。 投稿中に次のメッセージが返された場合、動画が Twitter と互換性がなく、再エンコードする必要があることを示します。 "file is currently unsupported" 動画ソフトウェアの互換性を確認してください。たとえば、Adobe Media Encoder には Twitter 1080p Full HD 用のエクスポートプリセットがあります。 その他の X API 例 はこちらを参照してください。

サブスクライバー限定

subscribersOnly パラメーターを使用することで、投稿をサブスクライバーにのみ表示するように設定できます。
X Subscribers Only

返信設定

投稿の返信設定を、特定のタイプのユーザーのみが返信できるように設定できます。
X Reply Settings
replySettings パラメーターは次のいずれかの値を取ります:
  • following: X アカウントがフォローしているユーザーのみが返信できます。
  • mentioned: 投稿でメンションされているユーザーのみが返信できます。
  • subscribers: 投稿を投稿した X アカウントのサブスクライバーのみが返信できます。
  • verified: X で認証済みのユーザーのみが投稿に返信できます。