TwexAPI REST API リファレンス

TwexAPI は https://api.twexapi.io にて標準的な RESTful API を提供し、X/Twitter データの読み取り、高度な検索、ユーザープロフィールとフォロワーのエクスポート、ツイート投稿、DM 送受信、X 記事処理、および AI Agent 統合を網羅しています。

主な機能群：

• 高度なツイート検索 (Search) — キーワード、ハッシュタグ、キャッシュタグによる柔軟な全文検索
• ツイートとエンゲージメント (Tweets) — スレッド全件取得、ツイート詳細、リプライ一覧、いいね・リツイートユーザーのエクスポート
• プロフィールと関係グラフ (Users) — プロフィール照会、一括取得、カーソルページネーションによるフォロワー・フォロー中リストのエクスポート
• 投稿と書き込み操作 (Tweet Actions) — 自動投稿、返信、スレッド一括作成、いいね、リツイート、ブックマーク、フォロー
• ダイレクトメッセージ (DM) — 1対1 DM 送信、権限確認、会話スレッド一覧とチャット履歴取得
• グローバルトレンド (Trending) — 世界各国および地域別の話題トレンドツイート
• X 記事 (Articles) — X 長文記事を Markdown 形式で抽出（LLM RAG に最適）、下書きと自動投稿

すべてのエンドポイントは一貫したレスポンス構造（code: 200、msg: "success"、data）を返します。詳細は エラーハンドリングガイド を参照してください。

認証 (Authentication)

すべての API リクエストヘッダーに API キーを指定します：

Authorization: Bearer YOUR_API_KEY

書き込み操作（投稿、いいね、フォロー、DM 等）には Twitter Cookie または auth_token も必要です。詳細は 認証ガイド を参照してください。

Cookie Endpoints

• GET
  auth_tokenからCookieを取得/twitter/{auth_token}/cookie
• GET
  auth_tokenによるユーザー情報取得/twitter/{auth_token}/user_info

Search Endpoints

• POST
  Twitter 高度検索・スクレイピング API (カーソルページネーション)/twitter/advanced_search/page
• POST
  キャッシュタグ銘柄検索/twitter/cashtags
• POST
  ハッシュタグ話題検索/twitter/hashtags

Tweet Actions Endpoints

• POST
  ツイートにいいね/twitter/tweets/{tweet_id}/like
• DELETE
  いいねを取り消し/twitter/tweets/{tweet_id}/like
• POST
  ツイートをリツイート/twitter/tweets/{tweet_id}/retweet
• DELETE
  Delete Retweet/twitter/tweets/{tweet_id}/retweet
• POST
  Create a Tweet Thread/v3/twitter/tweets/create-thread
• POST
  Create a Tweet or Reply/twitter/tweets/create
• POST
  Create a Quote Tweet/twitter/tweets/quote
• POST
  Bookmark a Tweet/twitter/tweets/{tweet_id}/bookmark
• DELETE
  ブックマークを削除/twitter/tweets/{tweet_id}/bookmark
• POST
  ツイートの一括削除/twitter/tweets/delete-batch

Users Endpoints

• POST
  複数ユーザーの一括情報取得/twitter/users
• POST
  ユーザーをブロック/twitter/user/block
• DELETE
  ブロックを解除/twitter/user/block
• POST
  ユーザーIDによるプロフィール取得/twitter/users/by_ids
• POST
  アカウントの有効性確認/x/account/verify
• POST
  アカウント状態の一括確認/twitter/users/status
• GET
  ユーザー検索/twitter/search-user/{keyword}/{target_count}
• POST
  Follow User/twitter/user/follow
• DELETE
  フォローを解除/twitter/user/follow

Followers & Following Endpoints

• GET
  フォロワー数の指定取得/twitter/followers/{screen_name}/{count}
• GET
  Get Followers Task Status/twitter/followers/task/{task_id}/status
• GET
  Consume Next Page of Followers Task/twitter/followers/task/{task_id}/next
• POST
  ページネーションによるフォロワー取得/twitter/followers/page
• POST
  ページネーションによるフォロー中取得/twitter/following/page
• GET
  フォロー中アカウントの指定取得/twitter/following/{screen_name}/{count}
• GET
  Get Following Task Status/twitter/following/task/{task_id}/status
