独自のX APIキーを設定する

2026年3月31日、Xはサードパーティプラットフォームによる自社APIへのアクセス方法を変更しました。その結果、Ayrshare経由でXに投稿するすべてのAyrshareアカウントは、独自のX Developer Appを登録し、そのAPI KeyとAPI Secretをすべてのリクエストで使用する必要があります。これは、すべてのサードパーティツールに影響を与えるXによって義務付けられたプラットフォーム全体の変更です。

BYOキーはプラットフォームごとに一度設定されるだけです(アカウント全体)。顧客ごとやサブプロファイルごとではありません。 自分のXアカウントで1つのX Developer Appを作成し、同じAPI Key + API SecretがXのアカウント全体に適用されます — これらはAyrshareアカウント下でXをリンクするすべてのサブプロファイル/エンドユーザーに使用されます。数百のサブプロファイルを持つBusinessプランまたはEnterpriseプランをお持ちの場合、各プロファイルに対してこのセットアップを繰り返す必要はありません。Xプラットフォームに対して一度セットアップし、すべてのリクエストで同じ2つのヘッダーを渡します。

このセットアッププロセスを可能な限り簡単にするため、合理化されており、完了までに10分もかかりません。以下のステップバイステップガイドに従ってください。途中でヘルプが必要な場合は、私たちのチームがサポートいたします。

ステップ1: X Developerアカウントを作成する

Developer Consoleにサインイン

console.x.comにアクセスし、Xアカウントでサインインします。ヘルプが必要な場合はXの入門ガイドをご覧ください。

オンボーディングを完了する

デベロッパーオンボーディングを完了し、デベロッパー契約とポリシーに同意します。

コンソールにアクセスする

これでX Developer Consoleに入りました。

ステップ2: Appを作成する

Ayrshareアカウントごとに1つのX Developer Appのみを作成します。同じAppとそのAPI Key + API Secretは、後でAyrshareアカウント下にリンクするすべてのサブプロファイル/エンドユーザーに再利用されます。顧客ごとに新しいAppを作成することはありません。

Appsへ移動

Developer Consoleで、Appsに移動します。

Appを作成する

Appダッシュボードで、Create Appをクリックします(詳細についてはXのApp設定ドキュメントをご覧ください)。App名(通常はブランド名)を入力します。この名前は、ユーザーがXアカウントを接続する際にOAuth認証画面に表示されます。

Create App button in the X Developer Console

環境を選択する

ドロップダウンでProduction環境を選択します。

初期資格情報ポップアップを閉じる

Xはいくつかの資格情報を生成します。これらの資格情報を無視して、このウィンドウを閉じてください。

ステップ3: Appのパーミッションを設定する

App設定を開く

「Apps」の下で、新しいAppを見つけて(表示されない場合はページを更新)、クリックして詳細を表示します。

App details page in the X Developer Console

User authentication settingsの下で、Set upをクリックします。

User authentication settings, click Set up

Appパーミッションを設定する

App permissionsで、Read and write and Direct messageを選択します。これは投稿やDMを含む完全な機能サポートに必要です。

App permissions set to Read and write and Direct message

Appタイプを設定する

Type of Appで、Web App, Automated App or Botを選択します。これは、Ayrshareのようなサーバー側統合に最適な選択です。

Type of App set to Web App, Automated App or Bot

コールバックおよびウェブサイトURLを設定する

App infoの下で:

Callback URL: 以下の両方のコールバックURLを追加します:
- https://profile.ayrshare.com/social-accounts
- https://app.ayrshare.com/social-accounts
Website URL: https://app.ayrshare.com

このステップをスキップしないでください。 これらのコールバックURLは、OAuthリンクフローに必要です。エンドユーザーがX接続を承認すると、Xはリンクプロセスを完了するために、これらのURLの1つにリダイレクトします。これらが欠落している場合、OAuthフローは403 Callback URL not approvedエラーで失敗します。

App info form with callback URL and website URL filled in

設定を保存する

Saveをクリックします。OAuth 1.0キーのうち2つ(API KeyとAPI Secret)のみを使用するので、OAuth 2.0ポップアップは無視できます。

