OSoMe Twitter library for academic researchers
Project description
Introduction
The OSoMeTweet project intends to provide a set of tools to help researchers work with Twitter's V2 API.
The Wiki includes a detailed documentation of how to use all methods. Also, we will use the wiki to store knowledge gathered by those who are building this package.
Installation
Install the PyPI version
pip install osometweet
Warning 1: The package is still in development, so not all endpoints are included and those which are included may not be 100% robust. Please see the list of issues for known problems.
Warning 2: We will try to keep the interface of the package consistent, but there may be drastic changes in the future.
Use the newest features & local development
The PyPI version may be behind the GitHub version. To ensure that you are using the latest features and functionalities, you can install the GitHub version locally.
To do so, clone this project, go to the source directory, and run pip install -e .
If you want to do this with git
it should look something like the below, run from your command line:
git clone https://github.com/osome-iu/osometweet.git
cd ./osometweet
pip install -e .
Requirements
python>=3.5
requests>=2.24.0
requests_oauthlib>=1.3.0
Tests
Go to tests
directory and run:
python tests.py
Note: you will need to have the following environment variables set in order for the tests to work properly.
- TWITTER_API_KEY
- TWITTER_API_KEY_SECRET
- TWITTER_ACCESS_TOKEN
- TWITTER_ACCESS_TOKEN_SECRET
- TWITTER_BEARER_TOKEN
If you're not sure what these are, check out this page to learn how Twitter authentication works.
How to seek help and contribute
OSoMeTweet will be a community project and your help is welcome!
See How to contribute to the OsoMeTweet package for more details on how to contribute.
Quick start
Here is an example of how to use our package to pull user information:
import osometweet
# Initialize the OSoMeTweet object
bearer_token = "YOUR_TWITTER_BEARER_TOKEN"
oauth2 = osometweet.OAuth2(bearer_token=bearer_token)
ot = osometweet.OsomeTweet(oauth2)
# Set some test IDs (these are Twitter's own accounts)
ids2find = ["2244994945", "6253282"]
# Call the function with these ids as input
response = ot.user_lookup_ids(user_ids=ids2find)
print(response["data"])
which returns a list of dictionaries, where each dictionary contains the requested information for an individual user.
[
{'id': '2244994945', 'name': 'Twitter Dev', 'username': 'TwitterDev'},
{'id': '6253282', 'name': 'Twitter API', 'username': 'TwitterAPI'}
]
Learn how to use the package
Documentation on how to use all package methods are located in the Wiki.
Start here before using the example scripts!
Learn about Twitter V2
We have documented (and will continue to document) information about Twitter's V2 API that we deem is valuable. For example:
- Details on Twitter's new fields/expansions parameters
- Available Endpoints
- HTTP Status Codes and Errors
- Academic Track Benefits and Details
Example Scripts
We offer example scripts for working with different endpoints. We recommend that you read and understand the methods by reading the relevant package Wiki pages prior to using these scripts.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.