tweety

Twitter's API is annoying to work with, and has lots of limitations — luckily their frontend (JavaScript) has it's own API, which I reverse–engineered. No API rate limits. No restrictions. Extremely fast.

Prerequisites

Before you begin, ensure you have met the following requirements:

• Internet Connection
• Python 3.6+
• BeautifulSoup (Python Module)
• Requests (Python Module)

All Functions

• get_tweets()
• get_user_info()
• get_trends() (can be used without username)
• search() (can be used without username)
• tweet_detail() (can be used without username)

Using tweety

Getting Tweets:

Description:

Get 20 Tweets of a Twitter User

Required Parameter:

• Username or User profile URL while initiating the Twitter Object

Optional Parameter:

• pages : int (default is 1,starts from 2) -> Get the mentioned number of pages of tweets
• include_extras : boolean (default is False) -> Get different extras on the page like Topics etc

Output:

• Type -> dictionary

• Structure

    {
      "p-1" : {
        "result": {
            "tweets": []
        }
      },
      "p-2":{
        "result": {
            "tweets": []
        }
      }
    }

Example:

python
Python 3.7.3 (default, Mar 26 2019, 21:43:19) 
[GCC 8.2.1 20181127] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> from tweet import Twitter
>>> all_tweet = Twitter("Username or URL").get_tweets(pages=2)
>>> for i in all_tweet:
...   print(all_tweet[i])

Getting Trends:

Description:

Get 20 Locale Trends

Output:

• Type -> dictionary

• Structure

  {
    "trends":[
      {
        "name":"
      
       "
      ,
        "url":"
      
       "
      
      },
      {
        "name":"
      
       "
      ,
        "url":"
      
       "
      
      }
    ]
  } 

Example :

python
Python 3.7.3 (default, Mar 26 2019, 21:43:19) 
[GCC 8.2.1 20181127] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> from tweet import Twitter
>>> trends = Twitter().get_trends()
>>> for i in trends['trends']:
...   print(i['name'])

Searching a keyword:

Description:

Get 20 Tweets for a specific Keyword or Hashtag

Required Parameter:

• keyword : str -> Keyword begin search

Optional Parameter:

• latest : boolean (Default is False) -> Get the latest tweets

Output:

• Type -> list

Example:

python
Python 3.7.3 (default, Mar 26 2019, 21:43:19) 
[GCC 8.2.1 20181127] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> from tweet import Twitter
>>> trends = Twitter().search("Pakistan")

Getting USER Info:

Description:

Get the information about the user

Required Parameter:

• Username or User profile URL while initiating the Twitter Object

Optional Parameter:

• banner_extensions : boolean (Default is False) -> get more information about user banner image
• image_extensions : boolean (Default is False) -> get more information about user profile image

Output:

• Type -> dict

Example:

python
Python 3.7.3 (default, Mar 26 2019, 21:43:19) 
[GCC 8.2.1 20181127] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> from tweet import Twitter
>>> trends = Twitter("Username or URL").get_user_info()

Getting a Tweet Detail:

Description:

Get the detail of a tweet including its reply

Required Parameter:

• Identifier of the Tweet -> Either Tweet URL OR Tweet ID

Output:

• Type -> dict
• Structure

  {
    "conversation_threads":[],
    "tweet": {}
  }

Example:

python
Python 3.7.3 (default, Mar 26 2019, 21:43:19) 
[GCC 8.2.1 20181127] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> from tweet import Twitter
>>> trends = Twitter().tweet_detail("https://twitter.com/Microsoft/status/1442542812197801985")

Updates:

Update 0.1:

• Get Multiple Pages of tweets using pages parameter in get_tweets() function
• output of get_tweets has been reworked.

Update 0.2:

• Again reworked and simplified tweets in get_tweets function 😜
• Added tweet_detail function for getting details about a tweet including replies to it

Update 0.2.1:

• Fixed Hashtag Search