Posterous
tweetdeck is using Posterous to post everything online. Shouldn't you?
128x128y_thumb
 

What does "rate limit exceeded" mean? (UPDATED)

This is a question I am being asked more and more often so I thought I'd give you a brief overview of what it is, why it exists and what can be done about it. 

In order to control the use of the Twitter API (the service which provides the twitter data for 3rd party Twitter applications such as TweetDeck) Twitter sets a limit on how many times it can be used in an hour. This limit applies to your Twitter account rather than the applications which make the calls to the API i.e. you have 100 API calls per hour in total regardless of which Twitter applications you use - it is NOT 100 API calls per application. It is also important to note that this limit only applies to 3rd party Twitter applications, the twitter.com website does not use it's own API (mmm doesn't seem particularly fair) and therefore has no limits.

UPDATE: 3rd party applications obviously include desktop and web based twitter clients but less-obviously they also include that widget on your blog which shows the last few tweets you made, the facebook twitter application which cross posts your tweets to your facebook status etc etc essentially ANY software where you've entered your twitter username & password.

So what constitutes an API call? Strictly speaking every operation which communicates with Twitter is an API call, what we really need to know is which API calls have an impact on the 100 calls limit. The simplest  way to think about this is every call to the Twitter API which requests data will count towards your limit. So when TweetDeck updates the All Tweets, Replies or Direct Messages columns this would count as 1 call each as would viewing a twitterers profile (this actually costs two calls, one for the profile itself and one for the archive of their sent tweets).

Sending data to Twitter (posting), such as posting an update or a direct message, favoriting a tweet, unfollowing or following a user, does not count towards the limit and you can continue to do so even when your rate limit has been exceeded. Also, updates to the search, groups, twitscoop and 12seconds columns do not count towards the rate limit since the data does not (directly) come via the Twitter API.

If you use up your 100 API calls in the hour then you will see the "rate limit exceeded" message in TweetDeck and Twitter will not provide any updates until the hour is up. The All Tweets, Replies & DM columns in TweetDeck will appear to be frozen. At the end of the hour the rate limit will be reset and you will start getting updates again. You can view your rate limit status in the top right corner of TweetDeck.

So what can you do to avoid the "rate limit exceeded" message and what can you do if you get it? Unfortunately not very much. This is a Twitter enforced limitation rather than a TweetDeck one but I would suggest the following to reduce the risk:

  • only ever run one twitter application at a time, even if you're not using the others make sure they are closed
  • try not to over use the refresh button - this will cost you 3 calls per click (All Tweets, Replies & DMs)
  • UPDATE: try lowering the total % in the settings window, twitter API tab to around 60-70% - you'll get less frequent updates but you'll use less API
  • if you do get the rate limit exceeded message then make a note of your reset time shown in the top right corner of TweetDeck, TweetDeck will not get any updates until this time (so it might be a good opportunity to get a coffee) - you CAN continue to post messages, you just won't see any responses
  • also if you do get the rate limit exceeded, close down your twitter applications and then reopen then at the reset time (see above) 

UPDATE: great advice from @warzabidul "If people are having limit problems just get them to reset their password (on the twitter website)...Worked well for me when I reset the twitter password."

I hope this helps explain the API limit a bit more, it can get rather complicated. It's not an ideal scenario but if this control keeps Twitter running more stably then it's obviously worthwhile.

Posted by tweetdeck 

Comments (45)

Nov 07, 2008
Thank you for writing this...I just blew up my rate limit uh-gain. Is this a way to monetize tweetdeck by offering premium "unlimited API calls"?
Nov 07, 2008
Sorry, above comment should be "how to monetize TWITTER" not tweetdeck!
Nov 15, 2008
Dianne said...
I discovered the tweetdeck api settings last night after breaking my tweetdeck (RLE message lol) for like 20 mins. Of course, having a twitter party where tweets were flying fast and furiously didn't help :)

I've reset to 35%, 35%, 20%, realizing it's still at 90% but so far so good!

Thanks for the info here though - it does explain a lot!

