コンテンツにスキップ
Twexapi
日本語
English简体中文日本語Español한국어FrançaisTürkçe
Esc
↑↓移動↵開く⌘Jプレビュー
このページの内容

Twitter API 料金表と機能概要：スクレイピング・ツイート取得・Bot作成のための完全ガイド

Twitter (X) API の料金表、スクレイピング手法、ツイート取得、フォロワー抽出、Bot作成のための完全日本語リファレンス。月額固定費なし・リクエスト従量課金。

TwexAPI は https://api.twexapi.io にて標準的な RESTful API を提供し、X/Twitter のデータ読み取り、ツイート投稿・エンゲージメント書き込み、高度な検索、ユーザープロフィールとソーシャルグラフのエクスポート、DM 送受信、トレンド取得、X 記事処理、コミュニティ管理などを網羅しています。

本ページは 日本語 API リファレンスハブ として、主要なエンドポイントの機能概要、重要な入力パラメータ、認証要件、および各詳細ページへのリンクを体系的にまとめています。

ベース URL

https://api.twexapi.io

Twitter API 料金体系と有料化の代替案 (Pricing & Alternatives)

公式 X (Twitter) API の従量課金化以降、多くの開発者が1リソース単位の細かな課金（ツイート1件 $0.005、フォロワー1件 $0.01、リンク付き投稿 $0.20）という隠れコストに直面しています。TwexAPI は**月額基本料金 0 円・リクエスト従量課金制（1リクエストあたり $0.000050〜）**を採用しており、無駄なコストをかけずに必要な分だけ利用可能です。

  • 公開データの読み取りは完全 Cookie 不要: ツイート検索、プロフィール取得、フォロワー一覧、リプライ収集などの読み取り操作は、**Twitter アカウントやログイン Cookie なし（API キーのみ）**で安全に実行できます。アカウント凍結（BAN）のリスクがありません。
  • 安心の従量課金: 失敗したリクエストは課金されません。大規模なデータスクレイピングやバッチ分析でもコストを極限まで抑えられます。

ユースケース別おすすめエンドポイント (Use Cases & Solutions)

日本の開発者やマーケターが直面する代表的なユースケースと、推奨エンドポイントの対応一覧です：

ユースケース / 検索意図 推奨エンドポイント 必要認証 特徴とメリット
ツイッター スクレイピング (免ログイン・免Cookie) POST /twitter/advanced_search/page
GET /twitter/{screen_name}/about
POST /v2/tweet/detail		 API キーのみ アカウント凍結リスクなしで、公開ツイート・ユーザープロフィールを安全に収集。自作スクレイパー vs TwexAPI および Nitter 代替案 を参照。
コスト効率の高い X API 代替 (X API Alternative) 料金表と課金体系ガイド API キーのみ 公式のリソース別課金（$0.005/件）やリンク投稿手数料（$0.20/件）を回避。1リクエストあたり $0.000050〜 の完全従量課金。詳細は TwexAPI vs 公式 X API 徹底比較 を参照。
ツイート高度検索 (キーワード・期間・いいね数指定) POST /twitter/advanced_search/page API キーのみ キーワード、投稿者、日付範囲、最低いいね数などの検索演算子を組み合わせ、カーソルページネーションで大量抽出。
競合アカウントのフォロワー抽出・分析 POST /v3/twitter/users/followers API キーのみ 競合他社やインフルエンサーのフォロワー一覧を大量エクスポートし、ソーシャルグラフや属性分析に活用。
ツイートへのリプライ一覧・返信ツリー取得 POST /twitter/tweets/{tweet_id}/replies/page API キーのみ バズった投稿のリプライ欄を漏れなくカーソル取得し、VOC（顧客の声）分析やセンチメント分析に利用。
ツイートスレッド一括展開 (Thread Unroll) POST /twitter/tweets/thread_by_id API キーのみ 連投スレッド（Thread）を 1 回のリクエストで順序正しく結合し、長文テキストとして復元。
X 長文記事 (Articles) の Markdown 抽出 (AI/RAG) GET /x/article/{tweet_id}/markdown API キーのみ X の長文記事（Articles）を整形済み Markdown として抽出し、LLM ナレッジベースへ即座に投入。
ツイッター ボット作成・自動投稿 (Bot 作成) POST /twitter/tweets/create
POST /v3/twitter/tweets/create-thread		 API キー + Cookie 自動ツイート投稿やスレッド一括投稿。メディア画像（最大4枚）や動画の自動添付にも対応。
twitter トレンド api (日本・各国のトレンド取得) GET /twitter/global-trending/tweets API キーのみ 日本国内（Japan）や各国のリアルタイム急上昇ツイートおよびトレンドトピックを取得。
AI 開発アシスタント (Cursor / Claude Code / MCP) TwexAPI MCP サーバー API キーのみ Cursor や Claude Code に MCP 連携を設定し、AI が自律的に X データを検索・分析。

