Danbooru

New API rate limiting rules

Posted under Bugs & Features

Some new rules about how the API is rate limited went into effect today.

The gist is this: reads are no longer rate limited. Some updates are rate limited. This means simply using the site you shouldn't run into these limits, but if you were heavily updating pools, posts, wiki pages, etc you may run into them. Notable exceptions (currently) for rate limiting including voting and favoriting.

The rate limiting rules, in general, is as follows:

  • Basic users: 1 update/second
  • Gold users w/API key: 2 updates/second
  • Platinum/Builder/Mod w/API key: 4 updates/second

In addition, users have a burst pool where they can make several consecutive updates without being rate limited. This is again dependent on user level:

  • Basic users: 10 updates at once
  • Gold users w/API key: 30 updates at once
  • Platinum/Builder/Mod w/API key: 60 updates at once

This pool is slowly regenerated according to the rate limiting rules mentioned above.

All of this is subject to change. If you are running into this rate limit unreasonably often, please post about it here so I can tweak the numbers as needed. Thanks.

Running into this rate limit unreasonably often. Not sure how much detail is needed, so I'll just say that my API Limit showed 10.0/10 for a long period of time. It turned to 9.0/10 briefly after 10 to 20 minutes then change back again after one update. The regenerate button does nothing as far as I can see. Need more clarification on what these values mean and how often this system is supposed to create/update/regenerate.

Updated

@boomm you probably don't want that public, for the record.

The API request limit is tangentially related to the problem at hand, it just seems like there s a time desync on the server end as Type mentioned, I believe. More discussion in the stickied issues topic.

Etch64 said:

Weird. My limit is stuck at 9, and now tag edits are apparently locked away from my prying eyes.

One has nothing to do with the other. FWIW, the API limit for Member-level accounts is a burst of 10 with a regen rate of 1 per second (Member#Misc). The visualization of that from your profile page is subaccurate, and is usually stuck at one minus what you're burst limit is which is 9 for you.

As far as the tag edits go, do you mean accessing the tag box, or do you mean accessing the tag history? If it's the former, then you need to use the "E" hotkey or click the edit link below the picture. If it's the latter, then make sure you're clicking the Tags link under History, and that it's taking you to the page with post_versions in the URL. If the latter is still causing you issues, then please report back on what specific error message you're getting.

Apparently I haven't looked up hotkeys for this site. Thanks for the heads-up.

I was accustomed to the Edit link under each post, which I no longer see, making edits nigh impossible on my mobile.

1