Twitter Meetup at the Hacker Dojo

What's Next & Big with Twitter
#tmeetup @themattharris @raffi @hackerdojo

@hackerdojo TM

July 1, 2010
2

@themattharris
About us

TM

5

@raffi
About us

TM

6

160,000
Registered third-party Applications

TM

9

75%
Trafﬁc on Twitter comes from places outside of twitter.com

TM

11

65 Million
Tweets per day

TM

13

65%
Users are outside of the United States

TM

15

3.5 Billion
Requests per day to the API

TM

17

2,928
Tweets-per-second (June 14 2010, Brazil vs North Korea)

TM

19

2,928 3,283
Tweets-per-second (June 24 2010, Japan vs Denmark)

TM

20

What is ?
The Twitter Platform

TM

21

What is ?
‣ REST API
‣ provides the “basic” Twitter functionality - tweet, follow, etc.
‣ all functions available on your timeline on twitter.com
‣ Search API
‣ real-time search index
‣ get “top tweets” / relevant search results
‣ Streaming API
‣ HTTP long-poll connection
‣ tweets come out of the system in real-time TM

22

The goals of
‣ To be ridiculously simple
‣ To be obvious
‣ To be self-describing

TM

23

Authenticating to
‣ OAuth 1.0a
‣ Signing “write” requests
‣ Give Twitter visibility into the stack
‣ Applications don’t have the user’s username / password
‣ User can change password at any time
‣ User is secure in knowing his/her password is not stored
‣ User can revoke permissions to app at any time
‣ User has one place to see which applications have access to their account
TM

24

twurl
‣ http://github.com/marcel/twurl
‣ Command line tool to interact with using OAuth
‣ Transparently handles OAuth signing against
‣ POST and GET data
‣ Trace requests

TM

25

Limits
‣ 175 API calls/hour using OAuth against api.twitter.com
‣ Unauthenticated it goes against the source IP address
‣ Authenticated it goes against the calling user
‣ “Natural” limits on
‣ number of tweets sent
‣ number of DMs sent
‣ number of followings / unfollowings
‣ Status limits
‣ No duplicate tweets
‣ No malware links in tweets TM

26

Core Features
‣ Hovercards
‣ Tweet Box
‣ Follow Buttons
‣ Linkify

TM

28

Easiest Example
<!DOCTYPE HTML>
<html>
<head>
<meta http-equiv="Content-type" content="text/html; charset=utf-8">
<title>Anywhere Sample</title>
<script src="http://platform.twitter.com/anywhere.js?id=YOUR_API_KEY&v=1">
</script>
<script type="text/javascript">
twttr.anywhere(function(T) {
T.hovercards();
T("#follow-placeholder").followButton('themattharris');
T("#tbox").tweetBox();
});
</script>
</head>
<body>
<p>Some text with @twitter screen names in it.</p>

<div id="tweets"></div>
<div id="tbox"></div>
<span id="follow-placeholder"></span>
</body>
</html>
TM

29

Easiest Example

TM

30

Easiest Example
<head>
</script>
T.hovercards();
});
</script>
</head>

TM

31

Easiest Example
<head>
</script>
T.hovercards();
});
</script>
</head>

TM

32

Easiest Example
<head>
</script>
T.hovercards();
});
</script>
</head>

TM

33

Easiest Example
<head>
</script>
T.hovercards();
});
</script>
</head>

TM

34

Complex Example
twttr.anywhere(function (T) {
var currentUser,
screenName,
profileImage,
profileImageTag;

var onLogin = function() {
currentUser = T.currentUser;
screenName = currentUser.data('screen_name');
profileImage = currentUser.data('profile_image_url');
profileImageTag = "<img src='" + profileImage + "'/>";

document.getElementById('connect-placeholder').innerHTML =
"Logged in as " + profileImageTag + " @" + screenName;
document.getElementById('tbox').style.display = 'block';
document.getElementById('follow-placeholder').style.display = 'block';
document.getElementById('signout').style.display = 'block';

T("#tbox").tweetBox({
label: "Careful! This is a real tweet box.",
defaultContent: "tweet tweet ",
height: 300,
width: 700
});
}, TM

35

Complex Example
cleanup = function() {
document.getElementById('connect-placeholder').innerHTML = '';
document.getElementById('signout').style.display = 'none';
document.getElementById('tbox').style.display = 'none';
document.getElementById('follow-placeholder').style.display = 'none';
},
init = function() {
if (T.isConnected()) {
onLogin();
} else {
T("#connect-placeholder").connectButton({
authComplete: function(user) {
onLogin();
},
signOut: function() {
cleanup();
init();
}
});
}
};
init();
T.hovercards({
expanded: true
});
});
TM

