Twitter Search Tool

Search for recent tweets on Twitter/X.

How It Works

This skill provides instructions for the Twitter Search tool node. Connect the Twitter Search node to an AI Agent's input-tools handle to enable tweet searching.

twitter_search Tool

Search for tweets matching a query.

Schema Fields

Query Operators

The X API supports advanced search operators:

Examples

Simple keyword search:

{
  "query": "artificial intelligence",
  "max_results": 20
}

Search with hashtag:

{
  "query": "#MachineLearning",
  "max_results": 50
}

Search tweets from a user:

{
  "query": "from:OpenAI",
  "max_results": 10
}

Complex query:

{
  "query": "AI (startup OR company) -is:retweet lang:en",
  "max_results": 100
}

Search with media:

{
  "query": "sunset has:media",
  "max_results": 25
}

Response Format

{
  "success": true,
  "result": {
    "tweets": [
      {
        "id": "1234567890123456789",
        "text": "Exciting developments in AI...",
        "author_id": "987654321",
        "created_at": "2025-02-19T10:30:00Z"
      }
    ],
    "count": 20,
    "query": "#AI"
  },
  "execution_time": 0.82
}

Error Response

{
  "success": false,
  "error": "Search query is required",
  "execution_time": 0.01
}

Guidelines

1. Query length: Keep queries concise for better results
2. Max results: Limited to 100 per request (API constraint)
3. Recent tweets only: X API v2 free tier searches recent tweets (last 7 days)
4. Rate limits: Be mindful of API rate limits when searching repeatedly
5. Combine operators: Use multiple operators for precise filtering

Common Use Cases

• Monitor brand mentions
• Track trending topics
• Find tweets about specific subjects
• Research competitor activity
• Gather content for curation
• Find influencers discussing topics

Setup Requirements

1. Connect the Twitter Search node to an AI Agent's input-tools handle
2. Ensure Twitter is connected (authenticated via OAuth in Credentials Modal)
3. Your X Developer account must have appropriate API access level