認証メカニズム

すべての API リクエストには、HTTP ヘッダーに有効な API キーを含める必要があります。

Authorization: Bearer YOUR_API_KEY
  • 読み取り専用エンドポイント (Read): Authorization: Bearer YOUR_API_KEY のみで実行可能です（完全 Cookie 不要）。
  • 書き込みエンドポイント (Write / BYOC): ツイート投稿、返信、いいね、リツイート、フォロー、DM 送信などの操作は、完全な BYOC (Bring Your Own Cookie) モデルで動作します。ユーザー自身が承認したアカウントの Twitter Cookie または auth_token をリクエスト時に指定し、完全なステートレスプロキシとして実行されます。資格情報はサーバー上に一切保存されません。詳細は 認証・セキュリティガイド を参照してください。

統一レスポンス形式

成功時のレスポンスは一貫した JSON 構造を返します。

{
  "code": 200,
  "msg": "success",
  "data": {}
}

クライアント側でのリクエスト成功判定は、必ず HTTP ステータスコードが 2xx であること を基準にしてください。エラー発生時の復旧手順は エラーハンドリングガイド を参照してください。

カーソルページネーション (Cursor Pagination)

リスト取得や検索系エンドポイントでは、data 内に has_next_page や next_cursor が返されます。次のページを読み出す際は、前回取得したカーソル値をそのままリクエストパラメータに指定してください。エラー再試行時は、データのスキップを防ぐため必ず同じカーソルを再試行してください。

アカウント残高とクレジット確認

大規模なデータ抽出や定期バッチ処理の前に、残高確認エンドポイントで利用可能額を確認することをおすすめします。

curl --request GET \
  --url 'https://api.twexapi.io/balance' \
  --header 'Authorization: Bearer YOUR_API_KEY'

主要エンドポイント日本語クイックリファレンス

各エンドポイント名をクリックすると、パラメータスキーマおよびオンラインテスト実行画面へ遷移します。

エンドポイント メソッドとパス 機能説明 主要パラメータ 認証要件
カーソルページネーション検索 POST /twitter/advanced_search/page カーソル方式による大量ツイートのストリーミング取得用検索エンドポイント。 cursor (前回のカーソル)
searchTerms (検索語)		 API キーのみ
ハッシュタグ検索 POST /twitter/hashtags トレンドのハッシュタグ（#AI、#Crypto など）に特化したツイート収集。 keyword (タグ文字列)
cursor (任意カーソル)		 API キーのみ
キャッシュタグ銘柄検索 POST /twitter/cashtags 金融・暗号資産ティッカーシンボル（$BTC、$TSLA など）に特化した高速検索。 keyword (ティッカーコード) API キーのみ

2. ツイート詳細・スレッド・エンゲージメント (Tweets & Engagement)

