Twitter Meetup at the Hacker Dojo

transcript

What's Next & Big with Twitter

@hackerdojoJuly 1, 2010

#tmeetup @themattharris @raffi @hackerdojo

About us

The team

@themattharrisAbout us

@raffiAbout us

160,000

160,000Registered third-party Applications

75%Traffic on Twitter comes from places outside of twitter.com

65 Million

65 MillionTweets per day

65%Users are outside of the United States

3.5 Billion

3.5 BillionRequests per day to the API

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

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

What is ? The Twitter Platform

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

The goals of ‣ To be ridiculously simple

‣ To be obvious

‣ To be self-describing

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

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

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

@anywhere

Core Features‣ Hovercards

‣ Tweet Box

‣ Follow Buttons

‣ Linkify

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>

Easiest Example

<head> <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>

Easiest Example

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("#follow-placeholder").followButton('themattharris'); T("#tbox").tweetBox({ label: "Careful! This is a real tweet box.", defaultContent: "tweet tweet ", height: 300, width: 700 }); },

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 }); });

Easiest Example

More Info... Check outbit.ly/anywhere-begin

OAuthpocalypseThe day is 30th June 16th August 2010

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

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

xAuth not XAuth

xAuth is OAuth

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

Check your host!

api.twitter.com

twitter.com

Libraries

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

ActionScript/FlashC/C++C#/.NETClojureErlangJavaJavaScript

Objective-C/Cocoa & iPhone ProgrammingPerlPHPPythonQtRubyScala

OAuth Echo

‣ Delegation for Identity Verification

‣ Pass the header needed for an application to confirm your identify with Twitter

OAuth Echo

Services offering it‣ yFrog

‣ TwitPic

‣ TwitVid

‣ TweetPhoto

‣ Mobypicture

‣ Twitgoo

‣ Posterous

‣ img.ly

‣ Vodpod

Endpoints‣ /1/geo/search

‣ /1/geo/similar_places

‣ /1/geo/reverse_geocode

‣ /1/geo/id/:id

‣ /1/geo/place

/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

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

/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

/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

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

/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/id/:id

/1/geo/id/:id‣ Information on a place

‣ :id from /geo/search methods

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

/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

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

Use in search‣ just pass place:place_id

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

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",}

Timelines

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

Modifiers‣ include_rts

Accepted values: true, 1, t

‣ include_entities

‣ trim_user

What is a Tweet?The anatomy of a status update

Dissecting a status object

{"id"=>12296272736,

"text"=>

"An early look at Annotations:

http://groups.google.com/group/twitter-api-announce/browse_thread/thread/fa5da2608865453",

"created_at"=>"Fri Apr 16 17:55:46 +0000 2010",

"in_reply_to_user_id"=>nil,

"in_reply_to_screen_name"=>nil,

"in_reply_to_status_id"=>nil

"favorited"=>false,

"truncated"=>false,

"user"=>

{"id"=>6253282,

"screen_name"=>"twitterapi",

"name"=>"Twitter API",

"description"=>

"The Real Twitter API. I tweet about API changes, service issues and

happily answer questions about Twitter and our API. Don't get an answer? It's on my website.",

"url"=>"http://apiwiki.twitter.com",

"location"=>"San Francisco, CA",

"profile_background_color"=>"c1dfee",

"profile_background_image_url"=>

"http://a3.twimg.com/profile_background_images/59931895/twitterapi-background-new.png",

"profile_background_tile"=>false,

"profile_image_url"=>"http://a3.twimg.com/profile_images/689684365/api_normal.png",

"profile_link_color"=>"0000ff",

"profile_sidebar_border_color"=>"87bc44",

"profile_sidebar_fill_color"=>"e0ff92",

"profile_text_color"=>"000000",

"created_at"=>"Wed May 23 06:01:13 +0000 2007",

"contributors_enabled"=>true,

"favourites_count"=>1,

"statuses_count"=>1628,

"friends_count"=>13,

"time_zone"=>"Pacific Time (US & Canada)",

"utc_offset"=>-28800,

"lang"=>"en",

"protected"=>false,

"followers_count"=>100581,

"geo_enabled"=>true,

"notifications"=>false,

"following"=>true,

"verified"=>true},

"contributors"=>[3191321],

"geo"=>nil,

"coordinates"=>nil,

"place"=>

{"id"=>"2b6ff8c22edd9576",

"url"=>"http://api.twitter.com/1/geo/id/2b6ff8c22edd9576.json",

"name"=>"SoMa",

"full_name"=>"SoMa, San Francisco",

"place_type"=>"neighborhood",

"country_code"=>"US",

"country"=>"The United States of America",

"bounding_box"=>

{"coordinates"=>

[[[-122.42284884, 37.76893497],

[-122.3964, 37.76893497],

[-122.3964, 37.78752897],

[-122.42284884, 37.78752897]]],

"type"=>"Polygon"}},

"source"=>"web"}

The tweet's unique ID. These

IDs are roughly sorted &

developers should treat them

