Our Vision: The Twitter Metadata Revolution
SlideshowAt Peoplebrowsr we have been working with social media data since 2006, building rich APIs. We are now sharing these rich metadata APIs with the developer and corporate community.
API Features
Add your own metadata
Add your metadata on users or indvidual tweets to the cloud. Your metadata will soon be searchable itself.Revenue Sharing
We are building a revenue sharing framework for the metadata cloud. Revenue earnt from cloud metadata elements will be distributed to developers who have contributed to the cloud. A private Beta of the revenue share module will be available later in 2010Authentication
The PeopleBrowsr API uses OAuth for authentication of API requests. OAuth Keys will be assigned on registration.API Endpoints
Search in followers
v1/search/post/follower/
Searched for twitter posts matching the specified critieria from the followers of a specified user.parameters
- username (*) a twitter username
- search a [search string] to match against the post text
- starttime unix timestamp of earlies record to return
- endtime unix timestamp of most recent record to return
- count maximum number of records to return
response format
search infoRelated wkeywords
v1/search/related/
Get wordcloud data for a keywordparameters
- hash the hash provided from a search info response
response format
search infoCollect results
v1/search/results/
Collect the results for a searchparameters
- hash the hash provided from a search info response
response format
posts, user info or otherAudience profile
v1/audience/
Request a report on the demographics (estimates of gender percentages, locations) of the followers of a twitter user.parameters
- username a twitter username
response format
search infoFollower churn
v1/audience/churn/
Request a report on new follower count, unfollow count for a specified time period for a given twitter user.parameters
- username a twitter username
- starttime unix timestamp of earlies record to return
- endtime unix timestamp of most recent record to return
response format
search infoMutual connections
v1/audience/shared/
Find the list of twitter users that follow both the specified usernamesparameters
- username_a (*) a twitter username
- username_b (*) a twitter username
response format
search infoCreate metadata
v1/metadata/field_create/
Define a metadata fieldparameters
- fieldname (*) a name for your metadata field
- applies_to (*) set to 'user' or 'post' as appropriate
- description a longer description of what your metadata represents (mostly useful for public metadata)
- public set to 'true' to make your metadata publicly accessable (read only)
response format
metadata definitionAvailable metadata
v1/metadata/list/
returns a list of the metadata definitions available to the authenticating userresponse format
metadata definitionUpload Metadata
v1/metadata/bulk_upload/ POST
Upload metadataparameters
- fieldid (*) the metadata field id to upload to
- POST data is to be json-encode array of key / value pairs
Oauth Request Token
v1/oauth/request/
endpoint to obtain a request tokenparameters
Oauth Access Token
v1/oauth/access/
endpoint to request an access tokenparameters
Threaded conversation
v1/post/thread/
parameters
- messageid a twitter message id
response format
postsResponse formats
posts
[
{
"created": 1254614315,
"text": "Cute kittens :)",
"private": false,
"source": "twitter",
"user": {
"name": "Katie W-R",
"longitude": " 0.0000",
"source": "twitter",
"followers": 6,
"latitude": " 0.0000",
"metadata": {
},
"id": "treatsandsuch",
"screen_name": "treatsandsuch"
},
"reply_to": "",
"id": "4590760805"
}
]users
[
{
"name": "Katie W-R",
"longitude": " 0.0000",
"source": "twitter",
"followers": 6,
"latitude": " 0.0000",
"metadata": {
},
"id": "treatsandsuch",
"screen_name": "treatsandsuch"
}
]metadata defintion
[
{
"id": "23",
"fieldname": "catowner",
"description": "Does this twitter user own a cat",
"access": "public"
}
]search info
[
{
"req_id": "21",
"hash": "7563c95bd2bbac89",
"status": "queued",
"time_est": "15"
}
]