Top vs. Popular

6 views
Skip to first unread message

richard@flock

unread,
Mar 27, 2008, 6:09:25 PM3/27/08
to Digg API
Can someone clarify for me the difference between the 2 API calls: /
stories/popular & /stories/top ? What criteria labels a story
"popular" vs
"top" ? I'm also noticing that you can sort by digg count for popular
stories but not for top stories - is this a bug?

Steve Williams

unread,
Mar 27, 2008, 6:35:13 PM3/27/08
to dig...@googlegroups.com
At 03:09 PM 3/27/2008, richard@flock wrote:
>What criteria labels a story "popular" vs "top"?

"Popular" means that Digg's promotion algorithm put the story on the
front page.

From among the stories recently made popular, a different algorithm
selects the "top" stories, and then presents them ordered by
descending Digg count. (The recency depends on the topic or
container selected, because some topics get more submissions than others.)

"Hot" is similar to "top": An algorithm selects "hot" stories from
the upcoming stories--those that have not yet been made popular.

Digg doesn't disclose those algorithms, but, obviously, they involve
more than just the raw number of Diggs.

>... you can sort by digg count for popular stories but not for top

>stories - is this a bug?

No, that's by design. Top and hot stories are always sorted by
descending Digg count, so the sort argument is disallowed.

We use these API endpoints to generate the Top widget on the Popular
pages and the Hot widget on the Upcoming pages. Those same widgets
are available to embed in your own web page:

http://digg.com/add-digg

If you build a Top 10 widget and examine the Javascript, you'll see
the API endpoint (called via our public API proxy, part of the
Services_Digg PEAR package).

Reply all
Reply to author
Forward
0 new messages