X Twitter Searchpostsrecent
1.24 credits/call
ae_x_twitter_searchpostsrecent
Search public posts from the past seven days by keyword, time range or post ID range. Results may not be strictly chronological.
1.24 credits/call
Pricing
1.24 credits/call
| Condition | Charge |
|---|---|
| Each call | 1.24 credits/call |
1.24 credits/call Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
query | string | Yes | 搜索表达式,例如from:NASA、filter:media、lang:en。 Search expression, such as from:NASA, filter:media or lang:en. | — |
end_time | string | No | 截止时间,不包含该时刻。使用带时区的RFC3339格式;与until_id二选一。 Exclusive end time in RFC3339 format with a timezone. Do not combine with until_id. | — |
since_id | string | No | 仅查询晚于该推文ID的帖子;与start_time二选一。 Return posts newer than this post ID; do not combine with start_time. | — |
until_id | string | No | 仅查询早于该推文ID的帖子;与end_time二选一。 Return posts older than this post ID; do not combine with end_time. | — |
sort_order | enum (recency | relevancy) | No | 检索方式:recency优先近期结果,relevancy优先相关结果;返回顺序可能不严格按时间排列。 Search mode: recency favors recent results; relevancy favors relevant results. Results may not be strictly chronological. | — |
start_time | string | No | 起始时间,包含该时刻。使用带时区的RFC3339格式;与since_id二选一。 Inclusive start time in RFC3339 format with a timezone. Do not combine with since_id. | — |
pagination_token | string | No | 上一页返回的分页标记。首次查询不填;不能自行编造。 Pagination token returned by the previous page. Omit for the first page; do not invent a token. | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_x_twitter_searchpostsrecent' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"end_time": "2026-11-11T02:40:00Z",
"query": "INMO recall",
"sort_order": "recency",
"start_time": "2026-11-10T10:00:00Z"
}
}'Response exampleresponse.json
{
"code": 200,
"data": {
"next_cursor": "DAACCgACHWz7aGGAJxAKAAMdbPtoYX_Y8AgABAAAAAILAAUAAAAcRW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUFBPQgABgAAAAAIAAcAAAAAAAA",
"prev_cursor": "DAACCgACHWz7aGGAJxAKAAMdbPtoYX_Y8AgABAAAAAELAAUAAAAcRW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUFBPQgABgAAAAAIAAcAAAAAAAA",
"status": "ok",
"timeline": []
},
"docs": "https://api.tikhub.io/#/Twitter-Web-API/fetch_search_timeline_api_v1_twitter_web_fetch_search_timeline_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {
"cursor": "",
"keyword": "INMO recall within_time:7d since_time:1794304800 until_time:1794364800",
"search_type": "Latest"
}
}This example shows part of the response. Copied content is valid JSON.
Guides using this tool
See how this tool fits into real workflows
The AI Agent Tool Stack for Market ResearchUse one AI agent to pull market research from every source — community threads, social posts, product reviews and deep search — in a single prompt, then merge it all into one structured insight brief.X (Twitter) Sentiment as Trading Signals with AI AgentsLet an AI agent turn X (Twitter) chatter into trading signals — pull recent posts, gauge how loud the conversation is, and align it with live prices from one plain-English prompt, no API wiring or timeline scrolling.Multi-Platform Social Listening with One AI AgentUse one AI agent to monitor a brand or topic across X, Xiaohongshu, Douyin and Reddit from a single prompt — search in parallel, merge and dedupe, group by platform, cluster sentiment, and get one unified listening report.
X (Twitter) Trends & List Tracking with AI AgentsLet an AI agent track what's hot on X (Twitter) from one prompt — read trends by location, pull recent posts under a trend, estimate topic volume, and track a specific List for your niche.
X (Twitter) Monitoring & Analysis with AI AgentsUse one AI agent to monitor X (Twitter): track keywords, pull account timelines and profiles, and gauge topic volume — turning scattered scrolling into an automated, repeatable monitoring report.