Dec 09, 2008
D. James Albert said...
Thanks, I just experienced this issue and your post helped me clarify what to do. Much appreciated.
Dec 09, 2008
Gwnn said...
I'd like to suggest that when you hit the max and freeze that there IS something you can do about it. You can revert to the browser and keep on tweeting. You don't HAVE to be held hostage by TweetDeck.
cheers
Dec 11, 2008
GirlPie said...
Agree with Gwnn but more specifically, when you exceed your API on TweetDeck, close it, log onto Twitter proper (where there is no API limit) and carry on for awhile before checking back with TD (upper right hand corner shows your time left.)
ALSO -- wouldn't it be smart if, instead of or along with using our names/emails in comments, why don't we use our @Twitter names -- I'm @TheGirlPie, and I know that TwiTip does this and it's great for building a community.
Thanks for a great product -- the only one that makes sense, makes it useful, easy, and productive + fun.
Dec 14, 2008
Kevin said...
this is strange... i am developing a mashup with twitter and many times it gives me that error message,,thats irritating...they must have to fix that and allow applications to request as many call as they want.. hope in future they will fix it
Dec 18, 2008
The Stepster said...
thanks a lot! i've been wondering about this =)
Dec 18, 2008
Twitter should charge users for larger volumes. I would happily pay a subscription fee for say 200 calls per hour. With a Twitter widget on my blog, they get eaten up quickly.
Dec 18, 2008
Daniel M. Clark said...
Kevin, the API isn't broken, it's not something they 'must have to fix'. The restriction to 100 calls is intentional so that people aren't constantly hammering the servers and crashing the system. As Twitter gets larger, they'll either increase the limit or charge users for increased calls - they have to make money eventually, this is pretty much a no-brainer.
Jan 03, 2009
@HughBriss said...
I can live with occasional exceeded limits on TweetDeck but the one that bugs me is when my limit is exceeded and I just have a nice unattractive big black box on my blog where my Twitter widget is.
Jan 17, 2009
Harrison Powers said...
Thanks for this write-up, I've been wondering how the API limit worked.
Jan 31, 2009
There's just one thing I'm confused about--when it starts updating again, does it grab everything that you missed in that time period, or does it start fresh from that point? @kelleyonline
Feb 11, 2009
@jandsy said...
Thanks for this. was wondering too. Glad to have it explained x
Feb 11, 2009
@Trukindog said...
I've been having this prob. & a friend linked me here. Great info here but it says I should get a limit exceeded message & have a limit status in the top right, I have never seen either? can you explain?
Feb 11, 2009
@Trukindog said...
I would also like to know what Tweet Shrink does w/o blindly trying it?
Feb 21, 2009
Rex Harris said...
Thanks for the information, this explains a few things. I've also noticed a few conflicts here and there between Twitter, TweetDeck and other apps. Seems like the numbers get crossed at times.
Feb 27, 2009
Brumpie said...
But why is it, that at initial startup, with 3 columns, Tweedeck immediately used 84 from 100 API's ??
Mar 12, 2009
 said...
I love tweetdeck. Thanks for this article and promptly sharing this when I posted questions on twitter.
Mar 12, 2009
Brumpie said...
It's working fine now
Mar 12, 2009
@Trukindog said...
I got mine figured out.
Apr 12, 2009
johntom2000 said...
I finallly had to reset mine to 35,35,20 and hoping it will reset it self. Anyone knows the orignal settings?
Apr 13, 2009
twitteraddict said...
60 5 10 is the original setting
Apr 16, 2009
jackswann said...
Do your custom searches add to your api count?
Apr 17, 2009
Kelly said...
Thank you very much for this post! It really helped me out :)
Apr 20, 2009
Rachel said...
Thank you, I've just exceeded my own rate limit, and was wondering what was up. Very useful post, good job. :)
Apr 21, 2009
pixie said...
thanks for a great explanation ... i love tweetdeck, but 100 is just to few and very frustrating :(
Apr 23, 2009
Drolgerg said...
Thanks for taking the time to explain this, & so clearly. This has been bothering me for a while, you've been a great help
Apr 27, 2009
 said...
Wonderful! Thanks!
Apr 27, 2009
Curt Bizelli said...
Thank you very much. I finally know what this means, and I was able to take action on it by adjusting my API settings.
Apr 27, 2009
Curt Bizelli said...
My question now is: From top of the hour to the next? or from the time you login to twitter and the proceeding hour (no matter what time it is)? - @csi_talent
Apr 28, 2009
Simon said...
With the default settings I got of 60 60 60, the API times out in like 15 minutes even if left idle, I have readjusted down to 30 10 10 and i'll see what happens once it refreshes.
May 04, 2009
SaKiWhi said...
das ist doch mist... was soll das limit??? so macht das doch kein spaß!!!
May 07, 2009
discohospital said...
Thanks for this post - at first I was really puzzled by the API settings, not realizing why it would be a problem to refresh it every minute for each setting ;D
Well done! :)
May 08, 2009
earmstrong said...
Thanks for the info. Just exceeded my API for the first time. This is really helpful and easy enough for non-tech tweeps like me to understand.
May 13, 2009
LizStrand said...
I understand it, but I don't like it (apparently just used my last API for this sign-in)...especially when it happens on my iPod Touch, where the web version is horrible. If I start looking on Tweetie, seeing who people are following, check out their tweets, etc., to see if I want to follow any of them, I am shut down in no time!

