Twitter/Intro_Collecting_Tweets.ipynb

{
 "cells": [
  {
   "cell_type": "code",
   "execution_count": 83,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "import sys\n",
    "import json\n",
    "import time\n",
    "import string\n",
    "\n",
    "from tweepy import API\n",
    "from tweepy import OAuthHandler\n",
    "\n",
    "from tweepy import Cursor\n",
    "\n",
    "from tweepy import Stream\n",
    "from tweepy.streaming import StreamListener"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Accessing Twitter Data\n",
    "* Authentication\n",
    " * Performed using  `Open Authorization (OAuth)` which involves communication between the user, the consumer (app) and the resource provider (Twitter in this case). \n",
    "* Data Collection\n",
    "* Data Cleaning\n",
    "\n",
    "\n",
    "## API\n",
    "* REST (Representational State Transfer) APIs \n",
    " * Allow us to read already existing Tweets. Keep in mind that there are limits on har far back in time we can search.\n",
    " * Useful for looking at a certain user.\n",
    "* Streaming APIs\n",
    " * Allow us to retrieve all the tweets that have been published since we opened an HTTP connection.\n",
    " * useful for listening to a live event.\n",
    " \n",
    "`Tweepy` is a Python client used to implement different types of calls to the desired API."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Your twitter API keys and tokens  \n",
    "\n",
    "In order to access Twitter data we need to go to the [Application Management Page](https://apps.twitter.com/) to register your APP.\n",
    "\n",
    "Your [Keys and Access Tokens](https://dev.twitter.com/oauth/overview) will be available once your app is registered.\n",
    "\n",
    "For more information look [here](https://dev.twitter.com/)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "# One option is to place your comsumer key, secrets, access token and secret in a local file \n",
    "# that we will call `config.py`.\n",
    "from config import *\n",
    "\n",
    "# contents of config.py\n",
    "\n",
    "# consumer_key    = 'XXXXXXXXXXXXXXXXXXXXX'\n",
    "# consumer_secret = 'XXXXXXXXXXXXXXXXXXXXX' \n",
    "# access_token    = 'XXXXXXXXXXXXXXXXXXXXX'\n",
    "# access_secret   = 'XXXXXXXXXXXXXXXXXXXXX'"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 85,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "# Authentication\n",
    "def get_twitter_auth():\n",
    "    \"\"\"Setup Twitter Authentication.\n",
    "    \n",
    "    Return: tweepy.OAuthHandler object\n",
    "    \"\"\"\n",
    "    auth = OAuthHandler(consumer_key, consumer_secret)\n",
    "    auth.set_access_token(access_token, access_secret)\n",
    "    return auth\n",
    "    \n",
    "def get_twitter_client():\n",
    "    \"\"\"Setup Twitter API Client.\n",
    "    \n",
    "    Return: tweepy.API object\n",
    "    \"\"\"\n",
    "    auth = get_twitter_auth()\n",
    "    client = API(auth)\n",
    "    return client\n",
    "\n",
    "client = get_twitter_client()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# REST API"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Going through Timelines"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 86,
   "metadata": {
    "collapsed": false,
    "scrolled": true
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "1.)   RT @TimOfLegend: If you could make a human centipede using only 3-headed dogs, it could be a fun way to teach fractals to kids.\n",
      "\n",
      "2.)   Trump, Putin, &amp; the hidden history of how Russia interfered in the US Presidential election: https://t.co/BxfjkMDLev #RussiaHacking #Estonia\n",
      "\n",
      "3.)   I might have to try something like this in my DSP class.\n",
      "\n",
      "https://t.co/9c3dwVzVe0\n",
      "\n",
      "4.)   When it comes to #Healthcare, #BigData is a Big Deal: https://t.co/yDg6tdtvwQ #Analytics #HealthIT #DataScience… https://t.co/SdBVKE96Cn\n",
      "\n",
      "5.)   TV dilemma? #NFCChampionship or #MythBustersSearch testing a classic w/explosives. We've got encores, https://t.co/EmwEYkpkfn &amp; your DVR.\n",
      "\n"
     ]
    }
   ],
   "source": [
    "time.sleep(900) # sleep for 15 mins.\n",
    "\n",
    "for i, status in enumerate(Cursor(client.home_timeline).items(5)): \n",
    "    print('{0}.)   {1}\\n'.format(i+1, status.text))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Getting Tweets"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 90,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "\"\"\"If you get: TweepError: Twitter error response: status code = 429\n",
    "Then you have exceeded your\n",
    "\"\"\"\n",
    "with open('home_timeline.jsonl','w') as f:\n",
    "    for page in Cursor(client.home_timeline, count=200).pages(4): # limit of 800 for you\n",
    "        for status in page:\n",
    "            f.write(json.dumps(status._json)+'\\n')\n",
    "            \n",
    "#with open('home_timeline.txt','w') as f:\n",
    "#    for page in Cursor(client.home_timeline, count=200).pages(4): # limit of 3200 for other user\n",
    "#        for status in page:\n",
    "#            f.write(json.dumps(status.text) +'\\n')"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 95,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "user = 'kdnuggets'\n",
    "fname = 'usr_timeline_{}.jsonl'.format(user)\n",
    "with open(fname, 'w') as f:\n",
    "    for page in Cursor(client.user_timeline, screen_name=user, count=200).pages(16): # limit of 3200 for other user\n",
    "        for status in page:\n",
    "            f.write(json.dumps(status._json)+'\\n')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Streaming API"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "* `MyListener` is an extension of `tweepy.StreamListener`. \n",
    "\n",
    "* This basic implementation overides the two methods `on_data()` and `on_error()`.\n",
    "\n",
    "* Notice that the return type of the class methods is a Boolean - `True` continues streaming, `False` stops the streaming."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 111,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "#time.sleep(900) # sleep for 15 mins.\n",
    "\n",
    "class MyListener(StreamListener):\n",
    "    \"\"\"Streaming Twitter Data.\"\"\"\n",
    "    \n",
    "    def __init__(self, fname):\n",
    "        safe_fname = self.format_filename(fname)\n",
    "        self.outfile = 'stream_{}.jsonl'.format(safe_fname)\n",
    "    \n",
    "    @staticmethod\n",
    "    def format_filename(fname):\n",
    "        \"\"\"Convert fname into safe string for file name.\n",
    "        \n",
    "        Return: string\n",
    "        \"\"\"\n",
    "        return ''.join(MyListener.convert_valid(one_char) for one_char in fname)\n",
    "    \n",
    "    @staticmethod\n",
    "    def convert_valid(one_char):\n",
    "        \"\"\"Convert invalid characters into '_'\n",
    "        \n",
    "        Return: string\n",
    "        \"\"\"\n",
    "        valid_chars = '-_.{0}{1}'.format(string.ascii_letters, string.digits)\n",
    "        if one_char in valid_chars:\n",
    "            return one_char\n",
    "        else:\n",
    "            return '_'\n",
    "        \n",
    "    def on_data(self, data):\n",
    "        try:\n",
    "            with open(self.outfile, 'a') as f:\n",
    "                f.write(data)\n",
    "                return True\n",
    "        except BaseException as e:\n",
    "            sys.stderr.write('Error on_data: {}'.format(e))\n",
    "            time.sleep(5)\n",
    "        return True\n",
    "    \n",
    "    def on_error(self, status):\n",
    "        if status==420:\n",
    "            sys.stderr.write('Rate limit exceeded\\n'.format(status))\n",
    "            return False\n",
    "        else:\n",
    "            sys.stderr.write('Error\\n'.format(status))\n",
    "            return True\n",
    "                "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 124,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "query = ['#Python', '#DataScience']\n",
    "query_name = ''.join(query)\n",
    "\n",
    "auth = get_twitter_auth()\n",
    "twitter_stream = Stream(auth, MyListener(query_name))\n",
    "\n",
    "twitter_stream.filter(track=query, async=True)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Visualization"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 135,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "import numpy as np\n",
    "import pandas as pd\n",
    "import matplotlib.pyplot as plt\n",
    "import matplotlib.dates as mdates"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 136,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "fname = 'stream__Python_DataScience.jsonl'\n",
    "with open(fname, 'r') as f:\n",
    "    all_dates = []\n",
    "    for line in f:\n",
    "        tweet = json.loads(line)\n",
    "        all_dates.append(tweet.get('created_at'))\n",
    "        \n",
    "    idx = pd.DatetimeIndex(all_dates)\n",
    "    ones = np.ones(len(all_dates))\n",
    "    my_series = pd.Series(ones, index=idx)\n",
    "    per_minute = my_series.resample('1Min').sum().fillna(0)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 145,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "image/png": "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\nAAAASUVORK5CYII=\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x7fca28026400>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "fig, ax = plt.subplots()\n",
    "\n",
    "ax.plot(per_minute.index, per_minute)\n",
    "\n",
    "plt.grid(True)\n",
    "plt.title('Tweets Frequencies')\n",
    "plt.ylabel('Frequency')\n",
    "\n",
    "hours = mdates.MinuteLocator(interval=2)\n",
    "date_formatter = mdates.DateFormatter('%H:%M')\n",
    "\n",
    "ax.xaxis.set_major_locator(hours)\n",
    "ax.xaxis.set_major_formatter(date_formatter)\n",
    "max_freq = per_minute.max()\n",
    "ax.set_ylim(0, max_freq)\n",
    "\n",
    "plt.show();"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Anatomy of a Tweet\n",
    "\n",
    "This will come in handy when doing more analysis."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 87,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "{\n",
      "    \"retweet_count\": 9,\n",
      "    \"id\": 820451940912037888,\n",
      "    \"in_reply_to_user_id\": null,\n",
      "    \"in_reply_to_screen_name\": null,\n",
      "    \"user\": {\n",
      "        \"profile_image_url_https\": \"https://pbs.twimg.com/profile_images/702521133732597760/8b-V29CP_normal.jpg\",\n",
      "        \"id\": 15840592,\n",
      "        \"profile_image_url\": \"http://pbs.twimg.com/profile_images/702521133732597760/8b-V29CP_normal.jpg\",\n",
      "        \"description\": \"Wearing 1000 Hats/Minute. Yak Barber. Building None and NOWHERE. Earlier on: Demoscene (Neuro / Farbrausch). Married to @sylvia_ritter and @duangle.   133547455\",\n",
      "        \"favourites_count\": 72955,\n",
      "        \"follow_request_sent\": false,\n",
      "        \"profile_sidebar_border_color\": \"000000\",\n",
      "        \"followers_count\": 4614,\n",
      "        \"geo_enabled\": false,\n",
      "        \"utc_offset\": 3600,\n",
      "        \"default_profile_image\": false,\n",
      "        \"profile_sidebar_fill_color\": \"FFFFFF\",\n",
      "        \"profile_text_color\": \"000000\",\n",
      "        \"notifications\": false,\n",
      "        \"profile_background_tile\": false,\n",
      "        \"profile_link_color\": \"230085\",\n",
      "        \"listed_count\": 350,\n",
      "        \"id_str\": \"15840592\",\n",
      "        \"time_zone\": \"Bern\",\n",
      "        \"profile_use_background_image\": false,\n",
      "        \"protected\": false,\n",
      "        \"translator_type\": \"regular\",\n",
      "        \"profile_background_image_url_https\": \"https://pbs.twimg.com/profile_background_images/378800000167314015/k9sKo4l6.jpeg\",\n",
      "        \"is_translator\": false,\n",
      "        \"lang\": \"en\",\n",
      "        \"verified\": false,\n",
      "        \"profile_background_image_url\": \"http://pbs.twimg.com/profile_background_images/378800000167314015/k9sKo4l6.jpeg\",\n",
      "        \"name\": \"Leonard Ritter\",\n",
      "        \"entities\": {\n",
      "            \"url\": {\n",
      "                \"urls\": [\n",
      "                    {\n",
      "                        \"url\": \"http://t.co/7IYHdgSuFx\",\n",
      "                        \"indices\": [\n",
      "                            0,\n",
      "                            22\n",
      "                        ],\n",
      "                        \"expanded_url\": \"http://www.duangle.com/nowhere\",\n",
      "                        \"display_url\": \"duangle.com/nowhere\"\n",
      "                    }\n",
      "                ]\n",
      "            },\n",
      "            \"description\": {\n",
      "                \"urls\": []\n",
      "            }\n",
      "        },\n",
      "        \"profile_background_color\": \"000000\",\n",
      "        \"default_profile\": false,\n",
      "        \"screen_name\": \"paniq\",\n",
      "        \"following\": true,\n",
      "        \"contributors_enabled\": false,\n",
      "        \"profile_banner_url\": \"https://pbs.twimg.com/profile_banners/15840592/1472275943\",\n",
      "        \"created_at\": \"Wed Aug 13 18:50:10 +0000 2008\",\n",
      "        \"has_extended_profile\": true,\n",
      "        \"url\": \"http://t.co/7IYHdgSuFx\",\n",
      "        \"statuses_count\": 161385,\n",
      "        \"friends_count\": 1383,\n",
      "        \"location\": \"Germany\",\n",
      "        \"is_translation_enabled\": false\n",
      "    },\n",
      "    \"truncated\": false,\n",
      "    \"contributors\": null,\n",
      "    \"is_quote_status\": false,\n",
      "    \"favorite_count\": 0,\n",
      "    \"id_str\": \"820451940912037888\",\n",
      "    \"source\": \"<a href=\\\"http://twitter.com\\\" rel=\\\"nofollow\\\">Twitter Web Client</a>\",\n",
      "    \"favorited\": false,\n",
      "    \"lang\": \"en\",\n",
      "    \"place\": null,\n",
      "    \"retweeted\": false,\n",
      "    \"entities\": {\n",
      "        \"hashtags\": [],\n",
      "        \"symbols\": [],\n",
      "        \"urls\": [],\n",
      "        \"user_mentions\": [\n",
      "            {\n",
      "                \"id_str\": \"24585498\",\n",
      "                \"id\": 24585498,\n",
      "                \"name\": \"TimOfLegend\",\n",
      "                \"indices\": [\n",
      "                    3,\n",
      "                    15\n",
      "                ],\n",
      "                \"screen_name\": \"TimOfLegend\"\n",
      "            }\n",
      "        ]\n",
      "    },\n",
      "    \"in_reply_to_status_id_str\": null,\n",
      "    \"retweeted_status\": {\n",
      "        \"retweet_count\": 9,\n",
      "        \"id\": 820450997759709186,\n",
      "        \"in_reply_to_user_id\": null,\n",
      "        \"favorited\": false,\n",
      "        \"user\": {\n",
      "            \"profile_image_url_https\": \"https://pbs.twimg.com/profile_images/781246620469866496/Wp5sz1sJ_normal.jpg\",\n",
      "            \"id\": 24585498,\n",
      "            \"profile_image_url\": \"http://pbs.twimg.com/profile_images/781246620469866496/Wp5sz1sJ_normal.jpg\",\n",
      "            \"description\": \"FAQ: https://t.co/SUIdk7PIXl Official DF twitter: @doublefine Bugs & tech issues: https://t.co/A4Po9RbGml. Press requests: pr@doublefine.com\",\n",
      "            \"favourites_count\": 16522,\n",
      "            \"follow_request_sent\": false,\n",
      "            \"profile_sidebar_border_color\": \"C0DEED\",\n",
      "            \"followers_count\": 1103105,\n",
      "            \"geo_enabled\": true,\n",
      "            \"utc_offset\": -28800,\n",
      "            \"default_profile_image\": false,\n",
      "            \"profile_sidebar_fill_color\": \"DDEEF6\",\n",
      "            \"profile_text_color\": \"333333\",\n",
      "            \"notifications\": false,\n",
      "            \"profile_background_tile\": true,\n",
      "            \"profile_link_color\": \"4A913C\",\n",
      "            \"listed_count\": 4380,\n",
      "            \"id_str\": \"24585498\",\n",
      "            \"time_zone\": \"Pacific Time (US & Canada)\",\n",
      "            \"profile_use_background_image\": true,\n",
      "            \"protected\": false,\n",
      "            \"translator_type\": \"none\",\n",
      "            \"profile_background_image_url_https\": \"https://pbs.twimg.com/profile_background_images/119245359/you_and_i.jpg\",\n",
      "            \"is_translator\": false,\n",
      "            \"lang\": \"en\",\n",
      "            \"verified\": true,\n",
      "            \"profile_background_image_url\": \"http://pbs.twimg.com/profile_background_images/119245359/you_and_i.jpg\",\n",
      "            \"name\": \"TimOfLegend\",\n",
      "            \"entities\": {\n",
      "                \"url\": {\n",
      "                    \"urls\": [\n",
      "                        {\n",
      "                            \"url\": \"https://t.co/vGtEOtAC4C\",\n",
      "                            \"indices\": [\n",
      "                                0,\n",
      "                                23\n",
      "                            ],\n",
      "                            \"expanded_url\": \"http://www.doublefine.com\",\n",
      "                            \"display_url\": \"doublefine.com\"\n",
      "                        }\n",
      "                    ]\n",
      "                },\n",
      "                \"description\": {\n",
      "                    \"urls\": [\n",
      "                        {\n",
      "                            \"url\": \"https://t.co/SUIdk7PIXl\",\n",
      "                            \"indices\": [\n",
      "                                5,\n",
      "                                28\n",
      "                            ],\n",
      "                            \"expanded_url\": \"http://www.doublefine.com/about\",\n",
      "                            \"display_url\": \"doublefine.com/about\"\n",
      "                        },\n",
      "                        {\n",
      "                            \"url\": \"https://t.co/A4Po9RbGml\",\n",
      "                            \"indices\": [\n",
      "                                82,\n",
      "                                105\n",
      "                            ],\n",
      "                            \"expanded_url\": \"http://support.doublefine.com\",\n",
      "                            \"display_url\": \"support.doublefine.com\"\n",
      "                        }\n",
      "                    ]\n",
      "                }\n",
      "            },\n",
      "            \"profile_background_color\": \"C0DEED\",\n",
      "            \"default_profile\": false,\n",
      "            \"screen_name\": \"TimOfLegend\",\n",
      "            \"following\": false,\n",
      "            \"contributors_enabled\": false,\n",
      "            \"profile_banner_url\": \"https://pbs.twimg.com/profile_banners/24585498/1421107929\",\n",
      "            \"created_at\": \"Sun Mar 15 21:03:29 +0000 2009\",\n",
      "            \"has_extended_profile\": false,\n",
      "            \"url\": \"https://t.co/vGtEOtAC4C\",\n",
      "            \"statuses_count\": 25404,\n",
      "            \"friends_count\": 812,\n",
      "            \"location\": \"San Francisco, CA\",\n",
      "            \"is_translation_enabled\": false\n",
      "        },\n",
      "        \"truncated\": false,\n",
      "        \"contributors\": null,\n",
      "        \"favorite_count\": 30,\n",
      "        \"id_str\": \"820450997759709186\",\n",
      "        \"source\": \"<a href=\\\"http://twitter.com/download/iphone\\\" rel=\\\"nofollow\\\">Twitter for iPhone</a>\",\n",
      "        \"in_reply_to_screen_name\": null,\n",
      "        \"lang\": \"en\",\n",
      "        \"place\": null,\n",
      "        \"retweeted\": false,\n",
      "        \"entities\": {\n",
      "            \"hashtags\": [],\n",
      "            \"symbols\": [],\n",
      "            \"urls\": [],\n",
      "            \"user_mentions\": []\n",
      "        },\n",
      "        \"in_reply_to_status_id_str\": null,\n",
      "        \"is_quote_status\": false,\n",
      "        \"text\": \"If you could make a human centipede using only 3-headed dogs, it could be a fun way to teach fractals to kids.\",\n",
      "        \"in_reply_to_user_id_str\": null,\n",
      "        \"in_reply_to_status_id\": null,\n",
      "        \"coordinates\": null,\n",
      "        \"created_at\": \"Sun Jan 15 02:02:15 +0000 2017\",\n",
      "        \"geo\": null\n",
      "    },\n",
      "    \"text\": \"RT @TimOfLegend: If you could make a human centipede using only 3-headed dogs, it could be a fun way to teach fractals to kids.\",\n",
      "    \"in_reply_to_user_id_str\": null,\n",
      "    \"in_reply_to_status_id\": null,\n",
      "    \"coordinates\": null,\n",
      "    \"created_at\": \"Sun Jan 15 02:06:00 +0000 2017\",\n",
      "    \"geo\": null\n",
      "}\n"
     ]
    }
   ],
   "source": [
    "for status in Cursor(client.home_timeline).items(1):\n",
    "    print(json.dumps(status._json, indent=4))"
   ]
  }
 ],
 "metadata": {
  "anaconda-cloud": {},
  "kernelspec": {
   "display_name": "Python [default]",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.5.2"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 1
}