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.