Back to Hub

X Get User Tweets

HTTP Official API

Fetch recent tweets from a specific X (Twitter) user's timeline. Returns tweet text, timestamps, and engagement metrics.

Tony CostanzoTony Costanzo
0 installs
v1.0.0
Mar 31, 2026
Workspace secrets required
This tool references workspace secrets. After installing, you'll need to configure the required secrets in Settings → Integrations and create a new secret for the tool to work.

X Get User Tweets

Official Fetch recent tweets from a specific X (Twitter) user's timeline.

What this tool does: Retrieves recent original tweets from a user's timeline using the X API v2. Returns tweet text, timestamps, and engagement metrics (likes, retweets, replies). Excludes retweets and replies by default for cleaner results. Great for monitoring what a person or brand is posting.

Setup

Follow the setup in X Search Tweets if you haven't already. This tool uses the same X_API_KEY secret.

Never paste API keys directly into tool definitions. Always use workspace secrets.

Parameters

ParameterRequiredDescription
usernameYesX username without the @ symbol (e.g., elonmusk)
max_resultsNoNumber of tweets to return (5-100, default: 10)

Example Prompts

Try these with your agent:

  • "What has @dhaborations been tweeting about lately?"
  • "Get the last 20 tweets from @ycombinator"
  • "Show me recent posts from our competitor's X account"

Notes

Tip: This tool automatically excludes retweets and replies, showing only original tweets. This makes it ideal for understanding what a user is actually saying vs. what they're amplifying.

Tool Definition

Input Parameters

usernamestringThe X username whose tweets to fetch (without the @ symbol).
max_resultsnumberNumber of tweets to return (5-100). Defaults to 10 if omitted.

HTTP Configuration

Method: GET
URL: https://api.twitter.com/2/users/by/username/{{input.username}}