http://apidoc.digg.com/ RecentChanges for Digg API en http://apidoc.digg.com/feedlogo.gif http://pbwiki.com/ PBwiki 3.7 support@pbwiki.com http://apidoc.digg.com/FrontPage email.hidden@example.com (KurtW) KurtW edited FrontPage The Digg Application Programming Interface (API) has been created to let users and partners interact programmatically with Digg. The API returns Digg data in a form that can be easily integrated into an application or a web site. While the API is available to everyone free of charge, its use is subject to acceptance of our API License Agreement.
We intend to make most of the data on Digg.com available through the API. Currently, you can use the API to request very specific information about news stories and videos submitted to Digg, digging activity, comments, users, and gallery photos.
for PHP. PHP as well other open-source toolkits.
Thank you for interacting with and using the Digg API. If you have any questions, comments, or suggestions, please visit the DiggAPICommunitySupportForum.
Want to use the Digg API for commercial purposes? Contact us at partners@digg.com. Please provide as much detail as you can about your proposed application and how you would like the b]]> Wed, 23 Apr 2008 10:08:27 +0000 mod http://apidoc.digg.com/FrontPage email.hidden@example.com (KurtW) KurtW edited FrontPage]]> Wed, 23 Apr 2008 10:04:25 +0000 mod http://apidoc.digg.com/FrontPage email.hidden@example.com (KurtW) KurtW edited FrontPage Recent News
Digg's Public API Proxy and Good API Application Design
Apr 23th, 23rd, 2008
Latest API Updates
by Steve Williams at 4pm, Feb 4th, 2008
]]> Wed, 23 Apr 2008 10:03:56 +0000 mod http://apidoc.digg.com/FrontPage email.hidden@example.com (KurtW) KurtW edited FrontPage Digg API
Recent News
Digg's Public API Proxy and Good API Application Design
by Kurt Wilms at 11am, Apr 23th, 2008
Latest API Updates
by Steve Williams at 4pm, Feb 4th, 2008
Gallery Photos
by Kurt Wilms at 6pm, Oct 25th, 2007
New API Features, Documentation for Community Review
by Kurt Wilms at 10pm, Sep 24th, 2007
Background
The Digg Application Programming Interface (API) has been created to let users and partners interact programmatically with Digg. The API returns Digg data in a form that can be easily integrated into an application or a web site. While the API is available to everyone free of charge, its use is subject to acceptance of our API License Agreement.
]]> Wed, 23 Apr 2008 10:03:38 +0000 mod http://apidoc.digg.com/News email.hidden@example.com (KurtW) KurtW edited News News
Digg's Public API Proxy and Good API Application Design
by KurtWilms 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 SteveWilliams at 4pm, Feb 4th, 2008
]]> Wed, 23 Apr 2008 10:03:28 +0000 mod http://apidoc.digg.com/BasicConcepts email.hidden@example.com (Steve Williams) Steve Williams edited BasicConcepts We monitor API usage, and we may block applications that do silly things. Use good judgment to keep your application running smoothly!
Caching API Responses
API responses, responses and so should use caching to avoid getting blocked. This is especially true if you have a high-traffic web site and you want to display Digg data directly on your web pages. All web sites, regardless of traffic, should use one of these methods to cache API responses:
Make the API request in your server-side code and cache the response.
Set up a cached proxy on your web site. If your web page calls the Digg API via AJAX, you'll need a proxy in any case, due to Javascript security, and it's straightforward to add a cache to your proxy. You're welcome to use Services_Digg_Proxy from PEAR Services_Digg to implement your proxy, and you can easily add caching.
]]> Tue, 22 Apr 2008 14:51:18 +0000 mod http://apidoc.digg.com/BasicConcepts email.hidden@example.com (KurtW) KurtW edited BasicConcepts Note the timestamp in the response, and make another request with that timestamp as the min_date argument. The response will include items which immediately follow that timestamp, and a new value in the timestamp property.
Repeat step 2 to get even more current data.
remember, be polite: [#BePolitePlease|be polite]: Don't make requests every second, or our operations guys may see your application as an attacking robit. Consider making one request per minute, and processing or displaying the data between requests. That's how Stamen's flash toolkit does its magic.
Using Offsets
The offset and count arguments are used to ensure that each response is of a reasonable size. When a request specifies a large amount of data, such as many Diggs, users, or news items, each response provides only a portion of that data. Additional requests can retrieve, piece by piece, the desired result, by specifying an offset into the data and a count of elements to be returned. The maximum coun]]> Tue, 22 Apr 2008 14:41:26 +0000 mod http://apidoc.digg.com/Toolkits email.hidden@example.com (KurtW) KurtW edited Toolkits Dustin has written a library in Java
Tim has written another library in Java
Headzoo wrote a JavaWrapper
Ruby
John has written a Digg API wrapper in Ruby
neaveru has written a JavaScript API Toolkit that can be used to create client side web pages that interact with Digg.
.NET
irhetoricHeadzoo has written a .NET wrapper.
]]> Thu, 10 Apr 2008 08:19:41 +0000 mod http://apidoc.digg.com/LicenseAgreement email.hidden@example.com (Steve Williams) Steve Williams edited LicenseAgreement DIGG, INC. API LICENSE AGREEMENT
by Digg. Digg ("Digg Applications"). Licensee may not install or use the APIs for any other purpose (including without limit any commercial purpose) without Digg's prior written consent. For the sake of clarity, the sale of advertising on a website where a Digg Application is hosted shall not alone constitute a commercial use under this Agreement, provided that the advertising is not integrated within the Digg Application itself. Licensee shall not use the APIs in connection with or to ]]> Tue, 26 Feb 2008 09:58:24 +0000 mod http://apidoc.digg.com/News email.hidden@example.com (Steve Williams) Steve Williams edited News Since Digg Images was released, we've also made some minor additions to the API responses:
ListStories now adds an inaccurate="1" attribute to each story that has been voted inaccurate by Digg users.
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.
ListUsers now adds an a fullname attribute to each user element, if the user has made it public.
The ListStories endpoints /users/{username}/friends/dugg and /users/{username}/friends/commented now return the friends who dugg or commented on each story.
user's
MicroID MicroID and profile links.
When we make changes like this, we always think about backward compatibility. In general, we believe that addi]]> Mon, 04 Feb 2008 16:24:10 +0000 mod http://apidoc.digg.com/FrontPage email.hidden@example.com (KurtW) KurtW edited FrontPage Digg API
Recent News
Latest API Updates
by Steve Williams at 4pm, Feb 4th, 2008
Gallery Photos
by Kurt Wilms at 6pm, Oct 25th, 2007
New API Features, Documentation for Community Review
by Kurt Wilms at 10pm, Sep 24th, 2007
And the winner is…
by Daniel Burka at 7am, May 31st, 2007
Background
The Digg Application Programming Interface (API) has been created to let users and partners interact programmatically with Digg. The API returns Digg data in a form that can be easily integrated into an application or a web site. While the API is available to everyone free of charge, its use is subject to acceptance of our API License Agreement.
]]> Mon, 04 Feb 2008 16:09:47 +0000 mod http://apidoc.digg.com/News email.hidden@example.com (KurtW) KurtW edited News News
Latest API Updates
by SteveWilliams at 4pm, Feb 4th, 2008
As you know, in December, we launched DiggImages 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:
ListMedia returns the available media, currently news, videos, and images.
ListContainers 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]]> Mon, 04 Feb 2008 16:09:43 +0000 mod http://apidoc.digg.com/ListStories email.hidden@example.com (Steve Williams) Steve Williams edited ListStories If only max_promote_date specified: The 30 days preceding the max_promote_date.
min_date, max_date
Get comments and diggs created stories commented on or dugg within a given time period.
Valid only for these endpoints:
/user/{username}/dugg
]]> Wed, 30 Jan 2008 10:00:35 +0000 mod http://apidoc.digg.com/Topics email.hidden@example.com (KurtW) KurtW edited Topics Topics
Digg news is organized by "topic," and Digg groups topics into "containers." The List Stories endpoint lets you request news stories for just one topic or container.
Note that the Digg Videos section is actually a container named "Videos."
Digg adds and removes topics from time to time, so the API provides the List Topics endpoint to let your application display the current set of containers and topics and refer to the container or topic in the List Stories call.
Here is a list of the current containers and topics. (Note that this list is created through a Javascript call to the List Topics endpoint.)
]]> Wed, 05 Dec 2007 15:05:48 +0000 mod http://apidoc.digg.com/ListGalleryPhotos email.hidden@example.com (KurtW) KurtW edited ListGalleryPhotos Arguments
Additional query string parameters to endpoints above. See also Response Types and Application Keys.
(Draft) min_submit_date,min_submit_date, max_submit_date
Get gallery photos submitted within a given time period.
Values: Unix epoch integer.
If only min_submit_date specified: 30 days starting at the min_submit_date.
If only max_submit_date specified: The 30 days preceding the max_submit_date.
(Draft) sortsort
How to sort returned gallery photos.
One of:
digg_count-desc: highest digg count first.
digg_count-asc: lowest digg count first.
(Draft) countcount
Number of gallery photos to retrieve.
gallery photos count integer.
Default: 10, Maximum: 100.
403 Forbidden with explanatory message is returned for count > 100.
(Draft) offsetoffset
Offset in complete gallery photos list.
Gallery photos offset integer. Wed, 05 Dec 2007 15:04:20 +0000 mod http://apidoc.digg.com/ListGalleryPhotos email.hidden@example.com (KurtW) KurtW edited ListGalleryPhotos O:14:"DiggAPIGallery":6:{s:9:"timestamp";i:1193358478;s:8:"min_date";i:1190766450;s:5:"total";s:5:"31794";s:6:"offset";i:0;s:6:"photos";a:3:{i:0;O:19:"DiggAPIGalleryPhoto":7:{s:2:"id";i:3920948;s:11:"submit_date";i:1193358472;s:8:"comments";i:0;s:5:"title";s:39:"241_4171 Sun Halo Upper Tangent Arc.jpg";s:4:"user";O:11:"DiggAPIUser":4:{s:4:"name";s:15:"KalimaSaraswati";s:4:"icon";s:27:"http://digg.com/img/udl.png";s:10:"registered";i:1193358174;s:12:"profileviews";i:5;}s:3:"src";s:59:"http://digg.com/users/KalimaSaraswati/gallery/3920948/t.jpg";s:4:"href";s:53:"http://digg.com/users/KalimaSaraswati/gallery/3920948";}i:1;O:19:"DiggAPIGalleryPhoto":7:{s:2:"id";i:3920944;s:11:"submit_date";i:1193358452;s:8:"comments";i:0;s:5:&qu]]> Wed, 05 Dec 2007 15:03:35 +0000 mod http://apidoc.digg.com/CompleteList email.hidden@example.com (KurtW) KurtW edited CompleteList Alphabetical List of Endpoints
/containers (List Containers)
/container/{container short_name} (List Containers)
/errors (List Errors)
/error/{code} (List Errors)
(Draft) /galleryphotos/galleryphotos (List Gallery Photos)
(Draft) /galleryphotos/comments
/galleryphotos/comments (List Gallery Photos)
(Draft) /galleryphoto/{id}
/galleryphoto/{id} (List Gallery Photos)
(Draft) /galleryphoto/{id}/comments
/galleryphoto/{id}/comments (List Gallery Photos)
(Draft) /galleryphoto/{id}/comment/{id}
/galleryphoto/{id}/comment/{id} (List Gallery Photos)
(Draft) /galleryphoto/{id}/comment/{id}/replies
/galleryphoto/{id}/comment/{id}/replies (List Gallery Photos)
(Draft) /galleryphotos/{list}
/galleryphotos/{list} (List Gallery Photos)]]> Wed, 05 Dec 2007 15:02:49 +0000 mod http://apidoc.digg.com/SideBar email.hidden@example.com (KurtW) KurtW edited SideBar Toolkits
Endpoints:
List Containers
List Error Codes
List Events (Diggs/Comments)
List Gallery Photos
List Media
List Stories
List Topics
]]> Wed, 05 Dec 2007 14:59:23 +0000 mod http://apidoc.digg.com/ListEvents email.hidden@example.com (KurtW) KurtW edited ListEvents Event offset integer.
Default: 0.
media
Return events of selected media.
One of:
all: All media (default).
{medium}: The indicated medium.
{comma-separated list of media}: Any of the indicated media.
Each medium in must be the short_name attribute of one of the media returned by the List Media (link) endpoint, e.g. news, videos, or images.
]]> Wed, 05 Dec 2007 14:59:11 +0000 mod http://apidoc.digg.com/ListStories email.hidden@example.com (KurtW) KurtW edited ListStories XML
<?xml version="1.0" encoding="utf-8" ?>
<stories timestamp="1176997447" min_date="1174405440" total="3819" timestamp="1196894147" min_date="1194302130" total="2636" offset="0" count="3">
<story id="1806025" link="http://leowebpicks.blogspot.com/2007/04/1passwd-ultimate-password-manager.html" submit_date="1176997081" id="4368401" link="http://maxsangalli.altervista.org/?p=45" submit_date="1196891534" diggs="1" comments="0" href="http://digg.com/apple/Win_A_Free_Copy_of_1Passwd" status="upcoming">
<title>Win A Free Copy of 1Passwd&]]> Wed, 05 Dec 2007 14:59:09 +0000 mod