- (DiggObject *)fetchStoryWithID:(int)ID;
- (DiggObject *)fetchStoryWithTitle:(NSString *)name;
- (DiggObject *)fetchStoryWithURL:(NSString *)url;
- (NSMutableArray *)fetchStoriesForDomain:(NSString *)domain;
- (NSMutableArray *)fetchStoriesForTopic:(NSString *)topic;
- (NSMutableArray *)fetchStoriesForContainer:(NSString *)container;
- (NSMutableArray *)fetchStoriesSubmittedBy:(NSString *)user;
- (NSMutableArray *)fetchPopular;
- (NSMutableArray *)fetchRecent;
- (NSMutableArray *)fetchStories;
- (NSMutableArray *)fetchUpcoming;

It’s also just as easy to set the options or parameters that you would like to call the query with:

-(void)setAppkey:(NSString *)newAppkey;
-(NSString *)appkey;

-(NSString *)proxy;
-(void)setProxy:(NSString *)newProxy;

-(BOOL)single;
-(void)setSingle:(BOOL)newSingle;

-(int)count;
-(void)setCount:(int)newCount;

-(int)offset;
-(void)setOffset:(int)newOffset;

-(int)total;

-(NSString *)domain;
-(void)setDomain:(NSString *)newDomain;

-(NSString *)sortBy;
-(void)setSortBy:(NSString *)newSort;

-(NSString *)status;
- (void)setStatus:(NSString *)newStatus;

- (NSString *)minSubmitDate;
- (void)setMinSubmitDate:(NSString *)newMinSubmitDate;

- (NSString *)maxSubmitDate;
- (void)setMaxSubmitDate:(NSString *)newMaxSubmitDate;

- (NSString *)minPromoteDate;
- (void)setMinPromoteDate:(NSString *)newMinPromoteDate;

- (NSString *)maxPromoteDate;
- (void)setMaxPromoteDate:(NSString *)newMaxPromoteDate;

Currently the focus is on fetching stories, but fetching information for users, events (Diggs and comments), topics and containers will be written in shortly.

The only major thing lacking now is people to use the framework!

If you’re interested, drop a comment below and I’ll provide you with the necessary ammunition to create, fetch, parse and utilize Digg API calls with the ease of regular Objective-C Cocoa methods.

The official release date will depend on the response from the initial testers, so what are you waiting for? Ask me for a copy!

See it in action here.

If anyone has any ideas for a name, that would be very helpful!

This is the best way to stay up-to-date with the Digg status of your site. More accurate and informative than subscribing to a search, with using the just-released Digg API.

Feature-requests are welcome. Enjoy!

There have been attempts at figuring out the usage of the still-unreleased Digg API. However, Digg are yet to release their official API.

The staff at Digg were very kind in letting certain people have a play with the API before its release, and it’s looking to be, to put it bluntly, quite excellent. A lot of Digg plugins and services are going to be either made obsolete, or very happy with all the new possibilities that will be… well, possible!¹

For example, Lorelle talks about keeping track of your Dugg posts by subscribing to the search results RSS. This is only possible if you search for the past 7 or 30 days, and it doesn’t give you much information about the status, comments or diggs received on your posts. With the Digg API, this’ll be figuratively (because too many people use the word ‘literally’ figuratively) a breeze.

API’s are important, because they give people the opportunity to extend and use an application or service in a way that they like. A world without API is like Xcode without Cocoa or Carbon, or like the Mac without Applescript. An API helps to let the user do what they like, and it’s fun!

So web developers, start your engines for the Digg API…

Google & Cocoa

It may be API week or something, because Google have also conjured up an open source API for Mac developers to use Google data. The Google Data APIs Objective-C Library is a framework² that enables the use of Google data API’s within Objective C.

Greg Robbins posted some examples of this API at the Google Mac blog. Currently you can work with Google Calendar, Google Base, Google Spreadsheets and access to more services is in development. It seems to be a very nice framework, and I’m looking forward to seeing third party use of this.

That seems to round off API week. Any thoughts?