With the Wigitize API you can
- - let your users import feeds into your application
- - after exposing your content in RSS, providing widgets is easy!
#1 JSON Quick Embed
This is the most easy way to use our API. You simply add a few lines of Javascript to your Application to load a data feed.
My Blog
loading my blog posts
First, the necessary includes - wigitize.js and the PrototypeJS Library.
<script type="text/javascript" src="http://wigitize.com/javascripts/prototype.js"></script>
<script type="text/javascript" src="http://wigitize.com/javascripts/wigitize.js"></script>
Then simply call wigitize_url() with your target id and URL. This URL can either be an RSS/Atom feed or a blog URL.
<div id="my_blog">
loading my blog posts
</div>
<script type="text/javascript">
/* set some options */
wigitize_entry_count = 6;
wigitize_show_date = true;
wigitize_on_error = function(container_id) {
alert('could not load data into: ' + container_id);
}
/* Yeah Baby! */
wigitize_url('my_blog', 'http://dominiek.com/?wigitize_demos');
</script>
On the right hand side you see the result of this code. The first time you will call wigitize_url we will have to aggregate for the first time so this can take a couple of seconds.
At this moment we cannot guarantee any performance. However, if you have an application with heavy usage, please contact us - surely we can figure something out :-)
#2 Just gimme that JSON feed
As you might know, the underlying principle of all of this is converting a data source into JSON. With this JSON feed you can use the data easily in Javascript. This makes it easy to provide a badge/widget and to skip all server-side processing hardships. (more about different kind of data feeds)
To get the JSON feed for a website call this URL (using AJAX, browser or your application):
http://wigitize.com/json/for/<RSS/Atom feed or plain URL>
So if I would like the JSON feed for the blog 'http://dominiek.com/', this would be the transaction:
GET http://wigitize.com/json/for/http://dominiek.com/
=> http://wigitize.com/feeds/19.json
Please note that it might take up to 10 seconds for the JSON URL to actually work (the first time).
JSON feed datastructure
More data like tags, summary, microformats etc. will be added shortly.
Please feel free to contact us if you have any other Wigitize API needs.
