What is newsfeed.shtukas.net ?

newsfeed.shtukas.net is a news-feeder that I put together few hours after nytime.com published an article called Using Twitter as Your Database [open.blogs.nytimes.com, Thursday 16th June 2001], in which they explained how they used Twitter to keep track of their news stories. Inspired by this article newsfeed.shtukas.net was born a searchable database of news stories. You can think of newsfeed.shtukas.net as a Twitter service for computers. Ideally, publishing companies will register their news items to this site as part of their publishing workflow. Allowing people to have a clear, ordered, timeline of what has been published all around the world.

The service is just being born and has to be considered an alpha release. In particular submitting and searching tags has not been implemented yet.

How can I use it ? (part 1: format of the feed)

The feed

returns the last 1000 news items that have been posted to the server (in reverse chronological order -- newest first). The feed is free for all to use. The answer is a JSON string, encoded using UTF-8.

A typical item is

        "record_uuid": "6b97c9af13526807f987df2ec49840df",
        "record_unixtime": 1308242512,
        "record_datetime": "2011-06-16 16:41:52",
        "client_name": "physorg.com",
        "newsitem_clientuid": "",
        "newsitem_unixtime": 1308242568,
        "newsitem_datetime": "2011-06-16 16:42:48",
        "newsitem_title": "The Port of Athens was once an island",
        "newsitem_url": "http:\/\/www.physorg.com\/news\/2011-06-port-athens-island.html"
The keys of every individual items are as follow:

I am a (private or coorporate) publisher and I want to post a news item to the feed, how do I do that ?

You will basically need an API key as it would be unrealistic to let anybody register anything without previous registration. If you want an API key, please just send an email: newsfeed@shtukas.net. The API's url will be given to you together with your key.

How can I use it ? (part 2: specifing subsets)

This section specifies how to querying the feed to get subsets of what the standard answer would be (note that the specification is a draft and may change unexpectedly, refer to this page for the latest definitions). You can specify GET variables and POST variables in your query.

GET variables

POST variables