X Reader

X Reader is the X (formerly Twitter) component that looks up information without posting anything: the details of a post, recent posts about a topic, an account’s posts, who liked or retweeted a post, and who quoted it.

It is useful to follow what is said about your brand, analyse the response to a campaign, or give an AI agent current information from X.

When to use it

You want a daily summary of what is posted on X about your brand or your industry.
You want to know who shared or quoted a campaign post.
You want to save an account’s latest posts in a spreadsheet.
An AI agent prepares reports and needs to look up posts on X.

Configuration

You need an X API credential with the keys of a project in the X developer portal: X API Key, X API Secret Key, X Bearer Token, X Access Token and X Access Token Secret. See Credentials.

Field	What it does
Credential (required)	The X API credential used for the lookups.
Operation (required)	What the component does. See Operations. Default: `Get Tweet`.
Mode	In every operation except `Get Tweet`. `Basic` uses the default number of results; `Advanced` shows Max Results so you can choose it. Default: `Basic`.
Tweet ID	Only in `Get Tweet`, `Get Liking Users`, `Get users who retweet` and `Get Quote Tweets`. The post’s ID, the number at the end of its link. Required.
Query	Only in `Get Recent Tweets`. The words or filter the posts must match, for example your brand’s name. Required.
Username	Only in `Get User Timeline` and `Get Tweets By User`. The account’s username, without the @. Required.
Max Results	With `Advanced`. The maximum number of results to return, up to 100. X sets a minimum depending on the operation: 10 in `Get Recent Tweets` and `Get Quote Tweets`, and 5 in `Get User Timeline` and `Get Tweets By User`. Default: 5.

Operations

Operation	What it does
`Get Tweet`	Returns a post’s details.
`Get Recent Tweets`	Searches recent posts that match Query.
`Get User Timeline`	Returns recent posts from the timeline of the credential’s account, without replies or retweets. Write that same account’s username in Username.
`Get Tweets By User`	Returns the posts of the Username account.
`Get Liking Users`	Returns the accounts that liked a post.
`Get users who retweet`	Returns the accounts that retweeted a post.
`Get Quote Tweets`	Returns the posts that quote a post.

Output

The Data output returns one item per result: a post (with its ID and text and, in some operations, its author, date and engagement figures) or an account (with its ID, name and username).

You can connect the result to an agent so it can summarise it, to a spreadsheet or to a messaging component. To reply to or share a post, use its ID with X Poster. The component can also be connected to an Agent as a tool. See Tool Mode.

Example

A coffee shop chain wants to know every morning what is said about it on X.

Add X Reader with the Get Recent Tweets operation and the company’s X API credential.
In Query write the chain’s name.
In Mode choose Advanced and set Max Results to 50.
Connect the Data output to an agent that summarises the comments and separates positive from negative ones.
Send the summary to the marketing team and schedule the flow to run every morning.

Good practices

What you can look up depends on your access plan in the X developer portal. If an operation gives a permissions error, check your plan there.
Get Recent Tweets only searches recent posts, not the whole history of X.

X Poster: post, reply, like and retweet on X.