重要: リンク前にパーミッションを設定してください。 ここで選択するパーミッションによって、Appができることが決まります。OAuth経由でXアカウントをリンクした後にパーミッションを変更した場合、新しいAccess Tokenが更新されたパーミッションを継承するように、再リンクする必要があります。

Keys and tokens page showing OAuth 1.0 keys with permission level

これら2つのキーを必ず保管してください:

API Key(別名Consumer Key、X App識別子)
API Secret(別名Consumer Secret)

Access Tokenを手動で生成する必要はありません。OAuth経由でXアカウントをリンクすると、Ayrshareが自動的にこれを処理します。

ステップ4: X APIクレジットを購入する

Xは現在、デベロッパーコンソール経由で購入するクレジットベースのAPI課金を使用しています。

請求先へ移動

Developer Consoleの左サイドバーでBilling → Creditsをクリックします。

Billing Credits page in X Developer Console

クレジットを購入する

クレジットを購入します(最小限は$5で、数百のAPIコールに十分です)。各APIコールは1セントのわずかな端数なので、ほとんどのユーザーにとって費用は最小限に抑えられるはずです。

Credit purchase page in the X Developer Console

自動チャージを有効にする

サービス中断を回避するために自動チャージを有効にし、請求サイクルで使用できる最大額を設定して支出上限を管理できます。

Auto-recharge and spend cap settings in X Developer Console

クレジットがないとAPIコールは失敗します。 XのAPIはpay-per-useです。クレジット残高がゼロの場合、すべてのAPIリクエストは、“Your enrolled account does not have any credits to fulfill this request.”というメッセージとともに402 CreditsDepletedエラーを返します。これには投稿、ツイートの読み取り、ユーザールックアップが含まれます。統合をテストする前にクレジットをロードしてください。Xの価格に関する完全な更新については、X APIの価格の仕組みを参照してください。

ステップ5: Ayrshare API呼び出しを更新する

ステップ3で、これら2つのアイテムを独自の環境、設定、またはシークレットマネージャーに安全に保存しました:

API Key(別名Consumer Key、X App識別子)
API Secret(別名Consumer Secret)

次に、Ayrshare API呼び出しのヘッダーにX資格情報を追加します。

あなたのキーはプライベートに保たれます。 API KeyとAPI SecretはAyrshareによって保存されません。

ヘッダーリファレンス

ヘッダー	値
`X-Twitter-OAuth1-Api-Key`	API Key (Consumer Key)
`X-Twitter-OAuth1-Api-Secret`	API Key Secret (Consumer Secret)

パーミッションが間違っているかどうかを確認する方法:

Appのパーミッションが誤って設定されている場合、APIリクエストは”Your client app is not configured with the appropriate OAuth1 app permissions.”というメッセージとともに403 Forbiddenエラーを返す場合があります。

このエラーが表示された場合は、X Developer ConsoleでAppのパーミッションをRead and write and Direct messageに更新し、新しいAccess Tokenが更新されたパーミッションを継承するようOAuth経由でXアカウントを再リンクしてください。

コード例

curl -X POST https://api.ayrshare.com/api/post \
  -H "Authorization: Bearer YOUR_AYRSHARE_API_KEY" \
  -H "X-Twitter-OAuth1-Api-Key: your_api_key" \
  -H "X-Twitter-OAuth1-Api-Secret: your_api_secret" \
  -H "Content-Type: application/json" \
  -d '{"post": "Hello from my own X App!", "platforms": ["twitter"]}'

const response = await fetch("https://api.ayrshare.com/api/post", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_AYRSHARE_API_KEY",
    "Content-Type": "application/json",
    "X-Twitter-OAuth1-Api-Key": process.env.X_API_KEY,
    "X-Twitter-OAuth1-Api-Secret": process.env.X_API_SECRET,
  },
  body: JSON.stringify({
    post: "Hello from my own X App!",
    platforms: ["twitter"],
  }),
});

import os
import requests

