Integromat
  • Back to website
Articles in this section
  • Airtable
  • Bubble
  • Email (legacy)
  • Facebook Groups
  • Formstack
  • Google Cloud Vision
  • Google Sheets (legacy)
  • HTTP
  • JSON
  • Magento 2
See more
  1. Integromat Support
  2. Apps
  3. Docs

Twitter

Integromat Support Team Integromat Support Team Updated December 21, 2020 17:35

The Twitter modules allow you to monitor, search, create, list, or delete tweets; monitor and list retweets; watch and list followers; manage favorites; watch, send, list, and delete messages; manage lists and mentions; and also search users in your Twitter account.

Getting Started with Twitter

Prerequisites

  • A Twitter account
  • Integromat paid pricing plan. Twitter is a premium app. Therefore it is not available for users using the FREE pricing plan.
To get access to premium modules, upgrade to any of our paid plans, starting at $9 per month.

In order to use Twitter with Integromat, it is necessary to have a Twitter account. If you do not have one, you can create a Twitter account at twitter.com/signup.

The module dialog fields that are displayed in bold (in the Integromat scenario, not in this documentation article) are mandatory!

Connecting Twitter to Integromat

To connect your Twitter account to Integromat follow the general instructions for Connecting to services.

After you click the Continue button, Integromat will redirect you to the Twitter website where you will be prompted to grant Integromat access to your account.

Do not forget to check the Follow Integromat for news checkbox to stay up to date with new Integromat features. 

2019-10-14_10_32_58-Twitter___Authorize_an_application.png

Confirm the dialog by clicking the Authorize app button.

You may need to unlock your account first.

2019-10-14_11_10_39-2019-10-14_10_28_29-https___twitter.com_account_access.pngFollow the instructions from Twitter and grant Integromat access (above) after the unlocking process is completed.

Tweet

Watch Tweets

Retrieves tweet details when a new tweet is posted.

Connection Establish a connection to your Twitter account.
I want to watch Select whether you want to watch your own tweets or someone else's tweets.
Screen name Enter the screen name of the Twitter user you want to watch for new tweets, e.g.integromat.
Prevent replies from appearing in the returned timeline If this option is enabled, replies to the tweet will not be returned.
Include retweets Retweets are excluded by default. Enabling this will also allow you to return retweets by this module.
Limit Set the maximum number of tweets Integromat will return during one execution cycle.

Search Tweets

This action allows you to search for Tweets that match the given criteria. You can get a maximum of the last 100 tweets. The search results are limited to Tweets from the past 7 days.

Connection Establish a connection to your Twitter account.
Search phrase

Enter the search term. You can use search operators.

For detailed information on search possibilities, see the 'Standard search operators' section in the Twitter Rules and filtering API Documentation.

Supported Search Operators (see the list of operators in the 'Standard search operators' section in the Twitter Rules and filtering API Documentation)

