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

All users.

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.

(Draft) 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).

 Create your own business wiki!Support CommunityPublic, Platinum wiki Privacy Policy RSS