List Users

 

List Users Example Request Example Responses XML JSON PHP Endpoints Arguments

 

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

All users.

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.

GET /user/{user name}

Named user.
404 Not Found response if the user does not exist.

GET /user/{user name}/friends

Named user's friends.
404 Not Found response if the user does not exist.

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.

GET /user/{user name}/fans

Users who count the named user as a friend.
404 Not Found response if the user does not exist.

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

 

Additional query string parameters to endpoints above. See also 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).