This Script will help user to stream/search/download tweets based on different tracks, search parameters, etc.

This script is developed in Python 3.6 using the following packages :

1. Flask
2. Tweepy
3. PyMongo
4. json
5. time
6. datetime
7. io

You will also need a running MongoDB client on your machine

To use this script -

1. Clone this repository.
2. Download all the packages required.
3. Run the script streamtest.py in command prompt.
4. Visit http://127.0.0.1:5000/ for the root access to the script.
5. Use different API endpoints as mentioned below for different works.

endpoint - /triggertweets?<arguments>

This endpoint will trigger a thread to stream all the tweets on a certain keyword present in the tweet text and store them in a database.

1. keyword - NECESSARY argument needed for this API. This is the keyword which would be searched in the tweet stream. example - /triggertweets?keyword=Modi
2. max_tweets - OPTIONAL argument to specify after how many tweets to stop the streaming. If not provided, default value 10 is taken. example - /triggertweets?keyword=Modi&max_tweets=50

endpoint - /gettweets?<arguments>

This endpoint can be used to search and analyse different tweets already present in the database or after adding the tweets using the 1st API. This endpoint will provide results by using pagination as the number of tweets could be really large. Using this API, we can - ..* Search for all tweets for a given keyword. ..* Search tweet texts to find a substring in a partical track. ..* Can apply filters such as sort , slice, dice, range filters, etc.

1. keyword - NECESSARY argument needed to search tweets based on that specific track. Will provide a Bad Request 400 if not provided.
2. limit - To limit the number of tweets displayed upfront. Can be varied. Default is 10.
3. offset - To tell which index tweet to start displaying with.
4. name - Search tweets by user's Display Name.
5. screen_name - Search tweets by user's Screen Name.
6. retweet_count - Search tweets with given minimum retweet count.
7. reply_count - Search tweets with given minimum reply count.
8. favorite_count - Search tweets with given minimum favorite count.
9. lang - Search tweets with given language (eg - en,hi,etc.)
10. sort_by - Sorts the output by the given field (id,created_at,text). Default is id.
11. order - order the sorted tweets in ASC(ending) or DESC(ending) order. Default is ASC.
12. date_start - Search tweets only after starting date (converted to timestamp for computation).
13. date_end - Search tweets only before ending date (converted to timestamp for computation).
14. search - Tells which string parameter to search in the tweets for a given substring.
15. search_type - Tells how to search the substring in the given parameter (starts,ends,contains). NECESSARY when search is not null.
16. search_value - Tells which substring to find in the given parameter. NECESSARY when search is not null.

endpoint - /download/gettweets?<arguments>

This endpoint works exactly like API 2 but instead of having the results displayed on the webpage, it downloads a CSV file containing the results. All the arguments and formats remain same as API 2.

Project Developed As Assignment for INNOVACCER. No rights have been reserved. In order to change/modify any content please contact me first. Clone and have fun using this script.