> ## Documentation Index
> Fetch the complete documentation index at: https://docs.b3os.org/llms.txt
> Use this file to discover all available pages before exploring further.

# X New Tweet

Triggers when a new tweet matches your filter (username or keywords). Only counts tweets from verified accounts (blue, gold, or government checkmark). Powered by TwitterAPI.io Search API polling.

Trigger Social

Triggers when a new tweet matches your filter (username or keywords). Only counts tweets from verified accounts (blue, gold, or government checkmark). Powered by TwitterAPI.io Search API polling.

## At a Glance

| Field | Value |
| --- | --- |
| Trigger ID | `x-new-tweet` |
| Category | Social |
| Tags | `twitter`, `x`, `social`, `tweet`, `polling` |

## Trigger Configuration

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `username` | `string \| array` | No | Twitter username\(s\) to monitor \(without @\). Accepts a single string or an array of usernames. |
| `keywords` | `array` | No | Keywords to match \(OR logic\). Any tweet containing at least one keyword will trigger. |
| `intervalSeconds` | `integer` | No | Polling interval in seconds. Lower = faster detection but more API credits. |

## Trigger Result

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `triggeredAt` | `string` | Yes | Timestamp when the tweet was detected \(UTC, RFC3339 format\) |
| `ruleTag` | `string` | No | TwitterAPI.io rule tag \(workflow ID\) |
| `tweetId` | `string` | No | Unique tweet ID |
| `tweetUrl` | `string` | No | URL to the tweet |
| `text` | `string` | No | Full text content of the tweet |
| `createdAt` | `string` | No | When the tweet was posted \(RFC3339\) |
| `lang` | `string` | No | Language code of the tweet \(e.g. 'en'\) |
| `conversationId` | `string` | No | Conversation thread ID |
| `likeCount` | `number` | No | Number of likes |
| `retweetCount` | `number` | No | Number of retweets |
| `replyCount` | `number` | No | Number of replies |
| `quoteCount` | `number` | No | Number of quote tweets |
| `viewCount` | `number` | No | Number of views |
| `isReply` | `boolean` | No | Whether this tweet is a reply to another tweet |
| `inReplyToUsername` | `string \| null` | No | Username of the user being replied to \(if isReply is true\) |
| `authorId` | `string` | No | Author's Twitter user ID |
| `authorUsername` | `string` | No | Author's Twitter username \(without @\) |
| `authorName` | `string` | No | Author's display name |
| `authorProfilePicture` | `string` | No | URL to the author's profile picture |
| `authorIsBlueVerified` | `boolean` | No | Whether the author has a blue verified checkmark |
| `authorVerifiedType` | `string` | No | Organization verification type \('Business' for gold, 'Government' for grey checkmark\); empty for blue-only or individual accounts. Org accounts may have authorIsBlueVerified=false — check both fields when branching on verification |
| `authorFollowers` | `number` | No | Number of followers the author has |
| `hasMedia` | `boolean` | No | Whether the tweet contains media \(photo/video/gif\) |
| `mediaType` | `string` | No | Type of media attached \(e.g. 'photo', 'video', 'animated_gif'\) |
| `mediaUrl` | `string` | No | URL of the attached media |
| `hasQuotedTweet` | `boolean` | No | Whether the tweet quotes another tweet |
| `quotedTweetUrl` | `string` | No | URL of the quoted tweet \(if hasQuotedTweet is true\) |
| `quotedTweetText` | `string` | No | Text of the quoted tweet \(if hasQuotedTweet is true\) |
| `hashtags` | `array` | No | Hashtags extracted from the tweet entities |
| `userMentions` | `array` | No | User mentions extracted from the tweet entities |
| `urls` | `array` | No | URLs extracted from the tweet entities |

## Workflow Root Example

```json
{
  "nodes": {
    "root": {
      "type": "x-new-tweet",
      "payload": {
        "username": "example_user",
        "keywords": [],
        "intervalSeconds": 300
      },
      "children": [
        "log_event"
      ]
    },
    "log_event": {
      "type": "log",
      "payload": {
        "message": "Triggered at {{$trigger.triggeredAt}}"
      },
      "children": []
    }
  }
}
```

**Reference trigger output**

Downstream nodes can use `{{$trigger.triggeredAt}}` and any result fields listed above. Event triggers usually expose the raw source payload under a field such as `event`, `body`, `trade`, or `raw`.