headers = {
    "Authorization": "Bearer YOUR_AYRSHARE_API_KEY",
    "Content-Type": "application/json",
    "X-Twitter-OAuth1-Api-Key": os.environ["X_API_KEY"],
    "X-Twitter-OAuth1-Api-Secret": os.environ["X_API_SECRET"],
}

response = requests.post(
    "https://api.ayrshare.com/api/post",
    headers=headers,
    json={"post": "Hello from my own X App!", "platforms": ["twitter"]},
)

XをターゲットとするすべてのリクエストにAPI KeyとAPI Secretヘッダーを含めていれば、既存の自動化やワークフローは引き続き動作します。

既存プロファイルの移行(BusinessおよびEnterprise)

Ayrshare経由ですでにXにリンクされているサブプロファイルがある場合、BYOキーに切り替えた後、それらのプロファイルはXアカウントを再リンクする必要があります。これは、既存のアクセストークンがAyrshareのX Appで発行されており、あなたのコンシューマーキーで使用できないためです(OAuth 1.0a署名はトークンを発行したAppに紐付けられています)。

generateJWTにキーを含める

generateJWT呼び出しボディにtwitterApiKeyとtwitterApiSecretを追加します。これらはJWTに埋め込まれる前に暗号化され、エンドユーザーに公開されることはありません。

{
  "domain": "your-domain",
  "profileKey": "...",
  "privateKey": "...",
  "twitterApiKey": "YOUR_X_CONSUMER_KEY",
  "twitterApiSecret": "YOUR_X_CONSUMER_SECRET"
}

これは、あなたのコンシューマーキーがボディに入る唯一のリクエストです。その他のすべてのXリクエストは、上記のヘッダーを使用します。

ユーザーにXを再リンクしてもらう

キーを含めてJWTを生成した後、ユーザーはプロファイルリンクページからXアカウントを再接続する必要があります。OAuth同意画面には、Ayrshareの代わりにあなたのApp名が表示されます。これを合理化するには:

Unlink API経由でアカウントをプログラム的にリンク解除してから、ユーザーに再認証してもらう
generateJWTでlogoutパラメータを使用して新しいログインを強制する
移行フロー中にリンクページでXのみを表示するにはallowedSocialを使用する

すべてのAPIコールでヘッダーを送信し続ける

再リンク後、すべてのAPIコール(投稿、分析、コメントなど)でX-Twitter-OAuth1-Api-KeyとX-Twitter-OAuth1-Api-Secretヘッダーを含め続けてください。

プロファイルがX Appの下で再リンクされると、そのプロファイルの後続のすべての投稿はあなたの資格情報を使用します。これは、X Developer ConsoleのUsageページを確認することで確認できます。

セットアップを確認する

新しいヘッダーを使用してAyrshare API経由でテストコールを行い、すべてが機能していることを確認してください。/analytics/socialエンドポイントは、投稿を作成しないため、良い軽量なテストです。

X APIの価格の仕組み

以前は、AyrshareがXのAPI使用料をあなたに代わってカバーしていました。Xの現在のモデルでは、各AyrshareカスタマーがそれぞれのX Developerアカウントを維持し、アプリケーションが行うAPIリクエストに対してXに直接支払います。(Ayrshareアカウントごとに1つのX Developerアカウントで、エンドユーザーごとではありません。すべてのサブプロファイルが同じX Developerアカウントとクレジット残高を共有します。) Xの価格モデルはpay-per-useです: X Developer Consoleでクレジットを購入し、APIリクエストが行われるにつれて差し引かれます。契約やサブスクリプションは不要です。一般的な操作は安価です。たとえば:

操作	おおよそのコスト
投稿の作成(テキストのみ)	投稿あたり約$0.01
メディア付き投稿の作成	投稿あたり約$0.02(メディアアップロードと投稿作成は別々のリクエストです)
投稿の読み取り	読み取りあたり約$0.005
ユーザールックアップ	ルックアップあたり約$0.01
DMの送信	メッセージあたり約$0.01
DMイベントの読み取り	イベントあたり約$0.01
ユーザーインタラクション(フォロー、いいねなど)	リクエストあたり約$0.015

