← All toolsCommunicationsocial_mediaAll editions

GET_RECENT_TWEETS

Fetch the most recent tweets from the authenticated Twitter user's timeline.

Parameters

NameTypeRequiredDescription
countinteger—Number of tweets to fetch (default is 5)

How to use it

You normally trigger this by describing what you want in chat — the agent selects GET_RECENT_TWEETS automatically. For example:

Try saying
“get my social media”

In a workflow

As a step in a multi-step workflow DAG:

json
{
  "id": "s1",
  "agent": "social_media",
  "action": "GET_RECENT_TWEETS",
  "args": {
    "count": 5
  },
  "depends_on": [],
  "outputs": []
}

Direct call

For scripting, call it directly via POST /execute_tool. Every tool returns { success, message, data }.

bash
curl -X POST http://127.0.0.1:8000/execute_tool \
  -H "Content-Type: application/json" \
  -d '{"tool_name":"GET_RECENT_TWEETS","args":{"count":5}}'

Part of the social_media plugin. Browse the full Plugin & Tool Catalog or the relevant feature guide.