エンドポイント メソッドとパス 機能説明 主要パラメータ 認証要件
ツイートスレッド全件取得 POST /twitter/tweets/thread_by_id 指定したツイート ID から、同一投稿者による連続スレッド（Thread）を一括取得。 tweet_id (ツイート ID) API キーのみ
ツイート詳細データ取得 (v2) POST /v2/tweet/detail いいね数、リツイート数、インプレッション数、メディア情報を含むメタデータを取得。 tweet_id (ツイート ID) API キーのみ
ID 指定の一括ツイート取得 POST /twitter/tweets/lookup 複数のツイート ID を配列で渡し、まとめて構造化データを取得。 tweet_ids (ID 配列) API キーのみ
リプライ一覧ページネーション取得 POST /twitter/tweets/{tweet_id}/replies/page 対象ツイートに対するリプライ（返信ツリー）をカーソルページネーションで取得。 tweet_id (ツイート ID)
cursor (カーソル)		 API キーのみ
いいねしたユーザー一覧 POST /twitter/tweets-favoriters 指定ツイートに「いいね」を付けたユーザーアカウント情報を取得。 tweet_id (ツイート ID) API キーのみ

3. プロフィールと関係グラフ (Users & Followers)

エンドポイント メソッドとパス 機能説明 主要パラメータ 認証要件
ユーザー公開プロフィール取得 GET /twitter/{screen_name}/about ユーザー名から Bio、フォロワー数、フォロー数、認証バッジ、アイコン画像などを取得。 screen_name (ユーザー名、@ なし) API キーのみ
複数ユーザーの一括取得 POST /twitter/users 複数のスクリーン名を一括で送信し、各ユーザーのプロフィールをまとめて取得。 usernames (ユーザー名配列) API キーのみ
フォロワーリスト (v3 カーソル版) POST /v3/twitter/users/followers カーソル方式により、大規模なフォロワー一覧を安定してエクスポート。 user_id または screen_name
cursor (カーソル)		 API キーのみ
フォロー中リスト (v3 カーソル版) POST /v3/twitter/users/following 指定アカウントがフォローしているユーザーリストを取得。 user_id または screen_name
cursor (カーソル)		 API キーのみ
ユーザータイムライン POST /twitter/{screen_name}/timeline/page 指定ユーザーの過去の投稿およびリツイートを時系列順に取得。 screen_name (ユーザー名)
cursor (カーソル)		 API キーのみ

4. 投稿・エンゲージメント書き込み (Tweet Actions & Writes)

エンドポイント メソッドとパス 機能説明 主要パラメータ 認証要件
ツイート投稿・返信作成 POST /twitter/tweets/create ツイートの新規作成または返信。最大 4 枚の画像または 1 つの MP4 動画添付に対応。 tweet_content (本文)
reply_tweet_id (任意返信先 ID)
media_urls (メディア)		 API キー + Cookie
連続スレッドの一括投稿 POST /v3/twitter/tweets/create-thread 本文の配列を送信し、自動でリプライを繋げてスレッド（Thread）を一括作成。 tweets (本文とメディアの配列) API キー + Cookie
いいね POST /twitter/tweets/{tweet_id}/like 対象アカウントで指定のツイートに「いいね」を実行。 tweet_id (ツイート ID) API キー + Cookie
いいね解除 DELETE /twitter/tweets/{tweet_id}/like 過去に付けた「いいね」を取り消し。 tweet_id (ツイート ID) API キー + Cookie
リツイート POST /twitter/tweets/{tweet_id}/retweet 対象ツイートをご自身のアカウントでリツイート。 tweet_id (ツイート ID) API キー + Cookie
ブックマーク登録 POST /twitter/tweets/{tweet_id}/bookmark 指定ツイートを非公開ブックマークに保存。 tweet_id (ツイート ID) API キー + Cookie
ユーザーのフォロー POST /twitter/user/follow 指定したアカウントをフォロー。 user_id または screen_name API キー + Cookie
プロフィールの更新 POST /twitter/profile アカウントの自己紹介文（Bio）、アイコン画像、ヘッダーバナー画像を一括更新。 description (Bio)
image_url (アイコン)
banner_url (ヘッダー)		 API キー + Cookie