参考までに、月に約100回投稿する場合、Xへの直接コストはおよそ$1、メディア付き投稿は月におよそ$2になります。

Xのpay-per-use価格は現在パイロットフェーズにあります。料金は変更される可能性があり、追加コストが導入される場合があります。最新の価格については、常にDeveloper Consoleを確認してください。Xの価格情報の内訳を参照してください。

これまでに存在しなかったコストが発生することを認識しており、それについて透明性を保ちたいと考えています。同時に、このモデルは以前の共有キーセットアップでは不可能だったいくつかの利点も解放します。

独自のX APIキーを使用する利点

独自のX API資格情報を使用することで、以前の共有キーモデルよりも制御性と信頼性が向上します。これには次のものが含まれます:

ブランド化されたOAuthエクスペリエンス: ユーザーはXアクセスを承認する際、あなたのApp名とブランディングを目にします。
専用のレート制限: あなたのAPI使用量は、他のAyrshareユーザーとは別に、あなた自身のX Developerアカウント制限によって管理されます。使用状況はX Developer Consoleで監視でき、X APIレート制限ドキュメントを参照できます。
資格情報の制御: あなたのAPI KeyとSecretは、独自のX Developerアカウントに保管されます。Ayrshareはあなたのシークレットキーを保管しません。
可搬性: ユーザーはあなたのX Appで認証するため、統合は完全にあなたの管理下に保たれます。
使用量の可視化: あなたのX Developerダッシュボードは、APIリクエスト、レート制限、クレジット使用量を表示します。

Xはこのモデルを必要とする最初のプラットフォームですが、より多くのプラットフォームが「独自のAPIキーを持参する」方向に移行しています。この機能をAyrshare全体に拡張しているため、開発者はすべてのソーシャルプラットフォームで同じ制御と独立性を持つことができます。

セキュリティ

あなたのAPI KeyとAPI SecretはAyrshareによって保管されません。
一般的なセキュリティのベストプラクティスについては、Xの認証セキュリティガイドをご覧ください。

FAQ

顧客/サブプロファイルごとにこれをセットアップする必要がありますか?

いいえ。 独自のXアカウントで1つのX Developer Appをセットアップし、同じAPI Key + API Secretが、Ayrshareアカウント下にリンクするすべてのサブプロファイル/エンドユーザーに再利用されます。

X Developer Appを一度作成します。
呼び出しがどのサブプロファイルのものであっても、すべてのAyrshare API呼び出しで同じ2つのヘッダー(X-Twitter-OAuth1-Api-KeyとX-Twitter-OAuth1-Api-Secret)を渡します。
エンドユーザーは、独自のXアカウントを承認するためにOAuthリンクフローを個別に通過しますが、独自のX Developer AppやAPIキーは必要ありません。彼らはあなたのAppを通じて接続します。
すべてのサブプロファイルは、同じX Developerアカウント、同じレート制限、同じクレジット残高を共有します。

キーをプロファイルごとに処理するのは、移行中のgenerateJWTボディだけです。これはまだあなたの同じ2つのキーですが、エンドユーザーがあなたのAppで再承認できるように、リンクページに配信されます。

X APIキー要件は現在有効ですか?

はい。2026年3月31日以降、Ayrshare経由でのすべてのX操作には独自のX API資格情報が必要です。まだX Developerアカウントをセットアップしていない場合は、上記の手順に従ってください。

AyrshareにX APIキーを追加しないとどうなりますか?

Ayrshare経由でXに投稿するには、独自のX API資格情報が必要です。有効なBYO資格情報のないリクエストは拒否されます。他のプラットフォーム(Instagram、LinkedIn、Facebook、TikTokなど)への投稿は影響を受けません。

X APIはいくらかかりますか?

XはAPIコールごとに課金します。投稿の作成には約$0.01、投稿の読み取りには約$0.005かかります。たとえば、月に100件の投稿を公開するには、およそ$1かかります。詳細については、Xの価格ページをご覧ください。

これによりAyrshareのサブスクリプション価格は変わりますか?

