← Tools Reference

X.com (Twitter)

Social media platform for posting and reading tweets

OAuth8 toolshttps://api.x.com/2
GET
x_oauth_get_me
Get the authenticated user's profile

/users/me

1 parameter
ParamTypeRequiredDescription
user.fieldsstringoptionalComma-separated user fields to include (e.g. 'public_metrics,created_at')
GET
x_oauth_get_user_by_username
Look up a user's profile by their @handle

/users/by/username/{username}

2 parameters
ParamTypeRequiredDescription
usernamestringrequiredX handle without the @ symbol
user.fieldsstringoptionalComma-separated user fields to include
POST
x_oauth_create_tweet
Publish a new post (tweet)

/tweets

3 parameters
ParamTypeRequiredDescription
textstringrequiredPost text (max 280 characters)
replyobjectoptionalReply settings, e.g. { in_reply_to_tweet_id: '123' }
mediaobjectoptionalMedia attachment IDs, e.g. { media_ids: ['123'] }
GET
x_oauth_get_tweet
Get a single post (tweet) by ID

/tweets/{id}

2 parameters
ParamTypeRequiredDescription
idstringrequiredPost (tweet) ID
tweet.fieldsstringoptionalComma-separated tweet fields to include
DELETE
x_oauth_delete_tweet
Delete a post (tweet) owned by the authenticated user

/tweets/{id}

1 parameter
ParamTypeRequiredDescription
idstringrequiredPost (tweet) ID to delete
GET
x_oauth_search_recent_tweets
Search posts from the last 7 days matching a query

/tweets/search/recent

4 parameters
ParamTypeRequiredDescription
querystringrequiredSearch query (supports X search operators)
max_resultsintegeroptionalResults per page (10-100)
start_timestringoptionalOldest post time to search from (RFC3339)
end_timestringoptionalNewest post time to search to (RFC3339)
GET
x_oauth_get_user_tweets
List recent posts authored by a user

/users/{id}/tweets

3 parameters
ParamTypeRequiredDescription
idstringrequiredUser ID (not username)
max_resultsintegeroptionalResults per page (5-100)
excludestringoptionalComma-separated types to exclude (retweets, replies)
POST
x_oauth_like_tweet
Like a post (tweet) as the authenticated user

/users/{id}/likes

2 parameters
ParamTypeRequiredDescription
idstringrequiredAuthenticated user's ID
tweet_idstringrequiredPost (tweet) ID to like