Also becomes a problem, because searches don't always work right. For example, I use Twittelator on my phone for it's fantastic subgroups, similar to what TweetDeck offers, and it goes back further in time than when I have tried using TweetStack for this function. However, some people just don't show up. I am not proud to say that I have a little "MTV" subgroup. For some reason, comments from @LaurenConrad do not show up in searches, so the only way to include her in the group is to have it pull from the server, but that eats half my API in one second. If the searches don't work correctly, limiting the API doesn't seem right (not that they need to answer to what I think seems right!). Unfortunately, Spencer Pratt's updates show up just fine in the search, and I merely have him in there for entertainment purposes. This is only one example - it happens a lot on more relevant subgroups that I have too, having nothing to do with mindless reality shows. Can't win...

(If API limits must exist, I too would be happy to have a subscription fee to exceed them...)

May 20, 2009
Great thanks. I was wondering what was wrong. I am back to 40%
May 28, 2009
laimaitai21 said...
I got rid of my 'direct mesages' column on tweet deck and reset my 'all friends' and 'at replies' to 50% each...and made DM's 0...I don't seem to get the exceed API anymore...
Jun 04, 2009
I'm working with a really LOW setting in API now due to following a lot of people. I usually receive 60-100 tweets on avg. in 1 update! It's tough to keep up with - actually can't completely so I've enlisted the help of TweetLater.com as well. But, nevertheless, I am still getting my kicks out of Twitter via TweetDeck, and I do personally TWEET on top of my "autos". Blessings to all!
Jun 04, 2009
 said...
I don't understand how you can set your API settings to 50/50 = Tweets/Replies ... and leave out DMs. I see a couple of problemos by doing this. For one, you're not leaving any room for viewing profiles (which I like to do "within" tweetdeck), Two, just doesn't make sense! You must have a really low following and you'll find that as you follow more people you'll have to actually "lower your TOTAL under 100%". Finally, You're leaving out people's messages by disabling DMs. These are important messages! Blessings to All!
@CSI_Talent
Jun 05, 2009
Ashmi said...
I'm noticing today that one Tweet at 11: 52a and a second at 12:46, no @Replies, no DMs is coming in "rate limit exceeded." What the heck?
Jun 08, 2009
me again said...
If u have just over 1,000 followers, whats a good api setting to have? to help avoid the 'rate limit'?

Cos i keep gettin that 'come back in a hour' and its frustrating.

Jun 12, 2009
Cindy said...
Thank you for such a clear explaination - I just exceeded my limit. Not a lot of followers, not linked to much, and don't myself tweet much but rather read alot.

This was very confusing and frustrating when it happened!

Jul 09, 2009
SimonP said...
Somehow my Deck has a Blink182 background and soundscheme - how can I get rid of it? The noise is awfully distracting
Sep 11, 2009
Gaelle said...
Thank you sooo much !

Leave a comment...

 
Got an account with one of these? Login here, or just enter your comment below.
Posterous-login    twitter