いいえ。Ayrshareのサブスクリプション価格は変わりません。追加コストは、あなたのデベロッパーアカウント経由でXから直接請求されるX API使用料のみです。

AyrshareはX API資格情報を保管しますか?

いいえ。あなたのAPI KeyとAPI SecretはAyrshareによって保管されません。一般的なセキュリティのベストプラクティスについては、Xの認証セキュリティガイドをご覧ください。

X Developerアカウントを既に持っています。既存のキーを使用できますか?

はい。「Read and write」パーミッションが有効になっていれば、既存のX Appを使用できます(DM機能を使用する場合は Direct Messagesも)。X Developer ConsoleのKeys and tokensセクションからAPI Key (Consumer Key)とAPI Secret (Consumer Secret)が必要です。OAuth経由でXアカウントをリンクし、Ayrshare APIリクエストにこれら2つのヘッダーを含めます。初回セットアップからAppパーミッションを変更した場合、新しいAccess Tokenが更新されたパーミッションを継承するように、Xアカウントを再リンクしてください。

X Developer Portalには多くの資格情報が表示されます。実際に必要なのはどれですか?

API Key (Consumer Key)とAPI Secret (Consumer Secret)が必要です。それぞれがどのAyrshareヘッダーにマップされるかについては、上記のヘッダーリファレンステーブルを参照してください。Client ID、Client Secret、Bearer Token、Access Token、Access Token Secretは無視できます。

「API Key」と「Client ID」の違いは何ですか?

これらは異なる認証方法用の完全に異なる資格情報です:

API Key(「Consumer Key」とも呼ばれます)はOAuth 1.0a用です。AyrshareはAPI Key (Consumer Key) + API Secretを使用します。すべてのX機能で動作し、トークンは期限切れにならず、更新ロジックは不要です。
Client IDはOAuth 2.0用です。Ayrshareにはこれは必要ありません。OAuth 2.0トークンは短期間後に期限切れになり、リフレッシュトークン管理が必要です。

Ayrshareでは、API KeyとAPI Secretだけが必要です。Client ID、Client Secret、Bearer Tokenは無視できます。

なぜOAuth 2.0ではなくOAuth 1.0aなのか?

OAuth 2.0アクセストークンは2時間ごとに期限切れになり、Xのリフレッシュトークンはシングルユース(各リフレッシュで古いトークンが無効化される)です。これにより、特にスケジュールされた投稿の場合、ステートレスBYOモデルをサポートすることは不可能になります。OAuth 1.0aトークンは期限切れにならず、すべてのX機能で動作し、トークン管理は不要です。

既存のユーザーはXアカウントを再リンクする必要がありますか?

はい。ユーザーがBYOキーをセットアップする前にAyrshare経由でXをリンクした場合、再接続が必要です。既存のアクセストークンはAyrshareのX Appで発行されており、あなたのコンシューマーキーでは動作しません。ステップバイステップのプロセスについては、上記の既存プロファイルの移行を参照してください。

この変更はInstagram、LinkedIn、その他のプラットフォームへの投稿に影響しますか?

いいえ。この変更はXへの投稿にのみ影響します。Ayrshareの他のすべてのプラットフォーム統合は通常どおり動作し続けます。

RSS/フィード自動投稿からXへは?

XへのRSS自動投稿はサポートされなくなりました。RSSフィードはスケジュールに基づいて自動的に実行されますが、bring-your-own APIキーモデルでは各APIリクエストで資格情報を提供する必要があります。このため、RSSフィードは投稿送信時に認証できません。以前RSSを使用してXに投稿していた場合は、スケジュールされた投稿、または資格情報を含む直接APIコールに切り替えることをお勧めします。他のすべてのプラットフォームへのRSS自動投稿は変更されません。

なぜ402「CreditsDepleted」エラーが発生するのですか?

これは、X Developerアカウントに利用可能なAPIクレジットがないことを意味します。console.x.com → Billing → Creditsに移動して、クレジットを購入してください。$5でも数百のAPIコールに十分です。クレジットがロードされたら、リクエストを再試行してください。

なぜ403「Forbidden: OAuth1 App Permissions」エラーが発生するのですか?

