agentbox-twitter

Twitter調査

https://twitter.surf.cascade.fyi の有料 Twitter/X データ API です。Solana または Base 上の x402 経由で、1 回の呼び出しにつき $0.003 USDC かかります。すべてのリクエストで x_payment ツールを使用してください。

エンドポイント

ツイートを検索

50 種類以上の高度な演算子を使って、クエリに一致するツイートを検索します。

x_payment({
  "url": "https://twitter.surf.cascade.fyi/search",
  "method": "GET",
  "params": "{\"q\": \"from:elonmusk AI\", \"type\": \"Latest\", \"limit\": 20}"
})

パラメーター：

Param	Type	Default	Description
q	string	required	演算子を使った検索クエリ
type	"Latest" or "Top"	Latest	新しさまたは人気度で並べ替え
limit	1-200	20	返すツイートの最大数
cursor	string	-	前回のレスポンスから取得したページネーションカーソル

検索演算子：

Operator	Example	Description
from:user	from:elonmusk	ユーザーによるツイート
to:user	to:elonmusk	ユーザーへの返信
@user	@solana	ユーザーへのメンション
min_faves:N	min_faves:100	いいねの最小数
min_retweets:N	min_retweets:50	リポストの最小数
min_replies:N	min_replies:10	返信の最小数
filter:media	filter:media	メディアを含む
filter:images	filter:images	画像を含む
filter:videos	filter:videos	動画を含む
filter:links	filter:links	リンクを含む
filter:replies	filter:replies	返信のみ
-filter:replies	-filter:replies	返信を除外
since:date	since:2025-01-01	指定日以降
until:date	until:2025-12-31	指定日より前
within_time:Nh	within_time:24h	過去 N 時間
lang:code	lang:en	言語フィルター
conversation_id:ID	conversation_id:123	指定した会話内
filter:self_threads	from:user filter:self_threads	ユーザー自身のスレッドへの返信

演算子を組み合わせます：from:elonmusk AI min_faves:100 -filter:replies within_time:7d

レスポンス： { query, tweets[], count, hasMore, nextCursor, summary }

summary オブジェクトには、totalLikes、totalRetweets、totalReplies、avgLikes、maxLikes、topTweetId が含まれます。

ツイートを取得

ID または URL を指定してツイートを取得します。スレッド、返信、引用を任意で含められます。

x_payment({
  "url": "https://twitter.surf.cascade.fyi/tweet/1585841080431321088",
  "method": "GET",
  "params": "{\"include\": \"thread,replies\", \"limit\": 50}"
})

URL 形式： /tweet/{ref}。ref は次のいずれかです：

• ツイート ID：1585841080431321088
• カンマ区切りの ID：123,456,789（一括取得、追加データなし）

パラメーター：

Param	Type	Default	Description
include	string	-	カンマ区切り：thread、replies、quotes
limit	1-200	50	返す返信／引用の最大数

include オプション（単一ツイートのみ）：

• thread - 会話内で投稿者が自分のツイートに返信したスレッド
• replies - 他のユーザーからの返信
• quotes - このツイートの引用ツイート

レスポンス： { tweets[], count, parent?, thread?, replies?, quotes? }

取得したツイートが返信の場合、返信先のツイートが parent として自動的に含まれます。

ユーザーを取得

ツイート、フォロワー、フォロー中のユーザーを任意で含めて、ユーザープロフィールを取得します。

x_payment({
  "url": "https://twitter.surf.cascade.fyi/user/elonmusk",
  "method": "GET",
  "params": "{\"include\": \"tweets\", \"limit\": 20}"
})

URL 形式： /user/{ref}。ref は次のいずれかです：

• ユーザー名：elonmusk または @elonmusk
• ユーザー ID：44196397
• カンマ区切りの ID：123,456（一括取得、追加データなし）

パラメーター：

Param	Type	Default	Description
include	string	-	カンマ区切り：tweets、followers、following
limit	1-200	50	返すツイート／フォロワー／フォロー中のユーザーの最大数
include_replies	boolean	false	ユーザーのツイートに返信を含める

レスポンス（単一）： { user, tweets?, followers?, following? } レスポンス（一括）： { users[], count, hasMore }

使用パターン

トピックをモニタリングする

x_payment({
  "url": "https://twitter.surf.cascade.fyi/search",
  "method": "GET",
  "params": "{\"q\": \"x402 OR \\\"402 payment\\\" min_faves:5 within_time:24h\", \"type\": \"Latest\"}"
})

ツイートをコンテキスト付きで取得する

x_payment({
  "url": "https://twitter.surf.cascade.fyi/tweet/1585841080431321088",
  "method": "GET",
  "params": "{\"include\": \"thread,replies,quotes\", \"limit\": 20}"
})

ユーザーを調査する

x_payment({
  "url": "https://twitter.surf.cascade.fyi/user/CoinbaseDev",
  "method": "GET",
  "params": "{\"include\": \"tweets\", \"limit\": 50}"
})

結果をページネーションする

前回のレスポンスの nextCursor を使用します：

x_payment({
  "url": "https://twitter.surf.cascade.fyi/search",
  "method": "GET",
  "params": "{\"q\": \"from:elonmusk\", \"cursor\": \"DAABCgAB...\"}"
})

コスト

Solana mainnet または Base mainnet 上で、呼び出し 1 回につき $0.003 USDC かかります。ページネーションによるリクエストも、それぞれ個別の呼び出しとして課金されます。呼び出し回数を抑えられるよう、具体的な演算子と適切な上限値を使ってクエリを計画してください。

エラー

HTTP	意味
400	パラメーターが無効です（クエリ構文を確認してください）
402	支払いが必要です（x_payment によって自動的に処理されます）
404	ツイートまたはユーザーが見つかりません
502	上流 API エラー