Free yourself from silo API chaff and expose the sweet social data foodstuff inside in standard formats and protocols!
Project description
Granary is a library and REST API that fetches and converts social network data between a wide variety of formats:
Facebook, Flickr, Google+, Instagram, and Twitter native APIs
Instagram and Google+ scraped HTML
microformats2 HTML
microformats2 JSON
XML
Try out the interactive demo and check out the docs.
License: This project is placed in the public domain.
Using
The library and REST API are both based on the OpenSocial Activity Streams service.
Let’s start with an example. This code using the library:
from granary import twitter
...
tw = twitter.Twitter(ACCESS_TOKEN_KEY, ACCESS_TOKEN_SECRET)
tw.get_activities(group_id='@friends')is equivalent to this HTTP GET request:
https://granary-demo.appspot.com/twitter/@me/@friends/@app/ ?access_token_key=ACCESS_TOKEN_KEY&access_token_secret=ACCESS_TOKEN_SECRET
They return the authenticated user’s Twitter stream, ie tweets from the people they follow. Here’s the JSON output:
{
"itemsPerPage": 10,
"startIndex": 0,
"totalResults": 12
"items": [{
"verb": "post",
"id": "tag:twitter.com,2013:374272979578150912"
"url": "http://twitter.com/evanpro/status/374272979578150912",
"content": "Getting stuff for barbecue tomorrow. No ribs left! Got some nice tenderloin though. (@ Metro Plus Famille Lemay) http://t.co/b2PLgiLJwP",
"actor": {
"username": "evanpro",
"displayName": "Evan Prodromou",
"description": "Prospector.",
"url": "http://twitter.com/evanpro",
},
"object": {
"tags": [{
"url": "http://4sq.com/1cw5vf6",
"startIndex": 113,
"length": 22,
"objectType": "article"
}, "..."],
},
}, "..."]
"..."
}Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