Access Tokenに適切なパーミッションがありません。これは通常、次の2つのうち1つを意味します:

Appパーミッションが「Read and write」ではなく「Read」に設定されています。 Developer ConsoleのAppの設定に移動し、Read and write and Direct messageに変更してください。
Xアカウントをリンクした後にパーミッションを変更しました。 Access Tokenは作成時のパーミッションを保持します。新しいトークンが更新されたパーミッションを継承するように、OAuth経由でXアカウントを再リンクしてください。

セットアップにヘルプが必要な場合はどうすればよいですか?

私たちのサポートチームは喜んでお手伝いします。セットアップ中に質問がある場合や問題が発生した場合は、support@ayrshare.comまでご連絡ください。プロセスをご案内します。

トラブルシューティング

ヘッダーが欠落している400エラーが発生しています

次の必須ヘッダー両方を送信していることを確認してください:

X-Twitter-OAuth1-Api-Key
X-Twitter-OAuth1-Api-Secret

ペア不一致エラー(例:「You provided Api-Key but not Api-Secret」)が表示される場合、2つのうち1つが欠落していることを意味します。両方とも常に必須です。エラーメッセージには、どの特定のヘッダーが欠落しているかが記載されます。

Xアカウントをリンクしようとしたときにこのエラーが表示される場合は、X Developer Appの設定(Authentication settings > Callback URI / Redirect URLの下)に必要なコールバックURLが追加されていることを確認してください:

https://profile.ayrshare.com/social-accounts
https://app.ayrshare.com/social-accounts

上記のコールバックURL設定ステップを参照してください。

X Developerアカウントにロードされたクレジットがありません。console.x.com → Billing → Creditsに移動して、クレジットを購入してください。$5でも数百のAPIコールに十分です。

Access Tokenに適切なパーミッションがありません。これは通常次を意味します:

Appパーミッションが「Read and write」ではなく「Read」に設定されています。 Developer ConsoleのAppの設定に移動し、Read and write and Direct messageに変更してください。
Xアカウントをリンクした後にパーミッションを変更しました。 Access Tokenは作成時のパーミッションを保持します。新しいトークンが更新されたパーミッションを継承するように、OAuth経由でXアカウントを再リンクしてください。

ヘルプが必要ですか?

X APIキーのセットアップ中に質問がある場合や問題が発生した場合は、エンジニアリングチームが喜んでお手伝いします。support@ayrshare.comまでいつでもお問い合わせください。

Get Started

API Endpoints

Multiple Users

Dashboard

Additional

ステップ1: X Developerアカウントを作成する

ステップ2: Appを作成する

ステップ3: Appのパーミッションを設定する

ステップ4: X APIクレジットを購入する

ステップ5: Ayrshare API呼び出しを更新する

ヘッダーリファレンス

コード例

既存プロファイルの移行(BusinessおよびEnterprise)

セットアップを確認する

X APIの価格の仕組み

独自のX APIキーを使用する利点

セキュリティ

FAQ

トラブルシューティング

ヘルプが必要ですか?

​ステップ1: X Developerアカウントを作成する

​ステップ2: Appを作成する

​ステップ3: Appのパーミッションを設定する

​ステップ4: X APIクレジットを購入する

​ステップ5: Ayrshare API呼び出しを更新する

​ヘッダーリファレンス

​コード例

​既存プロファイルの移行(BusinessおよびEnterprise)

​セットアップを確認する

​X APIの価格の仕組み

​独自のX APIキーを使用する利点

​セキュリティ

​FAQ

​トラブルシューティング

​ヘルプが必要ですか?

ステップ1: X Developerアカウントを作成する

ステップ2: Appを作成する

ステップ3: Appのパーミッションを設定する

ステップ4: X APIクレジットを購入する

ステップ5: Ayrshare API呼び出しを更新する

ヘッダーリファレンス

コード例

既存プロファイルの移行(BusinessおよびEnterprise)

セットアップを確認する

X APIの価格の仕組み

独自のX APIキーを使用する利点

セキュリティ

FAQ

トラブルシューティング

ヘルプが必要ですか?