mining social web apis with ipython notebook (data day texas 2015)
TRANSCRIPT
Mining Social Web APIswith IPython Notebook
Matthew A. Russell - @ptwobrussell - http://MiningTheSocialWeb.com
Austin - 9 January 2015
1
Intro
2
Hello, My Name Is ... Matthew
3
Background in Computer Science
Data mining & machine learning
CTO @ Digital Reasoning Systems
Data mining; machine learning
Author @ O'Reilly Media
5 published books on technology
Principal @ Zaffra
Selective boutique consulting
Transforming Curiosity Into Insight
4
An open source software (OSS) project
http://bit.ly/MiningTheSocialWeb2E
A book
http://bit.ly/135dHfs
Accessible to (virtually) everyone
Virtual machine with turn-key coding templates for data science experiments
Think of the book as "premium" support for the OSS project
Table of Contents (1/2)
Chapter 1 - Mining Twitter: Exploring Trending Topics, Discovering What People Are Talking About, and More
Chapter 2 - Mining Facebook: Analyzing Fan Pages, Examining Friendships, and More
Chapter 3 - Mining LinkedIn: Faceting Job Titles, Clustering Colleagues, and More
Chapter 4 - Mining Google+: Computing Document Similarity, Extracting Collocations, and More
Chapter 5 - Mining Web Pages: Using Natural Language Processing to Understand Human Language, Summarize Blog Posts, and More
Chapter 6 - Mining Mailboxes: Analyzing Who's Talking to Whom About What, How Often, and More
5
Table of Contents (2/2)
Chapter 7 - Mining GitHub: Inspecting Software Collaboration Habits, Building Interest Graphs, and More
Chapter 8 - Mining the Semantically Marked-Up Web: Extracting Microformats, Inferencing over RDF, and More
Chapter 9 - Twitter Cookbook
Appendix A - Information About This Machine's Virtual Machine Experience
Appendix B - OAuth Primer
Appendix C - Python and IPython Notebook Tips & Tricks
6
Designed for PedagogyBrief Intro
Objectives
API Primer
Analysis Technique(s)
Data Visualization
Recap
Suggested Exercises
Recommended Resources
7
The Social Web Is All the Rage
World population: ~7B people
Facebook: 1.15B users
Twitter: 500M users
Google+ 343M users
LinkedIn: 238M users
~200M+ blogs (conservative estimate)
8
*Estimates as of early 2014
Overview
Module 1 - Virtual Machine Setup (30 mins)
Module 2 - Mining Twitter (90 mins)
BREAK (15 mins)
Module 3 - Mining Facebook (60 mins)
Lunch (75 mins)
9
Module 4 - Mining LinkedIn (75 mins)
BREAK (15 mins)
Module 5 - Open/Choice (75 mins)
Module 6 - Privacy & Ethics; (15 mins)
Module 7 - Final Q&A (15 mins)
Module Format
~10-15 minutes of exposition
I talk; you listen
~15 minutes of independent (or collaborative) work
You hack while I walk around and help you
~5 minutes of recap with Q&A
You ask; I try to answer
10
Workshop Objective
To send you away as a social web hacker
Broad working knowledge popular social web APIs
Hands-on experience hacking on social web data with a common toolkit
Not for me talk to you for 8 straight hours
11
Just a Few More Things
This workshop is...
An adaptation of Mining the Social Web, 2nd Edition
More of a guided hacking session where you follow along (vs a preso)
Wider than it is deeper
There's only so much you can do in a few hours
I'm available 24/7 this week (and beyond) to help you be successful
12
Assumptions
At some point in your life, you have
Programmed with Python
Worked with JSON
Made requests and processed responses to/from web servers
Or you want to learn to do these things now...
And you're a quick learner
13
Module 1: Virtual Machine Setup
14
Why do you need a VM?
15
To save yourself a lot of time
Because installation and configuration management is tedious and time-consuming
So that you can focus on the task at hand instead
So that I can support you regardless of your hardware and operating system
But I can do all of that myself...True...
If you would rather troubleshoot unexpected installation/configuration issues instead of immediately focusing on the real task at hand
At least give it a shot before resorting to your own devices so that you don't have to install specific versions of ~40 Python packages
Including scientific computing tools that require underlying C/C++ code to be compiled
Which requires specific versions of developer libraries to be installed
You get the idea...
16
The Virtual Machine ExperienceVagrant
A nice abstraction around virtual machine providers
One ring to rule them all
Virtualbox, VMWare, AWS, ...
IPython Notebook
The easiest way to program with Python
A better REPL (interpreter)
Great for hacking
17
What happens when you vagrant up?
Vagrant follows the instructions in your Vagrantfile
Starts up a Virtualbox instance
Uses Chef to provision it
Installs OS patches/updates
Installs MTSW software dependencies
Starts IPython Notebook server on port 8888
18
Why Should I Use IPython Notebook?
Because it's great for hacking
And hacking is usually the first step
Because it's great for collaboration
Sharing/publishing results is trivial
Because the UX is as easy as working in a notepad
Think of it as "executable paper"
19
20
21
VM Quick Start Instructions
Go to http://MiningTheSocialWeb.com/quick-start/
Follow the instructions
And watch the screencasts!
Basically:
Install Virtualbox & Vagrant
Run "vagrant up" in a terminal to start a guest VM
Then, go to http://localhost:8888 on your host machine's web browser
22
What Could Be Easier?
A hosted version of the VM!
But only for a few hours during this workshop
Because it costs money to run these servers
Go to http://bit.ly/XXX and pick a machine
Do not share the URLs outside of this workshop!
Please don't try to hack the machines
Learn how I arrived at this setup at http://MiningTheSocialWeb.com
23
Module 2: Mining Twitter
24
Objectives
25
Be able to identify Twitter primitives
Understand tweet metadata and how to use it
Learn how to extract entities such as user mentions, hashtags, and URLs from tweets
Apply techniques for performing frequency analysis with Python
Be able to plot histograms of Twitter data with IPython Notebook
Twitter Primitives
26
Accounts Types: "Anything"
"Following" Relationships
Favorites
Retweets
Replies
(Almost) No Privacy Controls
API RequestsRESTful requests
Everything is a "resource"
You GET, PUT, POST, and DELETE resources
Standard HTTP "verbs"
Example: GET https://api.twitter.com/1.1/statuses/user_timeline.json?screen_name=SocialWebMining
Streaming API filters
JSON responses
Cursors (not quite pagination)
27
Twitter is an Interest Graph
28
Roberto Mercedes
Jorge
Ana
Nina
Johnny Araya
Rodolfo Hernández
What's in a Tweet?
29
140 Characters ...
... Plus ~5KB of metadata!
Authorship
Time & location
Tweet "entities"
Replying, retweeting, favoriting, etc.
What are Tweet Entities?
Essentially, the "easy to get at" data in the 140 characters
@usermentions
#hashtags
URLs
multiple variations
(financial) symbols
stock tickers
media
30
Data Mining = Curiosity + StatsCuriosity
Interests, desires, and intuitions
Statistics
Counting
Comparing
Filtering
Ranking
Hypothesis testing; knowledge discovery
31
Histograms
A chart that is handy for frequency analysis
They look like bar charts...except they're not bar charts
Each value on the x-axis is a range (or "bin") of values
Not categorical data
Each value on the y-axis is the combined frequency of values in each range
32
33
Example: Histogram of Retweets
Social Media Analysis FrameworkA memorable four step process to guide data science experiments:
Aspire
To test a hypothesis (answer a question)
Acquire
Get the data
Analyze
Count things
Summarize
Plot the results
34
ExercisesReview Python idioms in the "Appendix C (Python Tips & Tricks)" notebook
Follow the setup instructions in the "Chapter 1 (Mining Twitter)" notebook
Fill in Example 1-1 with credentials and begin work
Execute each example sequentially
Customize queries
Explore tweet metadata; count tweet entities; plot histograms of results
Explore the "Chapter 9 (Twitter Cookbook)" notebook
Think of it as a collection of building blocks
35
Module 3: Mining Facebook
36
Objectives
37
Be able to identify Facebook primitives
Learn about Facebook’s Social Graph API and how to make API requests
Understand how Open Graph protocol extends Facebook's Social Graph API
Be able to analyze likes from Facebook pages and friends
The Graph v2 API changes at substantially tamped down privacy and permissions
See https://developers.facebook.com/docs/apps/changelog
Facebook Primitives
Account Types: People & Pages
Mutual Connections
Likes
Shares
Comments
Extensive Privacy Controls
38
Facebook is an Interest Graph
39
Roberto Mercedes
Jorge
Ana
Nina
Johnny Araya
Rodolfo Hernández
Graph API
Nodes
Things
Edges
Connections between things
Fields
Info (properties) about things
40
Facebook API Explorer
41
Go to https://developers.facebook.com/tools/explorer
Really, go there right now...
Graph API Explorer
42
Example Graph API RequestsSocial Graph API requests
Easy to learn and use
http://graph.facebook.com/me/feed
http://graph.facebook.com/me/likes
http://graph.facebook.com/me/?fields=id,name,friends.fields(likes.limit(10))
http://graph.facebook.com/Mining-the-Social-Web?fields=id,name,about,likes
JSON responses
Traditional pagination
43
44
Retrieve Your Likes
Permissions Prior to Graph v2
45
Permissions as of Graph v2
46
Explore Facebook Pages
47
Names of pages
MiningTheSocialWeb
CrossFit
OReilly
Web URLs (OGP extensions to Facebook's Social Graph)
http://www.imdb.com/title/tt0117500
Social Media Analysis Framework
Recall the same four step process to guide data science experiments:
Aspire
Acquire
Analyze
Summarize
48
Exercises
Copy/paste your access token from the Graph API Explorer into the "Chapter 2 (Mining Facebook)" notebook
Execute and tinker with Examples 2-1 thru 2-6
Inspect content in your feed
Juxtapose public figures
Compare/contrast similar products/brands of interest
49
Module 4: Mining LinkedIn
50
Objectives
51
Learn about LinkedIn’s Developer Platform
Understand how clustering works
A fundamental type of machine learning
Be able to employ geocoding services to arrive at a set of coordinates from a textual reference to a location
Visualize geographic data with cartograms
LinkedIn Primitives
Account Types: People, Groups, Companies, Jobs
And Activity Streams
Data is typically perceived as being more sensitive
Richest data source? (Think: LinkedIn's business model)
Profile descriptions from mutual connections
A little messier than it first appears
52
API Requests
HTTP-based Requests
Field selector syntax
http://api.linkedin.com/v1/people/~:(first-name,last-name,headline,picture-url)
XML responses
CSV address book download
53
Is LinkedIn an Interest Graph?
Fundamentally: yes. the developer API requires you to do a bit of work to model it
Less trivial to find some of the "pivots"
e.g. There's no public Skills API for developers
But the data is there (mostly in profile descriptions) for your direct connections
Companies, job titles, job descriptions
Lots of richness is tucked away in human language data
54
Clustering
An unsupervised machine learning learning technique
Think: an algorithm that organizes the data into partitions
55
Example: Clustered Job Titles
56
3 Steps to Clustering Your Data
Normalization
Compare (similarity/distance measurement)
n-grams, edit distance, and Jaccard are common, but your imagination is the limit
Why can't you just compare everything to everything?
Dimensionality Reduction
Ideally, your clustering algorithm will mitigate the pain
k-means is among the most common clustering techniques in use
57
Jaccard Similarity
58
k-Means Explained
1. Randomly pick k points in the data space as initial values that will be used to compute the k clusters: K1, K2, ..., Kk.
2. Assign each of the n points to a cluster by finding the nearest Kn—effectively creating k clusters and requiring k*n comparisons.
3. For each of the k clusters, calculate the centroid of the cluster and reassign its Ki value to be that value. (Hence, you’re computing “k-means” during each iteration of the algorithm.)
4. Repeat steps 2–3 until the members of the clusters do not change between iterations. Generally speaking, relatively few iterations are required for convergence.
59
k-Means: Initialize
60
k-Means: Step 1
61
k-Means: Step 2
62
k-Means: Step 3
63
k-Means: (Fast-Forward) Step 9
64
Geocoding
Transforming a location to a set of coordinates
Nashville, TN => (36.16783905029297, -86.77816009521484)
A harder problem than it first appears
The Bing API is especially generous
Requires an account sign up: http://bingmapsportal.com
Use the API key with the geopy package
65
Introducing: The Dorling Cartogram
66
Social Media Analysis Framework
Remember: Use the same four step process to guide data science experiments:
Aspire
Acquire
Analyze
Summarize
67
ExercisesFollow the instructions in the "Chapter 3 (Mining LinkedIn)" notebook to create an API connection and follow along with the first few examples
Download your connections as a CSV file from http://www.linkedin.com/people/export-settings and save them to your VM
A deviation from instructions in Example 3-6 is necessary for remote VMs
See http://bit.ly/mtsw-ch03-helper-code
Try clustering your contacts in Example 3-12
Use the python-linkedin client to tap into Activity Streams
See https://developer.linkedin.com/documents/get-network-updates-and-statistics-api
68
Module 5: Choice
69
Objectives
70
To work on "loose ends" or areas of interest from previous modules
To hack on code in notebooks not yet encountered
To setup the virtual machine on your own box if you haven't yet
To collaborate/talk and otherwise make the most of our togetherness
Social Media Analysis Framework
Remember:
Aspire
Acquire
Analyze
Summarize
71
Recommendations
Setup your own development environment if you haven't already
Appendix A
Text Mining & Natural Language Processing
Chapter 4 (Mining Google+) & Chapter 5 (Mining Web Pages)
Graph Mining
Chapter 7 (Mining GitHub)
72
Module 6: Privacy & Ethics
73
74
Know thy data, and know thyself
--Matthew A. Russell
75
If we have data, let’s look at data. If we have opinions, let’s go with mine
--Jim Barksdale
76
In God we trust. All others must bring data
--W. Edwards Deming
Communication => Data
Communication
Senders
humans & machines
Messages
natural language, images, videos, etc.
Recipients
humans & machines
77
Data Alchemy
Data: Documents & document fragments (text messages, etc.)
Information: "Assertions", summaries, tags, etc.
Knowledge: Aggregated, queryable information
Wisdom: “Compressed” knowledge
Gold: Money
78
Machine Learning
79
A program that learns (improves) from experience (data) according to some objective
Supervised learning
Unsupervised learning
Reinforcement learning
How to do it
Program mathematical models and hope for the best...
How to do it well
Program state-of-the-art mathematical models with sufficient representative data
80
Knowledge is a process of piling up facts; wisdom lies in their simplification
--Martin Fischer
81
Any sufficiently advanced technology is indistinguishable from magic
--Arthur C. Clarke
Is Privacy Already an Illusion?
82
Digital happenings circa 2014
The Cloud
Social Media
Deep Learning
The Internet of Things
Internet.org
83
Civilization is the progress toward a society of privacy...
-- Ayn Rand
84
If you have something that you don’t want anyone to know, maybe you shouldn’t be doing it in the first place.
-- Eric Schmidt, (former) CEO of Google
Influences on Ethics
Capitalism, economics, & marketing
A for-profit corporation's fiduciary duty: To maximize the common stock's value
How to do it? By transacting commerce
How do it well? By advertising more effectively than competitors
How to do it really well? With highly relevant personalized ads (recommenders)
Terms of Service (ToS) - The legal extent of ethical obligations?
85
Module 7: Final Q&A
86
Free Stuff
http://MiningTheSocialWeb.com
Mining the Social Web 2E Chapter 1 (Chimera)
http://bit.ly/13XgNWR
Source Code (GitHub)
http://bit.ly/MiningTheSocialWeb2E
http://bit.ly/1fVf5ej (numbered examples)
Screencasts (Vimeo)
http://bit.ly/mtsw2e-screencasts
87