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

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

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

## ベース URL

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

---

## 認証メカニズム

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

```bash
Authorization: Bearer YOUR_API_KEY
```

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

## 統一レスポンス形式

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

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

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

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

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

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

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

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

---

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

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

### 1. ツイート検索・高度検索 (Search)

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

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

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

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

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

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

:::warning
  書き込み操作は外部プラットフォームへの不可逆なアクションです。リクエストパラメータに有効な Cookie を含め、AI エージェントワークフローでは事前確認ステップを設けてください。詳細は を参照してください。
:::

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

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

| エンドポイント | メソッドとパス | 機能説明 | 主要パラメータ | 認証要件 |
| :--- | :--- | :--- | :--- | :--- |
| **[DM 送信 (v3)](/api-reference/dm-endpoints/send-dm-v3-api-v3-twitter-send-dm-post)** | `POST /v3/twitter/send-dm` | 指定ユーザーに 1 対 1 のダイレクトメッセージを送信（テキストおよびメディア添付）。 | `recipient_id` (受信者 ID)<br/>`text` (メッセージ本文)<br/>`media_url` (メディア) | API キー + Cookie |
| **[DM 受信権限の確認](/api-reference/dm-endpoints/dm-status-api-v2-v2-dm-status-post)** | `POST /v2/dm/status` | 送信前に、対象ユーザーが未フォローからの DM 受信を許可しているかを確認。 | `recipient_id` (受信者 ID) | API キー + Cookie |
| **[DM 会話スレッド一覧](/api-reference/dm-endpoints/conversations-api-v3-v3-twitter-conversations-post)** | `POST /v3/twitter/conversations` | アカウントに存在するすべての DM 会話スレッドと最新メッセージを取得。 | `cursor` (カーソル) | API キー + Cookie |
| **[会話履歴の取得](/api-reference/dm-endpoints/dm-history-api-v3-v3-twitter-dm-history-post)** | `POST /v3/twitter/dm/history` | 指定したスレッド内のチャット履歴メッセージを取得。 | `conversation_id` (会話 ID)<br/>`max_id` (ページネーション) | API キー + Cookie |

### 6. グローバルトレンド・話題 (Trending)

| エンドポイント | メソッドとパス | 機能説明 | 主要パラメータ | 認証要件 |
| :--- | :--- | :--- | :--- | :--- |
| **[グローバルトレンドツイート](/api-reference/trending-endpoints/get-global-trending-tweets-api-twitter-global-trending-tweets-get)** | `GET /twitter/global-trending/tweets` | 世界各国または特定リージョンで話題のバズツイートを取得。 | `country` (国名、例: japan)<br/>`topic` (トピックカテゴリ)<br/>`count` (取得件数) | API キーのみ |
| **[対応国一覧](/api-reference/trending-endpoints/get-global-trending-countries-api-twitter-global-trending-countries-get)** | `GET /twitter/global-trending/countries` | トレンド取得をサポートしている国・地域の一覧を取得。 | なし | API キーのみ |
| **[話題トピック一覧](/api-reference/trending-endpoints/get-global-trending-topics-api-twitter-global-trending-topics-get)** | `GET /twitter/global-trending/topics` | トレンド分類（technology、sports、entertainment など）のカテゴリ一覧を取得。 | なし | API キーのみ |

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

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

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

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

---

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

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

## 主要運用ガイド

- [エラーハンドリングと復旧](/guides/error-handling) — HTTP ステータスコードの復旧手順、MCP エラー対応、冪等リトライ
- [レート制限と並行制御](/guides/rate-limits) — 100 QPS スループットの最適化、`429` 指数バックオフ
- [認証ガイド](/authentication) — API キーの取得、Bearer 認証仕様、多言語コード例