5. ダイレクトメッセージ管理 (Direct Messages - DM)

エンドポイント メソッドとパス 機能説明 主要パラメータ 認証要件
DM 送信 (v3) POST /v3/twitter/send-dm 指定ユーザーに 1 対 1 のダイレクトメッセージを送信（テキストおよびメディア添付）。 recipient_id (受信者 ID)
text (メッセージ本文)
media_url (メディア)		 API キー + Cookie
DM 受信権限の確認 POST /v2/dm/status 送信前に、対象ユーザーが未フォローからの DM 受信を許可しているかを確認。 recipient_id (受信者 ID) API キー + Cookie
DM 会話スレッド一覧 POST /v3/twitter/conversations アカウントに存在するすべての DM 会話スレッドと最新メッセージを取得。 cursor (カーソル) API キー + Cookie
会話履歴の取得 POST /v3/twitter/dm/history 指定したスレッド内のチャット履歴メッセージを取得。 conversation_id (会話 ID)
max_id (ページネーション)		 API キー + Cookie
エンドポイント メソッドとパス 機能説明 主要パラメータ 認証要件
グローバルトレンドツイート GET /twitter/global-trending/tweets 世界各国または特定リージョンで話題のバズツイートを取得。 country (国名、例: japan)
topic (トピックカテゴリ)
count (取得件数)		 API キーのみ
対応国一覧 GET /twitter/global-trending/countries トレンド取得をサポートしている国・地域の一覧を取得。 なし API キーのみ
話題トピック一覧 GET /twitter/global-trending/topics トレンド分類（technology、sports、entertainment など）のカテゴリ一覧を取得。 なし API キーのみ

7. X 記事と Markdown 抽出 (Articles)

エンドポイント メソッドとパス 機能説明 主要パラメータ 認証要件
X 記事の Markdown 抽出 GET /x/article/{tweet_id}/markdown X の長文記事（Articles）を整形された Markdown 形式で取得。LLM の RAG 用ナレッジ取り込みに最適。 tweet_id (記事ツイート ID) API キーのみ
長文記事の下書き作成 POST /x/articles/draft [ステップ 1/5] X 長文記事の下書きを作成し、自動投稿フローを開始。 title (タイトル)
blocks (本文段落構造)		 API キー + Cookie
ワンストップ長文投稿 POST /x/articles/publish 下書き作成から本文流し込み、カバー設定、即時公開までを一括実行。 title (タイトル)
content (本文)
cover_image (カバー)		 API キー + Cookie

8. アカウント・ユーティリティ (Cookie & Balance)

エンドポイント メソッドとパス 機能説明 主要パラメータ 認証要件
auth_token から Cookie 変換 GET /twitter/{auth_token}/cookie ブラウザから取得した単一の auth_token 文字列から、必要な完全な Cookie 形式を取得。 auth_token (Twitter トークン) API キーのみ
残高と利用状況照会 GET /balance API キーの残りクレジット、プラン状態をリアルタイム照会。 なし API キーのみ

連携方式とアーキテクチャ選定

連携方式 推奨ユースケース
MCP サーバー Cursor、Claude Code、LangChain などで自律型 AI エージェントを構築する際に最適。explore で動的に探索し、twexapi_request で実行。
公式多言語 SDK 本番アプリケーション開発向け。TypeScript、Python、Go、Java、C#、Kotlin、Ruby、PHP に対応し、型定義とリトライを標準装備。
CLI ツール ターミナル操作、シェルスクリプト自動化、JSON Lines ファイルによるデータエクスポート向け。
フレームワーク別ガイド LangChain、CrewAI、Pydantic AI、n8n、Zapier、Make、Prefect 向けの接続レシピ。

主要運用ガイド

このページは役に立ちましたか？