Digg API

 

News

Page history last edited by KurtW 7 mos ago

News

 

Digg Short URLs

by Kurt Wilms at 4pm, April 16th, 2009

 

We recently updated the API documentation with information about the new Digg Short URLs. You can use these new API endpoints to easily create Digg Short URLs or get information about existing short URLs. In addition, we've added short URL information to the story elements returned from the API. You'll find the new docs here: http://apidoc.digg.com/ShortURLs

 

Enjoy,

Kurt

 

Digg's Public API Proxy and Good API Application Design

by Kurt Wilms at 11am, April 23rd, 2008

 

We recently updated the API documentation with info about our public, cached API proxy. You'll find the new docs starting here: http://apidoc.digg.com/BasicConcepts#BePolitePlease

 

High-traffic applications, especially client-side applications like... widgets, toolbars, and Flash apps should cache API responses to avoid making lots of repetitive requests for the same data. The public API proxy is one convenient way to do that caching.

 

Enjoy,

Kurt

 

Latest API Updates

by Steve Williams at 4pm, Feb 4th, 2008

 

As you know, in December, we launched Digg Images and made some changes to how stories are organized on Digg. Naturally, at the same time, we enhanced the API so you can create applications that work more smoothly with the new Digg features. It was a challenge to ensure the enhancement didn't break existing applications.

 

When we added images to Digg's existing support for news and videos, we made a big related change: News, videos, and images all are organized under a single set of topics. (Before, videos topics were separate from news topics.)

 

We added two endpoints to allow applications to adapt seamlessly to changes like this in the future:

 

  • List Media returns the available media, currently news, videos, and images.
  • List Containers returns the list of available topic containers, e.g. "Technology," "World & Business," and so on, and the topics within each container. List Topics is still there, and still returns the topics directly.
  • List Stories now returns a blended view of all media: news, videos, and images.
  • List Stories now accepts a media argument, so you can request stories of a single medium (e.g. only news), or a subset of media (e.g. news and videos, but not images).
  • List Stories now includes a thumbnail element for stories that have a thumbnail available. Several sizes of thumbnails are available.

 

Since Digg Images was released, we've also made some minor additions to the API responses:

 

  • List Stories now adds an inaccurate="1" attribute to each story that has been voted inaccurate by Digg users.
  • List Events now provides a level attribute on each comment and a root attribute to each reply, to make it easier for applications to follow comment threads and link directly to individual comments. The level attribute gives the level of the comment within the thread, where the root of the thread is level zero. The root attribute gives the numeric ID of the root comment of the reply's thread.
  • List Users now adds a fullname attribute to each user element, if the user has made it public.
  • The List Stories endpoints /users/{username}/friends/dugg and /users/{username}/friends/commented now return the friends who dugg or commented on each story.
  • The List Users endpoint /get/user/{username} now returns the user's MicroID and profile links.

 

When we make changes like this, we always think about backward compatibility. In general, we believe that adding attributes and new sub-elements won't break existing applications, if they're well-written. As always, we want your feedback: Let us know if you had to alter your application to accommodate changes we made.

 

In the next few weeks, we plan to release a few other API enhancements. Watch this space!

 

As always, if you have questions, comments, or suggestions, please post them to the Digg API Community Support Forum.

 

Thanks!

 

 

 

Gallery Photos

by Kurt Wilms at 6pm, Oct 25th, 2007

 

Digg recently launched redesigned user profiles. Among other new features, Digg users now can upload photos to a gallery and share the gallery with their friends or all Digg users.

 

Naturally, we built the new galleries on top of the Digg API, and that means Digg API developers can build applications that display thumbnails and link to the 350,000+ gallery photos uploaded thus far.

 

We've published draft documentation to help you get started. When you see "(Draft)" in the documentation, that means you may go ahead and use the feature in your programs, but be aware that the documentation or the API may change if you or other developers find errors.

 

Please post questions, problems, and suggestions to the Digg API Community Support Forum.

 

Thanks!

 

 

 

New API Features, Documentation for Community Review

by Kurt Wilms at 10pm, Sep 24th, 2007

 

You're not the only ones using the Digg API. We use the API to build parts of the Digg web site itself! Often, we enhance the API to meet the needs of the Digg web site, and most of those enhancements are available to you Digg API developers. Or they would be, if only we could keep up with the documentation! To get the documentation into your hands quicker, we decided to do the Diggish thing: We'll let you review the draft documentation and tell us if it's not clear or contains errors.

 

