X New Tweet

Trigger Social

Triggers when a new tweet matches your filter (username or keywords). 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	No	Twitter username to monitor (without @). Only tweets from this user will trigger.
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
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-username",        "keywords": [],        "intervalSeconds": 300      },      "children": [        "log_event"      ]    },    "log_event": {      "type": "log",      "payload": {        "message": "Triggered at {{$trigger.triggeredAt}}"      },      "children": []    }  }}

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.