RapidAPI logo

Botometer Pro

FREEMIUM
By OSoMe
Updated 6 months ago
Social
9.4/10
Popularity Score
4172ms
Latency
99%
Success Rate

Botometer Pro API Overview

Botometer 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. This is the pro version of our Botometer API; we also have a free version that doesn't require a credit card.

Contact API Provider
star-blueRate

Botometer Pro Overview

As compared to the Free API, this Pro API provides a paid tier with significantly higher rate limits: 43,200 requests per day for the pro tier, and 17,280 per day for the basic tier. These rate limit tiers reflect Twitter Search API's user-authenticated and app-authenticated ratelimits, respectively.

Users of the basic tier do not incur a monthly fee if they stay below the daily quota; both tiers enable users to exceed their daily quota for $1/1k requests. Users are free to switch between the plans at will without having to change the endpoint in their code.

Besides significantly higher ratelimits, the pro API does not currently offer any additional functionality as compared to the free API, but that may change in the future.

For answers to questions about the Botometer service in general, please refer to our website's FAQ. For more info on the Mashape API specifically, please refer to our free API documentation for help.

Why two APIs?

When adding a paid API option, Mashape requires all users -- even free users -- to provide a credit card. Since we value the ability for our users to use our free service without entering their CC info, we're forced to have two separate APIs.

Using botometer-python

You can easily use the Pro API with our botometer-python client library by specifying botometer_api_url in the constructor:

botometer_api_url = 'https://botometer-pro.p.mashape.com'
bom = botometer.Botometer(botometer_api_url=botometer_api_url,
                          wait_on_ratelimit=True,
                          mashape_key=mashape_key,
                          **twitter_app_auth)

In order to make use of the higher ratelimits allowed with the paid tier of the Pro API, you probably also want to use app-only authentication for the Twitter API. For complete info, see this wiki page on our GitHub.

Install SDK for NodeJS

Installing

To utilize unirest for node.js install the the npm module:

$ npm install unirest

After installing the npm package you can now start simplifying requests like so:

var unirest = require('unirest');

Creating Request

unirest.post("https://botometer-pro.p.rapidapi.com/2/check_account")
.header("X-RapidAPI-Host", "botometer-pro.p.rapidapi.com")
.header("X-RapidAPI-Key", "SIGN-UP-FOR-KEY")
.header("Content-Type", "application/json")
.send({"user":{"id":"1234567890","screen_name":"IUNetSci","...":"..."},"timeline":[{"id":1234567890,"text":"@Botometer is so cool!","...":"..."},"..."],"mentions":[{"id":9876543210,"text":"@TruthyAtIndiana is also cool!","...":"..."},"..."]})
.end(function (result) {
  console.log(result.status, result.headers, result.body);
});
OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication