X Search API

X Search API は、X/Twitter のデータにアクセスするための API です。ユーザープロフィール、ユーザー検索、ユーザー tweets、tweet 検索、返信を取得できます。Agent の調査、ソーシャルリスニング、アカウント分析、コンテンツ分析に適しています。

認証

Authorization: Bearer YOUR_API_KEY

1. ユーザー情報を取得

username を指定して X ユーザープロフィールを一括取得します。

POST https://openapi.felo.ai/v2/x/user/info

curl -X POST 'https://openapi.felo.ai/v2/x/user/info' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"usernames":["elonmusk","OpenAI"]}'

2. ユーザーを検索

キーワードで X ユーザーを検索します。

POST https://openapi.felo.ai/v2/x/user/search

3. ユーザー Tweets を取得

指定した X ユーザーの tweets を取得します。

POST https://openapi.felo.ai/v2/x/user/tweets

curl -X POST 'https://openapi.felo.ai/v2/x/user/tweets' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"username":"elonmusk","limit":20}'

4. Tweets を検索

キーワードで X tweets を検索します。高度な検索構文にも対応します。

POST https://openapi.felo.ai/v2/x/tweet/search

5. Tweet の返信を取得

指定した tweets の返信を取得します。

POST https://openapi.felo.ai/v2/x/tweet/replies

共通レスポンスフィールド

ユーザーオブジェクトには user_id、username、display_name、description、followers_count、following_count、tweet_count、verified、blue_verified、profile_image_url、created_at、location、url などが含まれます。

Tweet オブジェクトには id、content、author、created_at、metrics、conversation_id、media_urls、hashtags、mentions、urls、url、lang、返信関連フィールド、quoted tweet、retweeted tweet などが含まれます。

Credits とレート制限

各 API 呼び出しでは、返された結果数に応じて credits が差し引かれます。結果が 0 件の場合、credits は差し引かれません。X API リクエストを行うには、アカウントに少なくとも 10 credits が必要です。

credits 残高が 100 未満の非有料サブスクライバーアカウントにはレート制限があります。制限時、API は HTTP 429 を返し、Retry-After header に推奨待機秒数が入ります。

エラーコード