Twitter Search Timeline

17.46 credits/call
ae_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.

Social
17.46 credits/call

Pricing

17.46 credits/call
ConditionCharge
Each call17.46 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
cursorstringNo由先前响应返回的分页游标。""
keywordstringYes搜索关键词。—
searchTypeenum (TOP | LATEST | MEDIA | PEOPLE | LISTS)No搜索结果类型。—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.