Connecting to Twitter


In BIME, you can import data directly from your Twitter account. 

Support tip: Phillipa Booth shares her knowledge on Twitter reporting in her tip, Measuring the impact of images in tweets.
This article covers the following sections:

Adding a Twitter connection

When you create a new Twitter connection in BIME, you can import data about your followers, profile, and Twitter searches. 

To create a Twitter connection

  1. In the Data sources library (), click the + button to add a new connection. 
  2. Select the Twitter icon (). 
  3. Enter a name for your connection and select a category. 
  4. To connect to your Twitter account, click Authenticate with Twitter.

  5. Enter your credentials, then click Allow.
  6. You can now select your datasets. There are five different tabs you can select from. The tabs are:
      • User Timeline
      • Mentions Timeline
      • Followers List
      • Users Lookup
      • Search Tweets

  7. Enter the necessary information to retrieve your dataset. The image below shows the information required for Search Tweets.

  8. When you are finished, click Next.
  9. Select your Storage settings. You cannot edit the schema for this data source. 
  10. Select the Advanced tab to edit cache, time zone, and Query blender options.
  11. Click Save to finish building your connection. If you do not click Save, your connection will not be established.

If you are encountering errors, see the section below for information on Twitter limitations. 

Twitter limitations and Dynamic Count

Twitter datasets contain key numbers for the Dynamic Count calculation and specific limitations on results. 


Access to the Twitter API is limited to a subset of the most recent results for the account. There are also limits on the number of queries you can fire at the API. You should always put your Twitter connections in the cache or other data storage options to refresh them frequently.

The limitations are:

  • User Timeline: Last 3,200 tweets.
  • Mentions Timeline: Last 800 mentions for the account, including both direct replies and '@-ing in'.
  • Follower List: Last 3,000 followers to start following the account. 
  • User Lookup: Profile stats (statuses, followers, etc) for one or more accounts. 
  • Search Tweets: Hashtags and regular terms, capped at 18,000 results. 

The date field will always be the created date. For example, in Followers List, the date shown for a follower will be the date their account was created, not the date they started following you. 

If you have already connected to Twitter, but your data isn't importing or is importing very slowly, it might be the result of the following issues:

  • Your Twitter contains large amounts of data.
  • You have created or refreshed several Twitter connections during a short time period. Each time you refresh your data, including when you first authenticate the connection, BIME makes a direct call to Twitter. Making several calls in a short timespan can reduce performance. 
  • You have exceeded the Twitter quota and rate limits. 

Dynamic count

The key numbers for each kind of connection are: 
  • User Timeline is the number of tweets. 
  • Follower List is the number of followers. 
  • Mentions Timeline is the number of mentions.
  • User Lookup is the number of accounts tracked.
  • Search Tweets is the number of tweets.
You can also differentiate all account tweets, including retweets and just the original content, by using the formula below:
IF ([Is a retweet]="false") THEN SUM (Dynamic Count) ENDIF

Have more questions? Submit a request


Please sign in to leave a comment.
Powered by Zendesk