Private API

Botometer (formerly Truthy BotOrNot) checks the activity of a Twitter account and gives it a score based on how likely the account is to be a bot. Higher scores are more bot-like.

  • New version of Botometer coming May 10

    published 8 months ago

    We're excited to announce that we'll be rolling out a new version of the Botometer classifier on May 10!

    What's changing?

    • More accurate classification so we'll be better able to detect more sophisticated bots, as well as some types of simple bots that we were missing.
    • Adding a new "Complete Automation Probability." This answers the question everybody really wants to know: "what's the probability that this account is a bot?
    • Bot scores will be calculated and presented differently. Instead of a percentage, bot scores are moving to a 0-to-5 scale. We are also changing the method for calculating bot scores so that it better compliments the new CAP probability. Researchers and others gathering bot scores in bulk should read the caveat below.
    • We are lowering the Free API quota. In order to discourage abuse, we're lowering the website and free API quota to 2,000 requests per day. Heavy users should migrate to the Pro API's basic tier which does not have a monthly fee and will continue to use the 17,280 request per day quota.

    What's not changing?

    • The website will stay mostly the same.
    • The API will stay mostly the same, with a couple of fields corresponding to these new features.

    A note for researchers

    Due to the change in classifiers, bot scores before and after this rollout will be basically uncomparable. We encourage you to finish up any bulk collection you're currently running, and hold off on starting new such efforts until after we perform this upgrade.

    We do not expect future upgrades to break compatibility.

  • Ratelimits fixed

    published 2 years ago

    Our API is designed to provide 17,280 requests per day, per user, under the free tier [1]. A bug was causing some users to unexpectedly low ratelimits for the last several days. This issue has been fixed. Thanks to the users that brought this issue to our attention! As always, please let us know if you continue to have problems.

    [1]: This is the same as the Twitter user-authenticated API ratelimit of 180 requests per 15-minute window.

  • We're free again!

    published 2 years ago

    Recently, we added a freemium subscription tier to this API in order to support customers who wanted to pay for elevated access. Consequently, and unexpectedly for us, Mashape started requiring credit cards for all users of our API. We've reverted back to only having a free tier for this API, and we'll add a differently named but functionally identical API on Mashape Marketplace for those who want a the freemium product.

    Thanks for understanding, Clayton (@clayadavis)