Skip to main content
Server path: /twitter | Type: Application | PCID required: Yes Tweets, users, timelines, and media

Tools

ToolDescription
twitter_post_tweetPost a new tweet to Twitter
twitter_get_tweetRetrieve a specific tweet by ID
twitter_delete_tweetDelete a tweet
twitter_get_user_timelineGet tweets from a user’s timeline
twitter_search_tweetsSearch for tweets using Twitter search API
twitter_get_user_by_usernameGet user information by username
twitter_get_user_by_idGet user information by user ID
twitter_follow_userFollow a user on Twitter
twitter_unfollow_userUnfollow a user on Twitter
twitter_get_followersGet followers of a user
twitter_get_followingGet users that a user is following
twitter_like_tweetLike a tweet
twitter_unlike_tweetUnlike a tweet
twitter_retweetRetweet a tweet
twitter_unretweetRemove a retweet
twitter_upload_mediaUpload media (image/video) to Twitter for use in tweets
twitter_get_mentionsGet tweets that mention the authenticated user
twitter_get_home_timelineGet the authenticated user’s home timeline

twitter_post_tweet

Post a new tweet to Twitter Parameters:
ParameterTypeRequiredDefaultDescription
textstringYesTweet text content (max 280 characters)
media_idsstring[]NoArray of media IDs to attach to the tweet
reply_to_tweet_idstringNoTweet ID to reply to (for reply tweets)
quote_tweet_idstringNoTweet ID to quote (for quote tweets)

twitter_get_tweet

Retrieve a specific tweet by ID Parameters:
ParameterTypeRequiredDefaultDescription
tweet_idstringYesTweet ID to retrieve
expansionsstring[]NoFields to expand in the response
tweet_fieldsstring[]NoTweet fields to include in the response
user_fieldsstring[]NoUser fields to include for referenced users

twitter_delete_tweet

Delete a tweet Parameters:
ParameterTypeRequiredDefaultDescription
tweet_idstringYesTweet ID to delete

twitter_get_user_timeline

Get tweets from a user’s timeline Parameters:
ParameterTypeRequiredDefaultDescription
user_idstringYesUser ID whose timeline to retrieve
max_resultsnumberNo10Maximum number of tweets to return (5-100)
excludestring[]NoTypes of tweets to exclude
since_idstringNoReturn tweets posted after this tweet ID
until_idstringNoReturn tweets posted before this tweet ID
start_timestringNoStart time for tweets (ISO 8601 format)
end_timestringNoEnd time for tweets (ISO 8601 format)
tweet_fieldsstring[]NoTweet fields to include in the response

twitter_search_tweets

Search for tweets using Twitter search API Parameters:
ParameterTypeRequiredDefaultDescription
querystringYesSearch query (supports Twitter search operators like from:, to:, #hashtag, etc.)
max_resultsnumberNo10Maximum number of tweets to return (10-100)
sort_orderstringNo"recency"Sort order for results
start_timestringNoStart time for search (ISO 8601 format)
end_timestringNoEnd time for search (ISO 8601 format)
since_idstringNoReturn tweets posted after this tweet ID
until_idstringNoReturn tweets posted before this tweet ID
tweet_fieldsstring[]NoTweet fields to include in the response
user_fieldsstring[]NoUser fields to include for tweet authors

twitter_get_user_by_username

Get user information by username Parameters:
ParameterTypeRequiredDefaultDescription
usernamestringYesTwitter username (without @)
user_fieldsstring[]NoUser fields to include in the response
expansionsstring[]NoFields to expand in the response

twitter_get_user_by_id

Get user information by user ID Parameters:
ParameterTypeRequiredDefaultDescription
user_idstringYesTwitter user ID
user_fieldsstring[]NoUser fields to include in the response
expansionsstring[]NoFields to expand in the response

twitter_follow_user

Follow a user on Twitter Parameters:
ParameterTypeRequiredDefaultDescription
target_user_idstringYesUser ID to follow

twitter_unfollow_user

Unfollow a user on Twitter Parameters:
ParameterTypeRequiredDefaultDescription
target_user_idstringYesUser ID to unfollow

twitter_get_followers

Get followers of a user Parameters:
ParameterTypeRequiredDefaultDescription
user_idstringYesUser ID whose followers to retrieve
max_resultsnumberNo100Maximum number of followers to return (1-1000)
pagination_tokenstringNoToken for pagination
user_fieldsstring[]NoUser fields to include in the response

twitter_get_following

Get users that a user is following Parameters:
ParameterTypeRequiredDefaultDescription
user_idstringYesUser ID whose following list to retrieve
max_resultsnumberNo100Maximum number of users to return (1-1000)
pagination_tokenstringNoToken for pagination
user_fieldsstring[]NoUser fields to include in the response

twitter_like_tweet

Like a tweet Parameters:
ParameterTypeRequiredDefaultDescription
tweet_idstringYesTweet ID to like

twitter_unlike_tweet

Unlike a tweet Parameters:
ParameterTypeRequiredDefaultDescription
tweet_idstringYesTweet ID to unlike

twitter_retweet

Retweet a tweet Parameters:
ParameterTypeRequiredDefaultDescription
tweet_idstringYesTweet ID to retweet

twitter_unretweet

Remove a retweet Parameters:
ParameterTypeRequiredDefaultDescription
tweet_idstringYesTweet ID to unretweet

twitter_upload_media

Upload media (image/video) to Twitter for use in tweets Parameters:
ParameterTypeRequiredDefaultDescription
media_urlstringYesURL of the media file to upload
media_categorystringNo"tweet_image"Category of media being uploaded
alt_textstringNoAlt text for accessibility (recommended for images)

twitter_get_mentions

Get tweets that mention the authenticated user Parameters:
ParameterTypeRequiredDefaultDescription
max_resultsnumberNo10Maximum number of mentions to return (5-100)
since_idstringNoReturn mentions after this tweet ID
until_idstringNoReturn mentions before this tweet ID
start_timestringNoStart time for mentions (ISO 8601 format)
end_timestringNoEnd time for mentions (ISO 8601 format)
tweet_fieldsstring[]NoTweet fields to include in the response
user_fieldsstring[]NoUser fields to include for tweet authors

twitter_get_home_timeline

Get the authenticated user’s home timeline Parameters:
ParameterTypeRequiredDefaultDescription
max_resultsnumberNo10Maximum number of tweets to return (5-100)
excludestring[]NoTypes of tweets to exclude
since_idstringNoReturn tweets after this tweet ID
until_idstringNoReturn tweets before this tweet ID
tweet_fieldsstring[]NoTweet fields to include in the response
user_fieldsstring[]NoUser fields to include for tweet authors