Welcome, guest Sign In

Usercard Profile

Description

The Usercard is the core data in the user's profile containing slightly more information than the tinyusercard.

URI

GET returns the usercard profile of the profile owner with the specified {guid}.

http://social.yahooapis.com/v1/user/{guid}/profile/usercard

Filters

Calling GET on the following URI returns the usercard profiles of the users identified by GUIDs {guid1}, {guid2}, and {guid3}.

v1/users.guid(144,976,541)/profile/usercard

HTTP Operations Supported

  • GET

Query Parameters Supported

  • callback
  • format

Matrix Parameters Supported

  • start
  • count

Scopes Required

  • GET:Read (Shared) Yahoo! Profiles

Elements of the Usercard Profile Object

Element JSON Data Type XML Schema Data Type Description
start number nonNegativeInteger Index of first usercard returned.
total number nonNegativeInteger Number of usercards returned.
count number nonNegativeInteger Total number of usercards.
guid string string GUID of the profile owner.
memberSince string dateTime Date of ID registration.
nickname string string Display name of the profile owner.
image Image object Image object Image of the profile owner.
size string string Image size (WxH).
width number positiveInteger Image width.
height number positiveInteger Image height.
imageURL string anyURI Display image of the profile owner. Returns a 48x48 pixeled image.
profileURL string anyURI URL of the profile.
displayAge number positiveInteger The proclaimed age chosen by the user, assumed to be public information. There is no check or verification. User can claim any age.
gender string enum The proclaimed gender chosen by the user, and assumed to be public information. There is no check or verification on this. Allowed values are "M", "F", or "Unspecified".
location string string The proclaimed location of the profile owner. There is no check or verification on this.
status Status object Status object Object containing the profile owner's status.
message string string Status text of the profile owner.
lastStatusModified string dateTime Time of the last status update.
uri string anyURI Reference to the actual resource.
created string dateTime Date resource was created.
updated string dateTime Date resource was last modified.

JSON Syntax for Single Usercard Profile Object

JSON Syntax for Multiple Usercard Profile Objects

Example JSON Response Body for GET Usercard

Example XML Response Body for GET Usercard

Table of Contents

Copyright © 2009 Yahoo! Inc. All rights reserved. Copyright | Privacy Policy

Help us continue to improve the Yahoo! Developer Network: Send Your Suggestions