How to search tweets in X (Twitter)

Search Tweets in X (Twitter) — start free

Inputs

The fields this action accepts.

Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.

Field	Type	Required	Description
Search Query query	string	Required	Search query (max 512 chars). Supports operators: from:, to:, is:retweet, has:media, lang:, etc.
Max Results max_results	number	Optional	Number of results (10-100)
Sort Order sort_order	options	Optional	Sort Order. Options: Most Recent, Most Relevant

Sample request

{
  "query": "e.g. from:elonmusk AI",
  "max_results": "{{trigger.max_results}}",
  "sort_order": "{{trigger.sort_order}}"
}

Returns

{
  "data": [
    {
      "id": "123",
      "text": "Hello world",
      "author_id": "456",
      "created_at": "2026-04-19T10:00:00Z",
      "public_metrics": {
        "like_count": 10,
        "reply_count": 2,
        "retweet_count": 5
      }
    }
  ],
  "meta": {
    "next_token": "abc123",
    "result_count": 10
  }
}

Use these fields in downstream nodes for routing, logging, or error handling.

FAQ

Questions about Search Tweets.

What does the Search Tweets action do in X (Twitter)?

Searches recent tweets matching a query, returning results from the last 7 days on standard tiers. Use for social listening, hashtag monitoring, or competitive intel.

What inputs does Search Tweets require?

Required: Search Query. Every input accepts a static value or a variable from any upstream node in your workflow.

Can I use dynamic inputs from earlier workflow nodes?

Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.

What happens if X (Twitter) returns an error?

The workflow pauses on the failed node, the error message is captured in the run log, and you can retry the run with one click. Auto-retry policies are configurable per workflow with exponential backoff up to 5 attempts.

Does Search Tweets support batch operations?

Yes. Run Search Tweets inside a Loop node to process arrays. TinyCommand handles X (Twitter)'s rate limits automatically so you don't have to throttle manually.

More actions