• GET
  Consume Next Page of Following Task/twitter/following/task/{task_id}/next
• POST
  Get Following (v3)/v3/twitter/users/following
• POST
  フォロワー取得 API (v3 カーソル版)/v3/twitter/users/followers
• POST
  認証バッジフォロワー取得/v3/twitter/users/verified-followers

Tweet Replies Endpoints

• POST
  ツイート返信（リプライ一覧）取得 API/twitter/tweets/{tweet_id}/replies/page
• GET
  ツイート返信一覧取得 (レガシー)/twitter/tweets/{tweet_id}/replies/{count}

DM Endpoints

• POST
  DM送信権限の確認/v2/dm/status
• POST
  DM送信 (XChat v3)/v3/twitter/send-dm
• POST
  DMチャット履歴取得 (XChat v3)/v3/twitter/dm-history
• POST
  DMメディア添付ファイルの取得/v3/twitter/dm-media
• POST
  DM会話スレッド一覧取得/v3/twitter/conversations

Article Endpoints

• POST
  X長文記事の一括取得/x/article
• GET
  X 長文記事（Articles）の Markdown 形式取得 API/x/article/{tweet_id}/markdown
• POST
  長文記事の下書き作成/x/articles/draft
• PUT
  [Step 2/5] Upload and set article cover image (optional)/x/articles/{article_id}/cover
• PUT
  [Step 3/5] Set article title/x/articles/{article_id}/title
• PUT
  [Step 4/5] Set article content from Markdown/x/articles/{article_id}/content
• POST
  [Step 5/5] Publish an article draft/x/articles/{article_id}/publish
• POST
  [Quick] One-step article publish/x/articles/publish

Tweets Endpoints

• POST
  ツイート詳細データ取得 (v2)/v2/tweet/detail
• POST
  Get Tweet Thread by ID/twitter/tweets/thread_by_id
• POST
  ID指定によるツイート一括取得/twitter/tweets/lookup
• GET
  類似ツイート検索/twitter/tweets/{tweet_id}/similar

Grok Endpoints

• POST
  Grok AIへの質問/v3/twitter/grok/ask
• POST
  Grok対話履歴の取得/v3/twitter/grok/history
• POST
  Grok会話の取得/v3/twitter/grok/conversation

Tweet Engagement Endpoints

• POST
  ページネーションによるリツイート一覧取得/twitter/tweets/retweeters/page
• POST
  いいねしたユーザー一覧取得/twitter/tweets-favoriters
• POST
  Get Quote Tweets by Page/twitter/tweets/quotes/page

Lists Endpoints

• POST
  リストの作成/twitter/list/create
• POST
  リストツイートのページネーション取得/twitter/list/tweets/page
• GET
  リスト購読者の取得/twitter/list/{list_id}/subscribers/{target_count}
• POST
  リストメンバーのページネーション取得/twitter/list/members/page
• POST
  リストの検索/twitter/list/search

Communities Endpoints

• POST
  コミュニティメンバーのページネーション取得/twitter/community/members/page
• POST
  コミュニティツイートのページネーション取得/twitter/community/tweets/page
• POST
  コミュニティの検索/twitter/community/search
• GET
  Get Community/twitter/community/{community_id}
• POST
  コミュニティ内ツイートの検索/twitter/community/search-tweets

Twitter Profile Actions Endpoints

• POST
  プロフィールの更新/twitter/profile

Trending Endpoints

• GET
  トレンド対応国一覧/twitter/global-trending/countries
• GET
  トレンドトピック一覧/twitter/global-trending/topics
• GET
  トレンドコンテンツタグ一覧/twitter/global-trending/contents
• GET
  グローバルトレンドツイート取得/twitter/global-trending/tweets
• GET
  Get Trending Topics/twitter/{country}/trending

Timeline Endpoints

• POST
  ユーザータイムラインのページネーション取得/twitter/{screen_name}/timeline/page

All Tweets Replies Endpoints

• POST
  全ツイート・返信のページネーション取得/twitter/tweets-replies/page

Twitter Account Based in Endpoints

• POST
  アカウント登録国の確認/twitter/account/based

Twitter User About Endpoints

• GET
  ユーザー公開プロフィール取得/twitter/{screen_name}/about

Balance Endpoints

• GET
  アカウント残高照会/balance