Twitter High level scraper for humans.
- NO LIMIT, NO API required
- Fast and easy to use
- Working with python 3.5+
- Integrated with pandas for data science research
Manual install via git :
$ git clone https://github.com/0x0ptim0us/twpy.git
$ cd twpy
$ python setup.py installInstall using pip:
$ pip install twpy
# or
$ python -m pip install twpyGuidance of using Twpy :
>>> from twpy import TwpyClient
>>> from twpy.serializers import to_pandas
>>>
>>> # create twpy client object
>>> tc = TwpyClient()Get twpy current version :
>>> tc.__version__
'1.2.1'Get user followers:
>>> # get user followers, limited up to 50
>>> # interval : delay between each request, default is 0 for no delay
>>> # proxy : send traffic through proxy, default is none
>>> followers_data = tc.get_followers(username="elonmusk", limit=50, proxy="127.0.0.1:8080", interval=1)Get user timeline:
>>> tweets = tc.get_timeline(username="elonmusk", limit=50)Get user profile:
>>> user_info = tc.get_user(username="elonmusk")Convert result object to other data structures :
>>> # convert result to pandas data frame, json and list
>>> # pandas
>>> pandas_sample = to_pandas(followers_data)
>>> # json
>>> json_sample = to_json(followers_data)
>>> # list
>>> list_sample = to_list(followers_data)Search example:
>>> # search user tweets until 2015
>>> tweets = tc.search(username="elonmusk", until="2015")
>>> # add limit and interval
>>> tweets = tc.search(username="elonmusk", until="2015", limit=100, interval=1)
>>> # search tweets contains `love` word
>>> tweets = tc.search(query="love", limit=100, interval=1)
>>> # search tweets which contains `love` word and were tweeted since 2015-01-01
>>> tweets = tc.search(query="love", since="2015-01-01", limit=10)| method | description |
|---|---|
| get_followers() | get user followers |
| get_friends() | get user followings/friends |
| get_timeline() | get user timeline/tweets |
| get_user() | get user profile info |
| search() | search tweets with query and username |
Fardin Allahverdinazhand - @0x0ptim0us - [email protected] Distributed under the MIT license. see LICENSE.txt for more information.