Twitter

Twitter is an online social networking service that enables users to send and receive short messages called 'tweets'. Connect to Twitter to manage your tweets. You can perform various actions such as send tweet, search, view followers, etc.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure China regions
Flow Standard All Flow regions
PowerApps Standard All PowerApps regions

LIMITS

The following are some of the limits and restrictions:

  1. Maximum number of connections per user: 2
  2. API call rate limit for POST operation: 12 per hour
  3. API call rate limit for other operations: 600 per hour
  4. Frequency of trigger polls: 60 seconds
  5. Maximum size of image upload: 5 MB
  6. Maximum size of video upload: 15 MB
  7. Maximum number of search results: 100

Restrictions of Twitter API

  1. Search API searches against a sampling of recent Tweets published in the past 7 days
  2. Standard search API is focused on relevance and not completeness. This means that some Tweets and users may be missing from search results

Additional restrictions for POST operation

Mentioning a @user while posting a tweet is not supported. Specifically, the "@" characters will be stripped while posting a tweet.

General Limits

Name Value
Connections per account 2

Actions

Get followers

This operation gets the list of users that follow a given user.

Get following

The operation gets the list of people the given user follows.

Get home timeline

This operation gets the most recent tweets and re-tweets posted by me and my followers.

Get my followers

This operation gets the list of users who are following me.

Get my following

This operation gets the list of users that I am following.

Get user

This operation gets the profile details for a given user, such as user name, description, followers count, and more.

Get user timeline

This operation gets a list of the most recent tweets posted by a given user.

Post a tweet

This operation posts a new tweet.

Search tweets

This operation gets a list of relevant tweets matching the search query.

Get followers

This operation gets the list of users that follow a given user.

Parameters

Name Key Required Type Description
User name
userName True string

Twitter handle for the user

Maximum results
maxResults integer

Maximum number of users to return

Returns

Get following

The operation gets the list of people the given user follows.

Parameters

Name Key Required Type Description
User name
userName True string

Twitter handle for the user

Maximum results
maxResults integer

Maximum number of users to return

Returns

Get home timeline

This operation gets the most recent tweets and re-tweets posted by me and my followers.

Parameters

Name Key Required Type Description
Maximum results
maxResults integer

Maximum number of tweets to return

Returns

Get my followers

This operation gets the list of users who are following me.

Parameters

Name Key Required Type Description
Maximum results
maxResults integer

Maximum number of users to get

Returns

Get my following

This operation gets the list of users that I am following.

Parameters

Name Key Required Type Description
Maximum results
maxResults integer

Maximum number of users to return

Returns

Get user

This operation gets the profile details for a given user, such as user name, description, followers count, and more.

Parameters

Name Key Required Type Description
User name
userName True string

Twitter handle for the user

Returns

Represents a user.

Get user timeline

This operation gets a list of the most recent tweets posted by a given user.

Parameters

Name Key Required Type Description
User name
userName True string

Twitter handle for the user

Maximum results
maxResults integer

Maximum number of tweets to return

Returns

Post a tweet

This operation posts a new tweet.

Parameters

Name Key Required Type Description
Tweet text
tweetText string

Text to be posted

Media
body binary

Media to be posted

Returns

Represents the response of a tweet post.

Search tweets

This operation gets a list of relevant tweets matching the search query.

Parameters

Name Key Required Type Description
Search text
searchQuery True string

Search term like "happy hour", #haiku, from:@username, love OR hate

Maximum results
maxResults integer

Maximum number of tweets to return

sinceId
sinceId string

Return tweets after the specified tweet ID

Returns

Triggers

When a new tweet is posted

This operation triggers a flow when a new tweet that matches a given search query is posted.

When a new tweet is posted

This operation triggers a flow when a new tweet that matches a given search query is posted.

Parameters

Name Key Required Type Description
Search text
searchQuery True string

Search term like "happy hour", #haiku, from:@username, love OR hate

Returns

Represents a wrapper object for batch trigger response

Definitions

TweetModel

Represents a tweet post.

Name Path Type Description
Tweet text
TweetText string