36

Easiest Example

TM

37

More Info... Check out
bit.ly/anywhere-begin

TM

38

OAuthpocalypse
The day is 30th June 16th August 2010

TM

39

What you need to know
‣ All applications must be using OAuth for the REST API
‣ Streaming API will still support Basic Auth
‣ Search API has no auth
‣ OAuth key exchange for Open Source Applications
‣ Replace curl with twurl for debugging

http://dev.twitter.com/pages/auth_overview
http://github.com/marcel/twurl
TM

40

OAuth Methods
‣ Web must use three legged OAuth
‣ Desktop and mobile apps can also use out-of-band OAuth
‣ Some desktop and mobile apps will be considered for xAuth

TM

41

xAuth not XAuth

xAuth is OAuth

http://dev.twitter.com/pages/xauth

TM

42

Check your host!

api.twitter.com

twitter.com
TM

43

Libraries
ActionScript/Flash Objective-C/Cocoa & iPhone Programming
C/C++ Perl
C#/.NET PHP
Clojure Python
Erlang Qt
Java Ruby
JavaScript Scala

http://dev.twitter.com/pages/oauth_libraries

TM

44

OAuth Echo
‣ Delegation for Identity Verification
‣ Pass the header needed for an application to confirm your
identify with Twitter

TM

46

Services offering it
‣ yFrog ‣ Mobypicture
‣ TwitPic ‣ Twitgoo
‣ TwitVid ‣ Posterous
‣ TweetPhoto ‣ img.ly
‣ Vodpod

TM

47

Endpoints
‣ /1/geo/search
‣ /1/geo/similar_places
‣ /1/geo/reverse_geocode
‣ /1/geo/id/:id
‣ /1/geo/place

TM

49

/1/geo/search
‣ Find places to use in status updates
‣ Search by lat, long, IP or free-form name. Also search by attribute.
‣ Limit to poi, neighborhood, city, admin or country
‣ Find only places within another if desired
‣ Set a callback
‣ Use authorisation to bias ordering to the users location history

http://api.twitter.com/1/geo/search.json

TM

50

/1/geo/similar_places
‣ Find places to use in status updates
‣ Search by lat, long, free-form name. Also search by attribute.
‣ Find only places within another if desired
‣ Set a callback
‣ Search by attribute

http://api.twitter.com/1/geo/similar_places.json

TM

51

/1/geo/similar_places
‣ Must make this call before creating a place
‣ Returns a creation token

http://api.twitter.com/1/geo/similar_places.json

TM

52

/1/geo/reverse_geocode
‣ Find 20 places around the provided lat, long
‣ Limit to poi, neighborhood, city, admin or country
‣ Set a callback
‣ /geo/search is better

http://api.twitter.com/1/geo/reverse_geocode.json

TM

53

/1/geo/id/:id
‣ Information on a place
‣ :id from /geo/search methods

http://api.twitter.com/1/geo/id/:id

TM

54

/1/geo/place
‣ create a place
‣ must have
‣ name
‣ contained_within - place_id of another place, e.g. city
‣ token
‣ lat, long
‣ Set a callback
http://api.twitter.com/1/geo/place

TM

55

Create a place - the flow
‣ /1/geo/search
‣ show what’s nearby
‣ /1/geo/similar_places
‣ not found in search, find by name
‣ /1/geo/place
‣ still not found, create a new place

http://api.twitter.com/1/geo/place

TM

56

Use in search
‣ just pass place:place_id

http://search.twitter.com/search?q=place%3A247f43d441defc03

TM

57

Attributes {
"name": "Twitter HQ",
"polylines": [

],
"country_code": "US",
"country": "The United States of America",
"attributes": {
"street_address": "795 Folsom St",
"1166:id": "49547",
"623:id": "210176"
},
"url": "http://api.twitter.com/1/geo/id/247f43d441defc03.json",
"id": "247f43d441defc03",
}
TM

58

Timeline Endpoints
‣ /1/statuses/public_timeline
‣ /1/statuses/home_timeline
‣ /1/statuses/friends_timeline
‣ /1/statuses/status_timeline
‣ /1/statuses/mentions
‣ /1/statuses/retweeted_by_me
‣ /1/statuses/retweeted_to_me
‣ /1/statuses/retweets_of_me

