Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/f4rih/twpy
Twitter High level scraper for humans.
https://github.com/f4rih/twpy
scraper twitter twitter-api twitter-bot twitter-python
Last synced: 2 months ago
JSON representation
Twitter High level scraper for humans.
- Host: GitHub
- URL: https://github.com/f4rih/twpy
- Owner: f4rih
- License: mit
- Created: 2019-12-15T12:03:40.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2020-03-10T17:41:30.000Z (almost 5 years ago)
- Last Synced: 2024-11-07T23:58:16.127Z (3 months ago)
- Topics: scraper, twitter, twitter-api, twitter-bot, twitter-python
- Language: Python
- Size: 38.1 KB
- Stars: 62
- Watchers: 7
- Forks: 8
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
Twpy
====
 
Twitter High level scraper for humans.
Features
--------
- NO LIMIT, NO API required
- Fast and easy to use
- Working with python 3.5+
- Integrated with pandas for data science research
Installation
------------
Manual install via git :
```bash
$ git clone https://github.com/0x0ptim0us/twpy.git
$ cd twpy
$ python setup.py install
```
Install using pip:
```bash
$ pip3 install twpy
# or
$ python3 -m pip install twpy
```
Usage
-----
Create Twpy object :
```python
from twpy import TwpyClient
# create twpy client object
tc = TwpyClient()
```
with proxy :
```python
# or you can pass proxy
tc = TwpyClient(proxy="127.0.0.1:8080")
```
Get twpy current version :
```python
tc.__version__
# '1.2.4'
```
Get user followers:
```python
# 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, interval=1)
```
Get user timeline:
```python
tweets = tc.get_timeline(username="elonmusk", limit=50)
```
Get user profile:
```python
user_info = tc.get_user(username="elonmusk")
```
Convert result object to other data structures :
```python
from twpy.serializers import to_pandas, to_json, to_list
# 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:
```python
# 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)
```
# Supported methods
| method | description |
|--|--|
| 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 |
Meta
----
Fardin Allahverdinazhand - [\@0x0ptim0us](https://twitter.com/0x0ptim0us) - <[email protected]> Distributed under the MIT license. see [LICENSE.txt](https://github.com/0x0ptim0us/twpy/blob/master/LICENSE.txt)
for more information.