When you see "(Draft)" in the documentation, that means you may go ahead and use the feature in your programs, but be aware that the documentation or the API may change if you or other developers find errors.

 

Some of the new features include:

 

  • The ability to access our top ten lists and hottest upcoming lists.
  • The ability to request all popular or upcoming stories submitted by a given Digg user or the friends of a Digg user.
  • Sorting stories by most Diggs
  • The ability to request story data for a user's Diggs and comments. This means you no longer need to make multiple API requests to get story information related to diggs and comments.

 

You can find all the API endpoints and associated draft documentation here: http://apidoc.digg.com/. If the documentation isn't clear, or you find mistakes, please post a message to the Digg API Community Forum.

As always, we’ll be building on this release of the API with future releases that allow developers to interact in even greater ways with Digg data.

 

Enjoy,

Kurt

 

 

 

And the winner is…

by Daniel Burka at 7am, May 31st, 2007

 

The Diggs are in and you’ve chosen the winners of the Flash API Contest! Chris Alvares, Ryan Robinson, and Hart Woolery came out on top. Check out Digg Labs to view the apps that they created. We’ll be featuring them in Labs for a little while so more of you will have an opportunity to check out their creations.

 

There are lots of people that we want to thank for helping make this contest happen. First, we want to thank everyone in the Digg community for choosing the winners from amongst the finalists. Second, thanks to the many people who created works for the contest. We were really blown away with the range of works and the creativity that was represented in each. Finally, thanks to the great sponsors who provided the awesome prizes for our contestants. The finalists and winners will be receiving some pretty sweet prizes.

 

There was a tremendous amount of interest and we hope everyone enjoyed trying out these apps as much as we did.

 

 

 

Flash API Contest Finalists Announced

by Daniel Burka at 10am, May 24th, 2007

 

I and the other judges (Jonathan Gay, Shawn Allen, and Kevin Rose) have really enjoyed reviewing all the awesome works that were submitted as part of the Digg API Contest. It was really hard to choose the best works but we’ve narrowed it down to the top 10 submissions. You can find the finalists listed on the Contest page, along with links to each of the works.

 

Now the judging is in your hands. Between now and 8pm PDT on May 30th, you can view and Digg your favorite works and tell us which you think are the best. The top three will go home with some pretty sweet prizes. We’re excited to hear what you all think.

 

You stay classy, Internet.

 

 

 

1 Week Left

by Kevin Rose at 2pm, May 9th, 2007

 

Just want to remind everyone that the deadline for submissions to the Digg API Contest is next Wednesday, May 16th at 8pm. Activity to the API has increased significantly since the launch and we’ve heard of a lot of great works in progress for the contest. We’re looking forward to getting your entries and seeing how you’ve thought of visualizing Digg. Remember, there are some great prizes available from Adobe, EA, Falcon Northwest, and Palm, not to mention the Digg schwag for all 10 finalists.

 

Stay tuned for more updates soon, including a list of the finalists with links for you to Digg your favorites.

 

Kevin

 

 

 

Digg API, Flash Application Toolkit, and Contest Announced!

by Kevin Rose at 8pm, Apr 19th, 2007

 

Many of you have been asking about the Digg API and I’m happy to announce that it is now publicly available at services.digg.com along with a Flash application toolkit. This will be a great tool for Digg users and partners to openly access all Digg data dating back to 2004.

 

To kick off the API release, starting today we’re launching a contest for the most creative and innovative visualizations and applications developed by our community using the API and Flash toolkit. All of the top 10 finalists will get prizes, with a Grand Prize featuring a Falcon Northwest gaming PC, the full catalog of EA PC games, and the Adobe CS3 Master Collection.

 

Big thanks to stamen design for their help in the development and design of the API and flash toolkit. As always, we’ll build on this first release with future releases that allow developers to interact in even greater ways with Digg data.

 

I’m looking forward to seeing the creativity that is unleashed from this new API release and good luck to all of you participating in the contest!

 

Digg on,

 

Kevin

 

Comments (0)

You don't have permission to comment on this page.

Printable version
 
Anonymous Create an account or Log in