as opaque (http://bit.ly/dCkppc).

Text of the tweet.

Consecutive duplicate tweets

are rejected. 140 character

max (http://bit.ly/4ud3he).

Tweet's

creation

The ID of an existing tweet that

this tweet is in reply to. Won't

be set unless the author of the

referenced tweet is mentioned.The screen name &

user ID of replied to

tweet author. Truncated to 140

characters. Only

possible from SMS.

eet. T

bedded o

ct can g

et out of sync.

The author's

user name.

The author's

screen name.

The author's

biography.

The author's

URL.The author's "location". This is a free-form text field, and

there are no guarantees on whether it can be geocoded.

Rendering information

for the author. Colors

are encoded in hex

values (RGB).The creation date

for this account.Whether this account has

contributors enabled

(http://bit.ly/50npuu). Number of

favorites this

user has.

Number of

users this user

is following.The timezone and offset

(in seconds) for this user.

The user's selected

language.

Whether this user is protected

or not. If the user is protected,

then this tweet is not visible

except to "friends".

Number of

followers for

this user.

enable

http://b

it.ly/4

DEPRECATED

in this context

Whether this user

has a verified badge.

eo tag o

n this

eet in

(http://b

it.ly/b

The contributors' (if any) user

IDs (http://bit.ly/50npuu).

DEPRECATED

The place associated with this

Tweet (http://bit.ly/b8L1Cp).

The place ID

The URL to fetch a detailed

polygon for this placeThe printable names of this place

The type of this

place - can be a

"neighborhood"

or "city"

The country this place is in

The bounding

box for this

The application

that sent this

tweetMap of a Twitter Status Object

Raffi Krikorian <raffi@twitter.com>18 April 2010

{"id"=>12296272736,

"text"=>

"favorited"=>false,

"truncated"=>false,

"user"=>

{"id"=>6253282,

"description"=>

"lang"=>"en",

"protected"=>false,

"following"=>true,

"verified"=>true},

"geo"=>nil,

"coordinates"=>nil,

"place"=>

{"id"=>"2b6ff8c22edd9576",

"name"=>"SoMa",

"bounding_box"=>

{"coordinates"=>

[[[-122.42284884, 37.76893497],

[-122.3964, 37.76893497],

[-122.3964, 37.78752897],

[-122.42284884, 37.78752897]]],

"source"=>"web"}

Text of the tweet.

Tweet's

creation

characters. Only

possible from SMS.

eet. T

bedded o

ct can g

et out of sync.

The author's

user name.

The author's

screen name.

The author's

biography.

The author's

are encoded in hex

favorites this

user has.

Number of

users this user

The user's selected

language.

Number of

followers for

this user.

enable

http://b

it.ly/4

DEPRECATED

in this context

Whether this user

eo tag o

n this

eet in

(http://b

it.ly/b

DEPRECATED

The place ID

The type of this

place - can be a

"neighborhood"

or "city"

The bounding

box for this

The application

that sent this

Dissecting a status object

{"id"=>12296272736,

"text"=>

"favorited"=>false,

"truncated"=>false,

"user"=>

{"id"=>6253282,

"description"=>

"lang"=>"en",

"protected"=>false,

"following"=>true,

"verified"=>true},

"geo"=>nil,

"coordinates"=>nil,

"place"=>

{"id"=>"2b6ff8c22edd9576",

"name"=>"SoMa",

"bounding_box"=>

{"coordinates"=>

[[[-122.42284884, 37.76893497],

[-122.3964, 37.76893497],

[-122.3964, 37.78752897],

[-122.42284884, 37.78752897]]],

"source"=>"web"}

Text of the tweet.

Tweet's

creation

characters. Only

possible from SMS.

The author's

user name.

The author's

screen name.

The author's

biography.

The author's

are encoded in hex

favorites this

user has.

Number of

users this user

The user's selected

language.

Number of

followers for

this user.

it.ly/4

DEPRECATED

in this context

Whether this user

it.ly/b

DEPRECATED

The place ID

The type of this

place - can be a

"neighborhood"

or "city"

The bounding

box for this

The application

that sent this

Context is everything

#hashtagsThose things you add to a Tweet for grouping

@mentionsTalk about or to another user

51.495466,-0.146341Locates a Tweet

via My Appwhat created the Tweet

dev.twitter.comThe developer portal

Creating an appYour own small playground

Browsing docsRemembering how to read

Streaming APINear-Realtime Access to Public Statuses

Streaming API‣ A persistent connection to Twitter servers

‣ Get pushed a tweet that matches your predicate in “real-time”

‣ Server to server integrations

Basic Usage‣ Curl with Basic Auth or Twurl with OAuth

‣ One connection per username permitted

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

Follow some users‣ Curl with Basic Auth or Twurl with OAuth

‣ Pass up to 400 user_ids, comma seperated

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

Filter by keyword‣ Curl with Basic Auth or Twurl with OAuth

‣ 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

Streaming API - Access Levels‣ Default

Streaming API - Default Level‣ 200 x Keywords

‣ 400 x Follow userids

‣ 10 x 1-degree location boxes

‣ Shadow - many followings

‣ Birddog - many more followings

‣ Restricted Track - many keywords

‣ Partner Track - many more keywords

‣ locRestricted - many locations

‣ Shadow - many followings

‣ Birddog - many more followings

‣ Restricted Track - many keywords

‣ Partner Track - many more keywords

‣ locRestricted - many locations

‣ Firehose - all public statuses

Streaming API - Firehose

More Info... Check outbit.ly/streaming_api

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

Keyfacts‣ Rate limits practically eliminated

‣ Hit the API for backfill of data

‣ Transition to userstream for real-time updates

‣ Social events streamed too

More Info... Check outbit.ly/userstreams-betabit.ly/userstreams-overview

Stay Informed... Joinbit.ly/twitter-anywhere-talkbit.ly/twitter-dev-talk

Important Stuff@twitterapistatus.twitter.combit.ly/twitter-api-announce

Help... Check outdev.twitter.com

Join the Flock! Find out morejobs.twitter.com

Questions? Follow us attwitter.com/twitterapitwitter.com/themattharristwitter.com/raffi

Twitter Meetup at the Hacker Dojo

Technology