TM

60

Modifiers
‣ include_rts

Accepted values: true, 1, t

TM

61

Modifiers
‣ include_rts
‣ include_entities


TM

62

Modifiers
‣ include_rts
‣ include_entities
‣ trim_user


TM

63

What is a Tweet?
The anatomy of a status update

TM

64

Dissecting a status object
The tweet's unique ID. These Text of the tweet.
IDs are roughly sorted & Consecutive duplicate tweets
developers should treat them are rejected. 140 character
as opaque (http://bit.ly/dCkppc). max (http://bit.ly/4ud3he).
DEPRECATED

{"id"=>12296272736,
"text"=>
"An early look at Annotations:
http://groups.google.com/group/twitter-api-announce/browse_thread/thread/fa5da2608865453", Tweet's
"created_at"=>"Fri Apr 16 17:55:46 +0000 2010", creation
"in_reply_to_user_id"=>nil, The ID of an existing tweet that date.
"in_reply_to_screen_name"=>nil, this tweet is in reply to. Won't
"in_reply_to_status_id"=>nil be set unless the author of the
The author's

The screen name &
"favorited"=>false,
user ID.

user ID of replied to referenced tweet is mentioned.
"truncated"=>false, Truncated to 140
characters. Only tweet author.
"user"=>
possible from SMS. The author's
{"id"=>6253282,
user name. The author's
"screen_name"=>"twitterapi",
The author's biography.
"name"=>"Twitter API",
screen name.
ded object can get out of sync.

"description"=>
"The Real Twitter API. I tweet about API changes, service issues and
e author of the tweet. This

happily answer questions about Twitter and our API. Don't get an answer? It's on my website.",
"url"=>"http://apiwiki.twitter.com", The author's
"location"=>"San Francisco, CA", URL.
The author's "location". This is a free-form text ﬁeld, and
"profile_background_color"=>"c1dfee", there are no guarantees on whether it can be geocoded.
"profile_background_image_url"=>
TM
"http://a3.twimg.com/profile_background_images/59931895/twitterapi-background-new.png",
Rendering information
"profile_background_tile"=>false,
for the author. Colors
"profile_image_url"=>"http://a3.twimg.com/profile_images/689684365/api_normal.png",
are encoded in hex
"profile_link_color"=>"0000ff", 65

Dissecting a status object

The tweet's unique ID. These Text of the tweet.
IDs are roughly sorted & Consecutive duplicate tweets
developers should treat them are rejected. 140 character
as opaque (http://bit.ly/dCkppc). max (http://bit.ly/4ud3he).
DEPRECATED

{"id"=>12296272736,
"text"=>
"An early look at Annotations:
http://groups.google.com/group/twitter-api-announce/browse_thread/thread/fa5da2608865453", Tweet's
"created_at"=>"Fri Apr 16 17:55:46 +0000 2010", creation
"in_reply_to_user_id"=>nil, The ID of an existing tweet that date.
"in_reply_to_screen_name"=>nil, this tweet is in reply to. Won't
"in_reply_to_status_id"=>nil be set unless the author of the
The author's

The screen name &
"favorited"=>false,
user ID.

user ID of replied to referenced tweet is mentioned.
"user"=>
{"id"=>6253282,
screen name.
n get out of sync.

"description"=>
e tweet. This

happily answer questions about Twitter and our API. Don't get an answer? It's on my website.", TM
"profile_background_color"=>"c1dfee", there are no guarantees on whether it can be geocoded. 66

The screen name &
"favorited"=>false,

user ID.
The autho
referenced tweet is mentioned.
user ID of replied to
"user"=>
{"id"=>6253282,
screen name.

embedded object can get out of sync.
"description"=>
The author of the tweet. This
happily answer questions about Twitter and our API. Don't get an answer? It's on my website.",
"profile_background_color"=>"c1dfee", there are no guarantees on whether it can be geocoded.
"profile_background_image_url"=>
"http://a3.twimg.com/profile_background_images/59931895/twitterapi-background-new.png",
Rendering information
"profile_background_tile"=>false,
for the author. Colors
"profile_image_url"=>"http://a3.twimg.com/profile_images/689684365/api_normal.png",
are encoded in hex
"profile_link_color"=>"0000ff",
values (RGB).
"profile_sidebar_border_color"=>"87bc44", The creation date
"profile_sidebar_fill_color"=>"e0ff92", for this account.
"profile_text_color"=>"000000", Whether this account has
"created_at"=>"Wed May 23 06:01:13 +0000 2007", contributors enabled
"contributors_enabled"=>true, (http://bit.ly/50npuu). Number of
Number of tweets

"favourites_count"=>1, favorites this
this user has.

"statuses_count"=>1628, Number of user has.
"friends_count"=>13, users this user
"time_zone"=>"Pacific Time (US & Canada)", The timezone and offset is following.
"utc_offset"=>-28800, (in seconds) for this user.
"lang"=>"en", The user's selected
"protected"=>false, language.
"followers_count"=>100581,
"geo_enabled"=>true, Whether this user is protected
enabled (http://bit.ly/4pFY77).

"notifications"=>false, DEPRECATED
Whether this user has geo

or not. If the user is protected,
"following"=>true, in this context Number of
then this tweet is not visible
"verified"=>true}, Whether this user followers for
except to "friends".
"contributors"=>[3191321], has a veriﬁed badge. this user.
"geo"=>nil,
"coordinates"=>nil, DEPRECATED
"place"=> The contributors' (if any) user TM
The place ID IDs (http://bit.ly/50npuu).
{"id"=>"2b6ff8c22edd9576",
"url"=>"http://api.twitter.com/1/geo/id/2b6ff8c22edd9576.json",
"name"=>"SoMa", The URL to fetch a detailed 67

Context is everything

TM

68

#hashtags
Those things you add to a Tweet for grouping

TM

69

@mentions
Talk about or to another user

TM

70

51.495466,-0.146341
Locates a Tweet

TM

71

via My App
what created the Tweet

TM

72

dev.twitter.com
The developer portal

TM

73

Creating an app
Your own small playground

TM

74

Browsing docs
Remembering how to read

TM

78

Streaming API
Near-Realtime Access to Public Statuses

TM

82

Streaming API
‣ A persistent connection to Twitter servers
‣ Get pushed a tweet that matches your predicate in “real-time”
‣ Server to server integrations

TM

83

Basic Usage
‣ Curl with Basic Auth or Twurl with OAuth
‣ One connection per username permitted

http://stream.twitter.com/1/statuses/sample.json

TM

84

Follow some users
‣ Pass up to 400 user_ids, comma seperated

http://stream.twitter.com/1/statuses/filter.json

TM

85

Filter by keyword
‣ Pass up to 200 keywords, comma seperated
‣ Example: Twitter will return statuses which contain: TWITTER,
twitter, "Twitter", twitter., #twitter and @twitter

http://stream.twitter.com/1/statuses/filter.json

TM

86

Streaming API - Access Levels
‣ Default

TM

87

Streaming API - Default Level
‣ 200 x Keywords
‣ 400 x Follow userids
‣ 10 x 1-degree location boxes

TM

88

‣ Default
‣ Shadow - many followings
‣ Birddog - many more followings
‣ Restricted Track - many keywords
‣ Partner Track - many more keywords
‣ locRestricted - many locations

TM

89

‣ Default
‣ Shadow - many followings
‣ Birddog - many more followings
‣ Restricted Track - many keywords
‣ Partner Track - many more keywords
‣ locRestricted - many locations
‣ Firehose - all public statuses

TM

90

Streaming API - Firehose

TM

91

bit.ly/streaming_api

TM

92

Userstreams
Real-time updates of all data needed to update a desktop
application display

TM

93

TA
BE

Userstreams
Real-time updates of all data needed to update a desktop
application display

TM

94

TA Keyfacts
BE ‣ Rate limits practically eliminated
‣ Hit the API for backfill of data
‣ Transition to userstream for real-time updates
‣ Social events streamed too

TM

95

TA
BE

bit.ly/userstreams-beta
bit.ly/userstreams-overview

TM

96

Stay Informed... Join
bit.ly/twitter-anywhere-talk
bit.ly/twitter-dev-talk

Important Stuff
@twitterapi
status.twitter.com
bit.ly/twitter-api-announce

TM

97

Help... Check out
dev.twitter.com

TM

98

Join the Flock! Find out more
jobs.twitter.com

TM

99

Questions? Follow us at
twitter.com/twitterapi
twitter.com/themattharris
twitter.com/raffi

TM

100

Twitter Meetup at the Hacker Dojo

Recomendados

Recomendados

Más contenido relacionado

Similar a Twitter Meetup at the Hacker Dojo

Similar a Twitter Meetup at the Hacker Dojo (20)

Último

Último (20)

Twitter Meetup at the Hacker Dojo