Text content of the tweet

Tweet id
TweetId string

Id of the tweet

Created at
CreatedAtIso string

Time at which the tweet was posted

Retweet count
RetweetCount integer

Total number of re-tweets for the tweet

Tweeted by
TweetedBy string

Name of the user who has posted the tweet

Media urls
MediaUrls array of string

Url of the media posted along with the tweet

Tweet language
TweetLanguageCode string

Language code of the tweet

in_reply_to_user_id
TweetInReplyToUserId string

User Id of the author of the tweet that the current tweet is a reply to

Favorited
Favorited boolean

Indicates whether the tweet is marked as favorited or not

User mentions
UserMentions array of UserMentionsModel

List of users mentioned in the tweet

OriginalTweet
OriginalTweet OriginalTweetModel

Represents an original tweet post.

UserDetails
UserDetails UserDetailsModel

Represents a user.

UserMentionsModel

Represents a user mentioned in a tweet.

Name Path Type Description
Mentioned user id
Id integer

Twitter id (handle) of the user

Mentioned user full name
FullName string

Full name of the user

Mentioned user name
UserName string

Screen name of the user

OriginalTweetModel

Represents an original tweet post.

Name Path Type Description
Original tweet text
TweetText string

Text content of the original retrieved tweet

Original tweet id
TweetId string

Id of the original tweet

Original tweet created at
CreatedAtIso string

Time at which original tweet was posted

Original tweet retweet count
RetweetCount integer

Total number of re-tweets for this original tweet

Original tweet tweeted by
TweetedBy string

User name of the person who posted the original tweet

Original tweet media urls
MediaUrls array of string

Url of the media posted along with the original tweet

Original tweet language
TweetLanguageCode string

Language code for the original tweet

Original tweet in_reply_to_user_id
TweetInReplyToUserId string

User Id of the author of the tweet that the current original tweet is a reply to

Original tweet favorited
Favorited boolean

Indicates whether the original tweet is marked as favorited

Original tweet user mentions
UserMentions array of OriginalTweetUserMentionsModel

The list of user mentioned in the tweet

UserDetails
UserDetails OriginalTweetUserDetailsModel

Represents a user who posted an original tweet

UserDetailsModel

Represents a user.

Name Path Type Description
Name
FullName string

Name of the user

Location
Location string

Location of the user

User id
Id integer

Twitter id (handle) of the user

User name
UserName string

Screen name of the user

Followers count
FollowersCount integer

Number of followers

Description
Description string

User description

Statuses count
StatusesCount integer

User status count

Friends count
FriendsCount integer

Number of friends

Favourites count
FavouritesCount integer

Number of tweets that the user has favorited

Profile image url
ProfileImageUrl string

Url of the profile image

OriginalTweetUserMentionsModel

Represents a user mentioned in an original tweet.

Name Path Type Description
Original tweet mentioned user id
Id integer

Twitter id (handle) of the user

Original tweet mentioned user full name
FullName string

Full name of the user

Original tweet mentioned user name
UserName string

Screen name of the user

OriginalTweetUserDetailsModel

Represents a user who posted an original tweet

Name Path Type Description
Original tweet user full name
FullName string

Name of the user

Original tweet user Location
Location string

Location of the user

Original tweet user id
Id integer

Twitter id (handle) of the user

Original tweet user name
UserName string

Screen name of the user

Original tweet user followers count
FollowersCount integer

Number of followers

Original tweet user Description
Description string

User description

Original tweet user statuses count
StatusesCount integer

User status count

Original tweet user friends count
FriendsCount integer

Number of friends

Original tweet user favourites count
FavouritesCount integer

Number of tweets that the user has favorited

Original tweet user profile image url
ProfileImageUrl string

Url of the profile image

TweetResponseModel

Represents the response of a tweet post.

Name Path Type Description
Tweet id
TweetId string

ID of the tweet posted

TriggerBatchResponse[TweetModel]

Represents a wrapper object for batch trigger response

Name Path Type Description
value
value array of TweetModel

A list of the response objects