agentbox-twitter

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Twitter Research

Twitter/X 研究

Paid Twitter/X data API at

https://twitter.x402.agentbox.fyi

. Costs $0.003 USDC per call via x402 on Solana. Use the

x_payment

tool for all requests.

付费Twitter/X数据API地址为

https://twitter.x402.agentbox.fyi

。通过Solana上的x402进行调用，每次费用为0.003 USDC。所有请求请使用

x_payment

工具。

Endpoints

端点

Search Tweets

搜索推文

Find tweets matching a query with 50+ advanced operators.

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

Parameters:

Param	Type	Default	Description
q	string	required	Search query with operators
type	"Latest" or "Top"	Latest	Sort by recency or popularity
limit	1-200	20	Max tweets to return
cursor	string	-	Pagination cursor from previous response

Search operators:

Operator	Example	Description
from:user	`from:elonmusk`	Tweets by user
to:user	`to:elonmusk`	Replies to user
@user	`@solana`	Mentioning user
min_faves:N	`min_faves:100`	Minimum likes
min_retweets:N	`min_retweets:50`	Minimum retweets
min_replies:N	`min_replies:10`	Minimum replies
filter:media	`filter:media`	Has media
filter:images	`filter:images`	Has images
filter:videos	`filter:videos`	Has video
filter:links	`filter:links`	Has links
filter:replies	`filter:replies`	Only replies
-filter:replies	`-filter:replies`	Exclude replies
since:date	`since:2025-01-01`	After date
until:date	`until:2025-12-31`	Before date
within_time:Nh	`within_time:24h`	Last N hours
lang:code	`lang:en`	Language filter
conversation_id:ID	`conversation_id:123`	In conversation
filter:self_threads	`from:user filter:self_threads`	User's thread replies

Combine operators:

from:elonmusk AI min_faves:100 -filter:replies within_time:7d

Response:

{ query, tweets[], count, hasMore, nextCursor, summary }

The

summary

object includes:

totalLikes

totalRetweets

totalReplies

avgLikes

maxLikes

topTweetId

使用50+高级运算符查找匹配查询条件的推文。

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

参数：

参数	类型	默认值	描述
q	string	必填	带运算符的搜索查询
type	"Latest" 或 "Top"	Latest	按时效性或热度排序
limit	1-200	20	返回的最大推文数量
cursor	string	-	来自上一次响应的分页游标

搜索运算符：

运算符	示例	描述
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

。

Fetch Tweets

获取推文

Get tweet(s) by ID or URL with optional thread, replies, and quotes.

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

URL format:

/tweet/{ref}

where ref is:

Tweet ID:
```
1585841080431321088
```
Comma-separated IDs:
```
123,456,789
```
(batch fetch, no includes)

Parameters:

Param	Type	Default	Description
include	string	-	Comma-separated: `thread` , `replies` , `quotes`
limit	1-200	50	Max replies/quotes to return

Include options (single tweet only):

```
thread
```
- author's self-reply chain in the conversation
```
replies
```
- replies from other users
```
quotes
```
- quote tweets of this tweet

Response:

{ tweets[], count, parent?, thread?, replies?, quotes? }

If the fetched tweet is a reply,

parent

is auto-included with the replied-to tweet.

通过ID或URL获取推文，可选择包含线程、回复和引用内容。

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

URL格式：

/tweet/{ref}

其中ref可以是：

推文ID：
```
1585841080431321088
```
逗号分隔的多个ID：
```
123,456,789
```
（批量获取，不支持包含额外内容）

参数：

参数	类型	默认值	描述
include	string	-	逗号分隔的选项： `thread` , `replies` , `quotes`
limit	1-200	50	返回的最大回复/引用数量

包含选项（仅单条推文支持）：

```
thread
```
- 作者在对话中的自回复链
```
replies
```
- 其他用户的回复
```
quotes
```
- 引用该推文的推文

响应：

{ tweets[], count, parent?, thread?, replies?, quotes? }

如果获取的推文是回复内容，

parent

会自动包含被回复的推文。

Fetch Users

获取用户资料

Get user profile(s) with optional tweets, followers, or following.

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

URL format:

/user/{ref}

where ref is:

Username:
```
elonmusk
```
or
```
@elonmusk
```
User ID:
```
44196397
```
Comma-separated IDs:
```
123,456
```
(batch fetch, no includes)

Parameters:

Param	Type	Default	Description
include	string	-	Comma-separated: `tweets` , `followers` , `following`
limit	1-200	50	Max tweets/followers/following to return
include_replies	boolean	false	Include replies in user's tweets

Response (single):

{ user, tweets?, followers?, following? }

Response (batch):

{ users[], count, hasMore }

获取用户资料，可选择包含推文、关注者或关注对象。

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

URL格式：

/user/{ref}

其中ref可以是：

用户名：
```
elonmusk
```
或
```
@elonmusk
```
用户ID：
```
44196397
```
逗号分隔的多个ID：
```
123,456
```
（批量获取，不支持包含额外内容）

参数：

参数	类型	默认值	描述
include	string	-	逗号分隔的选项： `tweets` , `followers` , `following`
limit	1-200	50	返回的最大推文/关注者/关注对象数量
include_replies	boolean	false	在用户推文中包含回复内容

响应（单用户）：

{ user, tweets?, followers?, following? }

响应（批量）：

{ users[], count, hasMore }

Usage Patterns

使用模式

Monitor a topic

监控话题

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

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

Get a tweet with full context

获取带完整上下文的推文

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

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

Research a user

研究用户

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

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

Paginate results

分页获取结果

Use

nextCursor

from a previous response:

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

使用上一次响应中的

nextCursor

：

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

Cost

费用

Every call costs $0.003 USDC on Solana mainnet. Each paginated request is a separate call. Plan queries to minimize calls - use specific operators and reasonable limits.

每次调用在Solana主网需支付0.003 USDC。每个分页请求视为单独调用。请合理规划查询，以减少调用次数——使用具体的运算符和合理的数量限制。

Errors

错误说明

HTTP	Meaning
400	Invalid parameters (check query syntax)
402	Payment required (handled automatically by x_payment)
404	Tweet or user not found
502	Upstream API error

HTTP状态码	含义
400	参数无效（检查查询语法）
402	需要支付（由x_payment工具自动处理）
404	推文或用户不存在
502	上游API错误