Skip to main content

A package to programmatically query a twitter user on BotSentinel

Project description


PyBotSentinel is an API wrapper for BotSentinel. It's simple in functionality as at this point, it only provides you a rating, and the description of what that rating means to BotSentinel.


This requires Python 3.6 and above, and was built on Python 3.8. It requires requests, ScraPy


I recommend you install this via pip3 (PyPi)

$ pip3 install py3botsentinel

Getting Started and Finished

import pybotsentinel
query = pybotsentinel.PyBotSentinel()

rating = query.get_bot_rating('realdonaldtrump')
>>> rating
[True, 30, 'Moderate', 'Our analysis has concluded realdonaldtrump exhibits moderate tweet activity and is not a trollbot account.']


If you end up getting an occasional 403 while querying, it's most likely due to a race condition as a result of making the GET request to the page to get the one-time-key for BotSentinel's backend API, the next key generates before the POST call is made, the POST call to the API is made, and the API returns a JSON object of {'success': False, 'bot_rating': 'INCORRECT_DATA'} with a HTTP status code code of 403. If a subsequent query is made for the same user, it will succeed and return the user's bot rating.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release. See tutorial on generating distribution archives.

Built Distribution

py3botsentinel-0.0.1-py3-none-any.whl (14.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page