メインコンテンツへスキップ

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 オプションは、投稿を制御するために使用できるオプションフィールドです。
altText
array of strings
アクセシビリティとスクリーンリーダーを支援するための画像の代替テキスト。alt text 1 つあたり最大 1,000 文字。詳細については Alt Text を参照してください。
blockCountries
array of strings
特定の地域をブロックすることで、メディアを特定の国に制限します。国コード を使用します。allowCountries と一緒には使用できません。詳細については Geo Restrictions を参照してください。
allowCountries
array of strings
特定の地域を許可することで、メディアを特定の国に制限します。国コード を使用します。blockCountries と一緒には使用できません。詳細については Geo Restrictions を参照してください。
longPost
boolean
デフォルト:false
Premium ユーザー向けに、最大 25,000 文字の長い投稿の投稿を有効にします。詳細については Long Post を参照してください。
longVideo
boolean
デフォルト:false
承認済みアカウントで、2 分 20 秒より長い動画の投稿を許可します。詳細については Long Video を参照してください。
poll
object
カスタムオプションと期間で投票を実施します。必須フィールド: duration (分の数), options (文字列の配列)。詳細については Polls を参照してください。
quoteTweetId
string
Tweet ID を指定することで、別のツイートを引用します。詳細については Quote Tweet を参照してください。
replySettings
string
誰が投稿に返信できるかを制御します。値: following, mentioned, subscribers, または verified詳細については Reply Settings を参照してください。
subscribersOnly
boolean
デフォルト:false
投稿をサブスクライバーにのみ表示します。詳細については Subscribers Only を参照してください。
subTitleUrl
string
SRT ファイルを使用して動画に字幕/キャプションを追加します。有効な SRT ファイル URL で .srt で終わる必要があります。詳細については Subtitles / Captions for Videos を参照してください。
subTitleLanguage
string
デフォルト:"en"
字幕の言語。有効な 言語コード である必要があります。
subTitleName
string
キャプショントラックの名前。最大 150 文字。
thumbNail
string
動画のサムネイル(カバー画像)を設定します。JPEG、PNG、BMP、または WebP 画像ファイルへの URL である必要があります。詳細については Video Thumbnail を、画像の要件については X Media Guidelines を参照してください。
videoTitle
string
動画のタイトルを設定します。X Media Studio の title フィールドにマッピングされます。詳細については Video Metadata を参照してください。
videoDescription
string
動画の説明を設定します。X Media Studio の description フィールドにマッピングされます。詳細については Video Metadata を参照してください。
thread
boolean
デフォルト:false
長い投稿を、オプションの番号付けとメディア付きの連続したスレッドシリーズに分割します。詳細については Threads を参照してください。
threadNumber
boolean
デフォルト:false
1/n の形式で、スレッドの末尾に自動的に番号を追加します。thread: true が必要です。
mediaUrls
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

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

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 Thread

スレッドの投稿

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 用のエクスポートプリセットがあります。 Adobe Media Encoder その他の X API 例 はこちらを参照してください。

サブスクライバー限定

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

返信設定

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