Operator Finds Tweets...
watching now containing both “watching” and “now”; this is the default operator.
“happy hour” containing the exact phrase “happy hour”.
love OR hate containing either “love” or “hate” (or both).
beer -root containing “beer” but not “root”.
#haiku containing the hashtag “haiku”.
from:interior sent from Twitter account “interior”.
list:NASA/astronauts-in-space-now sent from a Twitter account in the NASA list astronauts-in-space-now.
to:NASA a Tweet authored in reply to Twitter account “NASA”.
@NASA mentioning Twitter account “NASA”.
politics filter:safe containing “politics” with Tweets marked as potentially sensitive removed.
puppy filter:media containing “puppy” and an image or video.
puppy -filter:retweets containing “puppy”, filtering out retweets.
puppy filter:native_video containing “puppy” and an uploaded video, Amplify video, Periscope, or Vine.
puppy filter:periscope containing “puppy” and a Periscope video URL.
puppy filter:vine containing “puppy” and a Vine.
puppy filter:images containing “puppy” and links identified as photos; including third parties such as Instagram.
puppy filter:twimg containing “puppy” and a pic.twitter.com link representing one or more photos.
hilarious filter:links containing “hilarious” and linking to URL.
puppy url:amazon containing “puppy” and a URL with the word “amazon” anywhere within it.
superhero since:2015-12-21 containing “superhero” and sent since date “2015-12-21” (year-month-day).
puppy until:2015-12-21 containing “puppy” and sent before the date “2015-12-21”.
movie -scary :) containing “movie”, but not “scary”, and with a positive attitude.
flight :( containing “flight” and with a negative attitude.
traffic ? containing “traffic” and asking a question.
Limit Set the maximum number of tweets Integromat will return during one execution cycle.
Sort by

Select the type of search results you want to receive.

 mixed: Includes both popular and real-time results in the response.

 recent: returns only the most recent results in the response.

 popular: returns only the most popular results in the response.

Language Enter the ISO 639-1 code (2 characters) to restrict tweets to the desired language.
Until Enter the date to return tweets posted before the date. Use the YYYY-MM-DD format.
Geographical Coordinates

Returns tweets by users located within an entered radius of the specified latitude/longitude.

Include Entities

Enable this option to include entities in the result. For more information about entities please refer to the Twitter Entities documentation.

Create a Tweet

Posts a status message on Twitter.

Connection Establish a connection to your Twitter account.
Status Enter the content of your Twitter post. Max 280 characters.
Upload

Select whether you want to upload video or images file.

Source File

Map the file you want to upload from the previous module (e.g. HTTP > Get a File or Google Drive > Download a File), or enter the file name and file data manually.

Attachments

Use the Add item button to attach an image, video, or GIF file.
Select the Media Category that represents how the media will be used.

Size restrictions for uploading:

  • Image 5MB
  • GIF 15MB
  • Video 15MB
Attached images contain sensitive content (nudity, violence, etc). Enable this option if you upload Tweet media that might be considered sensitive content such as nudity, or medical procedures.
Geographic Latitude Enter the latitude of the location this Tweet refers to. This parameter will be ignored unless it is inside the range -90.0 to +90.0 (North is positive) inclusive.
Geographic Longitude Enter the longitude of the location this Tweet refers to. The valid ranges for longitude are -180.0 to +180.0 (East is positive) inclusive.
Display tweets coordinates Enable this option to put a pin on the exact coordinates a Tweet has been sent from.

List User Tweets

Returns tweets of a specified user.

Connection Establish a connection to your Twitter account.
Screen name Enter the screen name of the Twitter user whose tweets you want to retrieve, e.g. integromat.
Prevent replies from appearing in the returned timeline If this option is enabled, replies to the tweet will not be returned.
Include retweets Retweets are excluded by default. Enable this option to also return retweets by this module.
Limit Set the maximum number of tweets Integromat will return during one execution cycle.

Get a User Tweet

Retrieves a specified tweet.

Connection Establish a connection to your Twitter account.
Tweet ID Enter (map) ID of the tweet you want to retrieve details about.
Include Entities Enable this option to include entities in the result. For more information about entities please refer to the Twitter Entities documentation.
Include Extra Alternative Text If alt text has been added to any attached media entities, this parameter will return its value in the top-level key for the media entity. 
Include My Tweet Enable this option to include an additional current_user_retweet node, containing the ID of the source status for the retweet to any Tweets returned that have been retweeted by the authenticating user.
Include Card URI Enable this option to include a card_uri attribute when there is an ads card attached to the Tweet and when that card was attached using the card_uri value.

Delete a Tweet

Deletes a specified tweet.

Connection Establish a connection to your Twitter account.
Tweet ID Select or enter (map) the ID of the tweet you want to delete.

Retweet

Watch Retweets

Retrieves tweet details when a tweet has been retweeted.

Connection Establish a connection to your Twitter account.
Tweet ID Select or enter (map) the ID of the tweet you want to watch for retweets.
Limit Set the maximum number of retweets Integromat will return during one execution cycle.

List Retweets/Retweeters

Returns retweets of a specified tweet or user IDs of users who retweeted the tweet.

Connection Establish a connection to your Twitter account.
List Select whether you want to list retweets or retweeters of the specified tweet or your retweets. 
Tweet ID Select or enter (map) ID of the tweet you want to return retweets or retweeters for.
Limit Set the maximum number of retweets/retweeters Integromat will return during one execution cycle.

Retweet/Unretweet a Tweet

Connection Establish a connection to your Twitter account.
Choose Select whether you want to retweet or unretweet the tweet specified below.
Tweet ID Select or enter (map) the ID of the tweet you want to retweet or unretweet.

Follower

Watch Followers

Retrieves follower details when a user starts following a specified user or you.

Connection Establish a connection to your Twitter account.
List Followers Select whether you want to list followers by Screen Name or by User ID. 
Screen Name Enter the screen name of the Twitter user whose followers you want to retrieve, e.g. integromat. If the field is left empty, only your followers will be returned.
User ID Enter (map) the ID of the user whose followers you want to retrieve. If the field is left empty, only your followers will be returned.
Limit Set the maximum number of followers Integromat will return during one execution cycle.
Skip Status If you enable this option, user statuses will not be returned in the result.
Include User Entities Enable this option to include entities in the result.

List Followers

Retrieves followers of a specified user.

Please find the descriptions of the fields in the Watch Followers section above.

Favorite

Watch Likes

Retrieves like details when you or a specified user likes the tweet.

Connection Establish a connection to your Twitter account.
List Likes Select whether you want to list likes by Screen Name or by User ID. 
Screen Name Enter the screen name of the Twitter user whose likes you want to retrieve, e.g. integromat. If the field is left empty, only your likes will be returned.
User ID Enter (map) the ID of the user whose likes you want to retrieve. If the field is left empty, only your likes will be returned.
Limit Set the maximum number of likes Integromat will return during one execution cycle.
Include Entities Enable this option to include entities in the result.

List Likes

Returns the 20 most recent Tweets liked by you or a specified user.

Please find the descriptions of the fields in the Watch likes section above.

Like/Unlike a Tweet

Likes or unlikes a specified Tweet. Returns the liked Tweet when successful.

Connection Establish a connection to your Twitter account.
Choose To Select whether you want to like or unlike the Tweet.
(Unliked) Tweet ID Enter (map) or select the ID of the Tweet you want to like or unlike.
Include Entities Enable this option to include entities in the result.

Message

Watch Messages

Retrieves message details when you receive a new message.

Connection Establish a connection to your Twitter account.
Limit Set the maximum number of messages Integromat will return during one execution cycle.

Send a Message

Sends a direct message to a specified user.

Connection Establish a connection to your Twitter account.
User ID Enter (map) the ID of the user you want to send a message to. Retrieve the ID, for example, using the Search Users or List Pending Followers Requests modules.
Message Text Enter the text content of the direct message.

List Messages

Returns all messages (both sent and received) within the last 30 days. Sorted in reverse-chronological order.

Connection Establish a connection to your Twitter account.
Limit Set the maximum number of messages Integromat will return during one execution cycle.

Get a Message

Retrieves message details.

Connection Establish a connection to your Twitter account.
Message ID Enter the ID of the message you want to retrieve details about.

Delete a Message

Deletes a message.

Connection Establish a connection to your Twitter account.
Message ID Enter (map) or select the message you want to delete.

List

Watch Tweets in List

Returns tweet details when a new tweet is created on a specified list.

Connection Establish a connection to your Twitter account.
Search List Select whether you want to identify the list by a slug or by the list ID. If you decide to identify the list by a slug, you'll also have to specify the list owner.
List ID Enter (map) or select the list you want to watch for tweets.
Slug Enter the list slug. 
Select User Select whether you want to identify the user by User ID or by the Screen Name.
Include Entities Enable this option to also return entities. Entities are a variety of metadata about the tweet in a discreet structure, including: user_mentions, URLs, and hashtags. 
Include Retweets Enable this option to also return native retweets (if they exist) in addition to the standard stream of tweets.
Limit Set the maximum number of tweets Integromat will return during one execution cycle.

Add a Member to a List

Adds a member to a list. You must own the list to be able to add members to it.

Connection Establish a connection to your Twitter account.
List ID Enter (map) or select the list you want to add a member to.
Get User Select whether you want to identify the user by User ID or by the Screen Name. 

List Lists

Returns all lists you or the specified user subscribes to, including their own.

Connection Establish a connection to your Twitter account.
List Lists Select whether you want to identify the user by ID or by the screen name.
User ID/Screen Name Enter (map) the User ID or the Screen Name of the user that subscribed to the lists the module will return. Leave the field blank to return only your lists.
Reverse Enable this option to return owned lists first.
Limit Set the maximum number of lists Integromat will return during one execution cycle.

Mention

Watch Mentions

Returns tweet details when you are mentioned in a tweet.

Connection Establish a connection to your Twitter account.
Limit Set the maximum number of tweets Integromat will return during one execution cycle.

List Mentions

Returns the 20 most recent mentions.

Connection Establish a connection to your Twitter account.
Limit Set the maximum number of mentions Integromat will return during one execution cycle.

User

Get a User

Retrieves user details.

Connection Establish a connection to your Twitter account.
Get User Select whether you want to identify a user by their User ID or by the Screen Name. 
User ID / Screen Name Enter (map) the user ID or screen name of the user you want to retrieve details about.

Search Users

Provides a simple, relevance-based search interface to public user accounts on Twitter. Try searching by topical interest, full name, company name, location, or other criteria. Exact match searches are not supported.

Connection Establish a connection to your Twitter account.
Search Phrase Enter the search term.
Limit Set the maximum number of results Integromat will return during one execution cycle.

Update a Profile Image

Allows you to change your profile picture.

Connection Establish a connection to your Twitter account.
Source file Map the file you want to upload from the previous module (e.g. HTTP > Get a File or Google Drive > Download a File), or enter the file name and file data manually.

2019-10-16_14_33_30-Integration_Dropbox__Twitter___Integromat.png

Other

Make an API Call

Allows you to perform a custom API call.

Connection Establish a connection to your Twitter account.
URL

Enter a path relative to https://api.twitter.com. E.g. /1.1/statuses/home_timeline.json

For the list of available endpoints, refer to the Twitter Developer Docs.
Method

Select the HTTP method you want to use:

GET
to retrieve information for an entry.

POST
to create a new entry.

PUT
to update/replace an existing entry.

PATCH
to make a partial entry update.

DELETE
to delete an entry.

Headers Enter the desired request headers. You don't have to add authorization headers; we already did that for you.
Query String Enter the request query string.
Body Enter the body content for your API call.

Example of Use - List Home Tweets

The following API call returns the most recent Tweets and Retweets posted by you and the users you follow:

URL: /1.1/statuses/home_timeline.json

2019-10-16_14_47_49-Integration_Twitter___Integromat.png

Matches of the search can be found in the module's Output under Bundle > Body. 
In our example, 19 Tweets were returned:

2019-10-16_14_49_27-Integration_Twitter___Integromat.png

List Pending Followers Requests

Returns user IDs of every user following the authenticated user.

This module is especially powerful when used in conjunction with Make an API Call > GET /1.1/users/lookup.json, a method that allows you to convert user IDs into full user objects in bulk.
Connection Establish a connection to your Twitter account.
Limit Set the maximum number of followers Integromat will return during one execution cycle.

 

Common problems

Access to earlier tweets and messages

The Twitter triggers can only process a limited number of the most recent tweets and messages.

  • The Watch tweets and Watch retweets triggers can process up to 3,200 of the most recent tweets.
  • The Watch messages and Watch favorite tweets triggers can process up to 200 of the most recent tweets.
  • The trigger Watch mentions can process up to 800 of the most recent tweets.
  • The search module Search tweets allows to search for tweets that are up to one week old.

Earlier tweets and messages are ignored.

Processing is terminated with a 429: Rate limit exceeded error

Twitter allows every user to send a limited number of requests per a 15- minute interval from their account. If a user exceeds this limit, Twitter returns a 429 Rate limit exceeded error. If this happens, wait until the quota is renewed and run your scenario again.

The number of requests made when executing a scenario differs depending on the trigger used and the number of Tweets Integromat has to go through.

Was this article helpful?
1 out of 11 found this helpful
Menu
  • Features
  • Apps & Services
  • Templates
  • Pricing
  • What's new
  • Use cases
Information
  • Terms,  Privacy
  • FAQ
  • Help & Tutorials
  • Community
  • Affiliate Program
  • Blog
Developers
  • Developer Platform
Company
  • About the company
  • Join our team
  • Contact
Follow us
© 2020 Integromat by Celonis. All rights reserved. Integromat® is a registered trademark.
  • English