Digg API

 

ListUsers

Page history last edited by Bill Shupp 3 mos ago

List Users

 


 

Fetches a list of users from Digg.

 

Example Request

 

Retrieve most details on user sbwms:

 

 

http://services.digg.com/user/sbwms?appkey=http%3A%2F%2Fapidoc.digg.com  

 

Example Responses

 

XML

 

 

<?xml version="1.0" encoding="utf-8" ?>
<users timestamp="1176998598" total="1" offset="0" count="1">
<user name="sbwms" icon="http://digg.com/img/user-large/user-default.png" registered="1135702996" profileviews="3104" />
</users>

 

JSON

 

 

{
"timestamp" : 1176998604,
"total" : "1",
"offset" : 0,
"users" : [
{
"name" : "sbwms",
"icon" : "http://digg.com/img/user-large/user-default.png",
"registered" : 1135702996,
"profileviews" : 3104
}
],
"count" : 1
}

 

PHP

 

 

O:12:"DiggAPIUsers":5:{s:9:"timestamp";i:1176998609;s:5:"total";s:1:"1";s:6:"offset";i:0;s:5:"users";a:1:{i:0;O:11:"DiggAPIUser":4:{s:4:"name";s:5:"sbwms";s:4:"icon";s:61:"http://digg.com/img/user-large/user-default.png";s:10:"registered";i:1135702996;s:12:"profileviews";i:3104;}}s:5:"count";i:1;}

 

Endpoints

 

 

GET /users/{comma-separated list of user names}
A list of users with the given names. (E.g., GET /users/kwilms,kevinrose)

403 Forbidden with explanatory message for more than 100 names.

Arguments: size, sort, count, offset
GET /user/{user name}
Named user.

404 Not Found response if the user does not exist.

Arguments:  size
GET /user/{user name}/friends
Named user's friends.
Arguments: count, sort, offset, size
404 Not Found response if the user does not exist.

Arguments: size, sort, count, offset

GET /user/{user name}/friend/{friend user name}
Named user's friend.

404 Not Found if one of the users does not exist, or the first user has not befriended the second user.

The first user name is the befriender, the second is the befriended.

Arguments: size

GET /user/{user name}/fans
Users who count the named user as a friend.

404 Not Found response if the user does not exist.

Arguments: size, sort, count, offset
GET /user/{user name}/fan/{fan user name}
User who counts the named user as a friend.

404 Not Found if one of the users does not exist, or the second user has not befriended the first user.

The first user name is the befriended, the second is the befriender.

Arguments: size

 

Arguments

 

Query string parameters to use with the endpoints above (see each endpoint for which arguments apply).  Also see ResponseTypes and ApplicationKeys.

 

 

sort
How to sort returned users.

One of:

username-asc: A-Z.

username-desc: Z-A (default).

Default: username-asc

count
Number of users to retrieve.

Integer.

Default: 10, Maximum: 100.

403 Error with explanatory message is returned for count > 100.

offset
Offset in complete user list.

Integer.

Default: 0.

size
Requested user icon size.

One of:

s: small size (16px x 16px).

m: medium size (30px x 30px).

l: large size (48px x 48px) (default).

h: profile size (120px x 120px).

 

Comments (0)

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