Twitter Search Timeline
Search X (Twitter) for public conversations, accounts, media, or lists using the required keyword input. Optionally choose searchType: TOP for popular results, LATEST for latest results, MEDIA for media, PEOPLE for accounts, or LISTS for lists. No default result type is documented. Omit cursor or leave it empty for the first page; use a cursor returned by a previous response to request another page. The response contains the search payload in data, along with code, message, and recordTime. The detailed result structure and pagination field names are not specified, so available items and continuation information depend on the returned payload.
Pricing
| Condition | Charge |
|---|---|
| Each call | 17.46 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
cursor | string | No | 由先前响应返回的分页游标。 | "" |
keyword | string | Yes | 搜索关键词。 | — |
searchType | enum (TOP | LATEST | MEDIA | PEOPLE | LISTS) | No | 搜索结果类型。 | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_twitter_search_timeline' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"keyword": "\"Timber for the Taking\"",
"searchType": "LATEST"
}
}'{
"code": 0,
"data": {
"next_cursor": "DAACCgACHW01nZyAJxAKAAMdbTWdnH_Y8AgABAAAAAILAAUAAAB8RW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUFrZGJJdXU2Qll4bUIxc3ZLdnQyZ0ZMSFd4ai9iUFhZQ1VZRVhUL2tsZWhweDFzVmRIaGw1RGpHQkZvOEdVWHNia2RiR3lhOWRvaFpoMXN2S3RWV2hIVkdCS0dnRmdXa09vPQgABgAAAAAIAAcAAAAADAAICgABHWxV0eGXkOMA",
"prev_cursor": "DAACCgACHW01nZyAJxAKAAMdbTWdnH_Y8AgABAAAAAELAAUAAAB8RW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUFrZGJJdXU2Qll4bUIxc3ZLdnQyZ0ZMSFd4ai9iUFhZQ1VZRVhUL2tsZWhweDFzVmRIaGw1RGpHQkZvOEdVWHNia2RiR3lhOWRvaFpoMXN2S3RWV2hIVkdCS0dnRmdXa09vPQgABgAAAAAIAAcAAAAADAAICgABHWxV0eGXkOMA",
"status": "ok",
"timeline": [
{
"bookmarks": 5,
"conversation_id": null,
"created_at": "Tue Nov 10 15:39:10 +0000 2026",
"entities": {
"hashtags": [
{}
],
"symbols": [],
"timestamps": [],
"urls": [
{}
],
"user_mentions": [
{}
]
},
"favorites": 13,
"type": "tweet"
}
]
},
"message": null,
"recordTime": "2026-11-11T14:55:02.731017622",
"requestParams": {
"body": null,
"query": {
"cursor": "",
"keyword": "\"Timber for the Taking\"",
"searchType": "LATEST"
}
}
}This example shows part of the response. Copied content is valid JSON.





