Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
まだ出力はありません。フォームを送信してコンテンツを生成してください。
透明な価格設定、隠れた手数料なし。使用量に応じてお支払い。
| ルールとモダリティ | Channel | クレジット | 価格（USD） | 公式/参考価格 | 1日の節約額 |
|---|---|---|---|---|---|
create-tweet otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql の完全ガイド
単一の統合エンドポイントを通じて、テキスト、メディア添付、返信、センシティブコンテンツフラグを完全にサポートし、認証済みの任意の X (Twitter) アカウントへプログラムからツイートを投稿できます。
ApiPass の Twitter Graphql Create Tweet API は、開発者が Twitter の公式デベロッパープログラムの承認プロセスを経ることなく、認証済みの Twitter/X アカウントに代わってツイートを投稿できる POST エンドポイント (/api/v1/jobs/createTask) です。ログイン済みの Twitter セッションから取得した auth_token cookie とツイートのペイロードを渡すことで、プレーンテキストのツイート投稿、最大 4 件のメディア添付、既存ツイートへの返信、メディア内のユーザータグ付け、セマンティックアノテーションの追加、コンテンツのセンシティブ可能性フラグ付けを行えます。この API は非同期で動作します。各リクエストは taskId を返し、recordInfo エンドポイントでポーリングするか、ツイートが正常に公開された時点で callback により受け取ることができます。
時間のかかる Twitter Developer Platform の申請、昇格アクセスの審査、エンタープライズティアの制限を回避できます。標準の auth_token cookie で認証し、すぐに投稿を開始できます。
ApiPass は複数のプロバイダー (starter, regular, official) を通じてリクエストをルーティングし、Twitter 公式の Basic (200/月) や Pro (5,000/月) ティアを大きく下回る価格で提供します。デフォルトの auto チャネルは、最も費用対効果が高く安定したプロバイダーをリアルタイムで自動選択します。
Twitter の Web クライアントが使用する内部 GraphQL mutation と同じ機能にアクセスできます。media_entities、tagged_users、semantic_annotation_ids、dark_request、古い REST エンドポイントでは公開されていない返信スレッド制御も含まれます。
すべてのツイート作成は taskId を返します。これをクエリするか callBackUrl 経由で受け取れるため、アプリケーションスレッドをブロックせず、耐障害性の高い大規模投稿パイプラインを簡単に構築できます。
認証は AuthToken によってリクエストごとに行われるため、1 つの API キーで無制限の Twitter アカウントを管理できます。代理店、ソーシャルメディア管理ツール、複数ブランドの投稿運用に最適です。
1 つの JSON ペイロードで、テキストのみのツイート、メディア付きツイート、返信、センシティブコンテンツ投稿に対応できます。multipart アップロード、個別のメディアエンドポイント、ツイート種別ごとに異なる認証フローを使い分ける必要はありません。
media.media_entities の media_id 参照を使って事前アップロード済みメディアを添付し、tagged_users で画像内のユーザーをタグ付けし、必要に応じてアップロードを possibly_sensitive としてマークできます。
reply.in_reply_to_tweet_id を使用して既存の会話に返信を投稿し、reply.exclude_reply_user_ids で返信通知チェーンから特定の参加者を選択的に除外できます。
auto、starter、regular、official チャネルから選択し、ワークロードに応じてコスト、安定性、速度のバランスを調整できます。超低コストの一括投稿から、本番環境向けの official ティア相当の信頼性まで対応します。
ユーザーが自分の X アカウントを接続し、複数のアカウントにまたがってツイート、スレッド、メディア投稿を同時に予約できる Buffer/Hootsuite 風のツールを構築できます。
LLM と組み合わせることで、ツイート、ニュース要約、市場アップデート、AI 生成画像をスケジュールに沿って、またはイベントに応じて自動生成・公開できます。
reply パラメータを使用して、ブランドの公式ハンドルに届いた顧客の @メンションやチケットに紐づくツイートへ応答するサポートボットを構築できます。
より広範な CMS やニュースルームのワークフローにおいて、単一の "publish" アクションから他のソーシャルネットワークと並行して Twitter へ配信する出力チャネルとして X を追加できます。
Twitter 公式の POST /2/tweets エンドポイントでは、有料の Developer Account、OAuth 2.0 アプリ設定が必要で、厳格なティア別レート制限が適用されます。一方、ApiPass は軽量な cookie ベースの認証モデルと従量課金で同じツイート公開機能を提供するため、統合を大幅に高速化し、スケール時のコスト効率を高められます。
Twitter 公式の POST /2/tweets エンドポイントでは、承認済みの Developer Account、OAuth 2.0 アプリ設定、厳格な月間投稿上限を伴う有料サブスクリプションティア ($200+/月) が必要です。ApiPass では、ログイン済みブラウザセッションから抽出した auth_token cookie (F12 → Application → Cookies → auth_token) と単一の Bearer API キーだけで利用できます。アプリ登録、OAuth callback URLs、ティア制限は不要です。
Twitter 公式 API は、利用量に関係なく固定のサブスクリプション料金を課し、ティア別の月間投稿制限 (Basic では 1,500/月、Pro では 300,000/月) を適用します。ApiPass は従量課金で成功したタスクごとに課金され、channel パラメータによりコストと安定性を調整できます。starter ティアは重要度の低いワークロードでは大幅に低コストで、official はネイティブ API と同等の料金と信頼性を提供します。
速報ニュース、価格アラート、気象警報、システムステータス更新を、監視パイプラインからブランドの X アカウントへリアルタイムに直接投稿できます。
AI 生成画像、要約、引用、スレッド形式の記事を毎日自動投稿し、手動作業なしでコンテンツ主導のアカウントを成長させることができます。
in_reply_to_tweet_id パラメータを使用して、メンションへの返信、引用ツイート、スレッドの続きへの対応を大規模に行い、キャンペーンボット、FAQ 応答ボット、コミュニティモデレーション用アカウントを実現できます。
多数のクライアントアカウントを管理する代理店は、リクエストごとに AuthToken を差し替えるだけで任意のアカウントへ投稿でき、すべてを 1 つの ApiPass キーで請求・ログ管理できます。
ApiPass に登録し、ダッシュボードから API キーを生成します。次に twitter.com を開き、投稿元にしたいアカウントにログインして、DevTools (F12) → Application → Storage → Cookies を開き、auth_token cookie の値をコピーします。このトークンにより、ApiPass はその特定のアカウントに代わって投稿できます。
Authorization ヘッダーに Bearer token として ApiPass API キーを設定し、https://api.apipass.dev/api/v1/jobs/createTask へ POST リクエストを送信します。JSON body では、model を twitter/graphql/create-tweet に設定し、input object 内に AuthToken を指定し、variables object に少なくとも tweet_text field を入力します。必要に応じて、画像や動画の添付用に media.media_entities、返信として投稿するために reply.in_reply_to_tweet_id、完了時に ApiPass からサーバーへ通知を受けたい場合は callBackUrl を含めます。レスポンスには、リクエストを追跡するために使用できる taskId が返されます。
初回リクエストで callBackUrl を指定してツイート公開時に通知を受け取るか、state が success を返すまで GET /api/v1/jobs/recordInfo?taskId={taskId} をポーリングします。resultJson field には公開済みツイートの詳細が含まれます。可能なタスク状態には waiting、queuing、generating、success、fail があり、デバッグ用に必要に応じて failCode と failMsg が返されます。
すべてのAPIはBearer Tokenによる認証が必要です。
Authorization: Bearer
ツイートを投稿します。
この API は、次の構造の JSON ペイロードを受け付けます。
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "AuthToken": "string",
7 "variables": {
8 "tweet_text": "string",
9 "dark_request": "boolean",
10 "media": {
11 "media_entities": "[]",
12 "possibly_sensitive": "boolean",
13 },
14 "reply": {
15 "in_reply_to_tweet_id": "string",
16 "exclude_reply_user_ids": "[]",
17 },
18 "semantic_annotation_ids": "[]",
19 "includePromotedContent": "boolean",
20 }
21 }
22}model必要string生成に使用するモデル名
"twitter/graphql/create-tweet"
callBackUrlオプションstringタスク完了通知用のコールバック URL。省略した場合、コールバックは送信されません。
"https://your-domain.com/api/callback"
channelオプションstringchannel パラメータを使用して、APIPASS 内の対応するプロバイダーを指定できます。これらのプロバイダーが実際の画像および動画生成タスクを処理します。APIPASS は現在、3 つのプロバイダーオプションを提供しています。
channel パラメータのデフォルト値は auto です。有効にすると、APIPASS はリアルタイムの価格と安定性指標に基づいて、利用可能なプロバイダー間でタスクを自動的に割り当て、最小コストと信頼性の高いパフォーマンスのバランスを取ります。カスタムルーティング要件がない限り、デフォルトの auto 値を維持してください。
利用可能なオプション：
auto
input オブジェクトには、次のパラメータが含まれます。
input.variables.tweet_text必要stringhello
input.variables.dark_requestオプションbooleanfalse
input.variables.media.media_entitiesオプションarray[]
input.variables.media.possibly_sensitiveオプションbooleanfalse
input.variables.semantic_annotation_idsオプションarray[]
input.variables.includePromotedContentオプションbooleanfalse
variables.reply.in_reply_to_tweet_idオプションstring123
variables.reply.exclude_reply_user_idsオプションstring[]
input.AuthToken必要stringTwitter のホームページを開いてログインし、F12 > Application > Storage > Cookies > auth_token に移動します。
YOUR_X_AUTH_TOKEN
1curl -X POST "https://api.apipass.dev/api/v1/jobs/createTask" \
2 -H "Content-Type: application/json" \
3 -H "Authorization: Bearer YOUR_API_KEY" \
4 -d '{
5 "model": "twitter/graphql/create-tweet",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "AuthToken": "YOUR_X_AUTH_TOKEN",
9 "variables": {
10 "tweet_text": "hello",
11 "dark_request": false,
12 "reply": {
13 "in_reply_to_tweet_id": "123",
14 "exclude_reply_user_ids": []
15 },
16 "media": {
17 "media_entities": [
18 {
19 "media_id": "1869610428579606520",
20 "tagged_users": []
21 }
22 ],
23 "possibly_sensitive": false
24 },
25 "semantic_annotation_ids": [],
26 "includePromotedContent": false
27 }
28 }
29 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}codeステータスコード。成功時は 200、その他は失敗を示します
messageレスポンスメッセージ。失敗時はエラーの説明が含まれます
data.taskIdタスクのステータスと結果を照会するためのタスク ID
