MySpace Developer Platform

A Place For Developers

Welcome Developers!

Welcome!

Data Availability REST Resources


Open Social REST Resources

Data Availability currently supports the Person resource of the OpenSocial REST specification for retrieving the member's data and the friends of the member.

The detailed specification can be found here: http://code.google.com/apis/opensocial/docs/0.8/restfulspec.html

Greater support for the OpenSocial REST resources is coming soon.

Person Resource

After you have used the OAuth Access delegation mechanism to retrieve an authorized Access Token and Token Secret, you may now make a signed HTTP GET Request to retrieve the member’s data. The URI of this request is:

http://api.myspace.com/v2/people/@me/@self?format=json

The necessary OAuth parameters must be included in the query string or the Authorization header as outlined above.

The fields parameter

The fields parameter may optionally be included on the request with a comma delimited list of fields the consumer would like in the response. The table below outlines the fields supported:

Person.Field

Object Fields
Enum Values

Supported Support Notes Example JSON Portable Profile Cacheable for 24 Hours
aboutMe
 
YES
  aboutMe:"not much you need to know About me"
NO
YES
activities
 
NO
 
NO
NO
addresses
 
NO
 
NO
NO
age
 
YES
  "age":47
YES
YES
bodyType

build, eyeColor,
hairColor,
height, weight

YES
We support
only build,
height
"bodyType":{"build":"Athletic","height":170}
NO
YES
books
 
YES

"books":["1984"," Fear
and Loathing"," Heaven and Hell"," The Doors of Perception by Huxley"," On the Road"," East of Eden"," Carrie"," Stephen Hawking"," Art and Physics."]
NO
YES
cars
 
NO
 
NO
NO
children
 
YES
  "children":"Someday"
NO
YES
currentLocation
 
YES
 

currentLocation:
{"country":"US","postalCode":
"11121", "region":"California"}

YES
YES
dateOfBirth
 
YES
  dateOfBirth:"1970-06-27T12
:00:00-07:00:00"
YES
YES
drinker
HEAVILY, NO, OCCASIONALLY,
QUIT, QUITTING,
REGULARLY,
SOCIALLY, YES
YES
We support
YES, NO
"drinker": { "value":"yes", "key":"yes" }
NO
YES
emails
 
YES
Only available on the REST API when user has set the permission.)

"emails":[{"value":
"msqapak110@gmail.com","primary":true}]

YES
YES
ethnicity
 
YES
  "ethnicity":"White \/Caucasian"
NO
YES
fashion
 
NO
 
NO
NO
food
 
NO
 
NO
NO
gender
 
YES
  "gender":"male"
YES
YES
happiestWhen
 
NO
 
NO
NO
hasApp
 
YES

"hasApp":true"
NO
YES
heroes
 
YES

heroes:["Sol Lewitt","Dan Flavin",
"Nataliee Dee", "Bridget Riley","the
Artists on Stencil Revolution"," Andy Warhol","The Beatles","Jenny Holzer",
"Bansky", "MEEK", "Logan Hicks Mondrian","Kant","Orwell", "Kubrick",
"Williams Street","Lichtenstein",
"CHANCE", "MIA", "and LOKI Tyler","Josie","Jamie","Steven Colbert",
"John Stewart","Sasha Cohen"," "]

NO
YES
humor
 
NO
 
NO
NO
id
 
YES
  "myspace.com:301847719"
NO
YES
interests
 
YES

interests:["Art"," Music"," Science",
" Kitties"," Photography"," Travel",
"Culture", "Conversations","Occasional
Yoga","meditation","NPR","Politics",
"Fashion"],
NO
YES
jobInterests
 
NO
 
NO
NO
jobs(renamed as organizations)
 
YES

"organizations": [{ "name":"myspace", "title":"software developer", "type":"job"}]
NO
YES
langaugesSpoken

Strings must be
ISO 639-1 codes

NO
 
NO
NO
livingArrangement
 
NO
 
NO
NO
lookingFor
ACTIVITY_
PARTNERS,
DATING, FRIENDS,
NETWORKING,
RANDOM,
RELATIONSHIP
YES
This is
DesireToMeet
mapped
as String
entered in
free text area
in Myspace Web
lookingFor:["friends"]
NO
YES
movies
 
YES

movies:
"GODFATHER 1 & 2, Alice in Wonder
land, Willy Wonka, The Wizard of OZ,
HELP, Yellow Submarine, A Hard Day's
Night, 2001: A SPACE ODYSSEY, Rebecca,
A Clockwork Orange, Down With Love,
Barry Lyndon, Excalibur, Kill Bill 1 & 2,
Chinese Connection, South Park,
Fist of Fury and Enter the Dragon,
Way of the Dragon, Citizen Cane, GIA, Dogma, Life of Brian, Scarface, Swimming
with Sharks, Safemen, Mitchell (MST3000), Molin Rouge, Finding Neverland, Young
Adam (that movie was hot and disturbing),
Pulp Fiction, Team America, The Usual Suspects,The Following, and so much
more."

NO
YES
music
 
YES

music:
"The Beatles, The Doors, Hendrix,
Radiohead, Beach Boys, The Kinks,
The Zombies, Devo, Brian Jonestown Massacre,The White Stripes, The
Rolling Stones,The Turtles, The Ramones,
Dick Dale, CLASH, he Police, White Stripes,
Harry Nilsson, Bob Dylan,Sinatra, Wings,
Massive Attack,Portishead, Tricky, Dr. Dre,
DelTRON Zer0, OREINGER, noop, Wutang,
Elton John,David Bowie, Tupac,B52's, Franz,
Outcast,Gorillaz, Janis Joplin, DJ Shadow,
Nina Simone, Dusty Springfield, Astrid Gilberto, Bob Marley, Dead Kennedys, Donovan, Iggy Pop, Simon and Garfunkel, Strawberry Alarm Clock, Halland Oates, MosDef,Pink Floyd, CCR, Beasty B's,Beethoven...etc or is it ect? I never know... "]

NO
YES
name
 
YES
Only available on the REST API when user has set the permission otherwise it shows displayName(nickName) "name":{"msqa110 test"}
NO
YES
familyName
 
YES
Only available on the REST API when user has set the permission.) "famliyName":"test"
NO
YES
name
 
YES
Only available on the REST API when user has set the permission.) "givenName":"msqa110"
NO
YES
networkPresence

AWAY,
CHAT,
DND,
OFFILINE,
ONLINE,
XA

YES
We support only
OFFLINE, ONLINE
networkPresence:{ "value":"offline": key :"offline"}
NO
YES
nickname
 
YES
  "nickName":"msqa100"
YES
YES
pets
 
NO
 
NO
NO
phoneNumbers
 
NO
 
NO
NO
politicalViews
 
NO
 
NO
NO
profileSong
 
YES
  "profileSong":"Trouble
NO
YES
profileUrl
 
YES
  "profileUrl":
"http:\/\/www.myspace.com
\/301847719"

NO
YES
profileVideo
 
NO
 
NO
NO
quotes
 
NO
 
NO
NO
relationshipStatus
 
YES
  "relationshipStatus":"Single"
NO
YES
religion
 
YES
  "religion":"Agnostic"
NO
YES
romance
 
NO
 
NO
NO
scaredOf
 
NO
 
NO
NO
schools
 
NO


NO
NO
sexualOrientation
 
YES
  "sexualOrientation":
"Straight"
NO
YES
smoker
HEAVILY, NO, OCCASIONALLY, QUIT, QUITTING, REGULARLY, SOCIALLY, YES
YES
We support YES,NO "smoker":{"value":"yes":"key":"yes"}
NO
YES
sports
 
NO
 
NO
NO
status
headline?
YES
This is map to headline "status":"When the going gets tough,
the tough get going."
NO
YES
tags
 
NO
 
NO
NO
thumbnailUrl
 
YES
 

"thumbnailUrl":
"http:\/\/a508.ac-images.myspacecdn.com
\/images 01\/92\/s_e7922370b69
175173e71d49964dcba6b.jpg"

YES
YES
timeZone
Difference in
minutes from
GMT.
NO
 
NO
NO
turnOffs
 
NO
 
NO
NO
turnOns
 
NO
 
NO
NO
tvShows
 
YES
 

tvShows:
"PERFECT HAIR FOREVER!!!!!
Aqua Teen Hunger Force,
The Brak Show, Sealab,Space Ghost,
That 70's show,
The Office, SOPRANOS,
Curb Your Enthusiasm,
Simpsons, Family Guy,
GET SMART,
THE CHAPPELL SHOW,
South Park, Weeds,
Bewitched and on top of all of this
GREAT shit, I watch really bad tv
from Korean Soaps, to infomercials.
I watch too much TV.... "

NO
YES
urls
 
YES

added new field

urls:[{"value":"http:\/\/www.myspace.com
\/shakasarah","type":"profileUrl"}]

NO
YES
photos
 
YES

added new field

added new photos":[{"value":
"http:\/\/a229.ac-images.myspacecdn.com\/images01\/118
\/s_3dcfafe8145a40fc46edacfebe7eaa94.jpg","type":"thumnbnail"},
{"value":"http:\/\/a229.acimages.myspacecdn.com\/images01
\/118\/m_3dcfafe8145a40fc46edacfebe7eaa94.jpg","type":
"medium"},{"value":"http:\/\/a229.ac-images.myspacecdn.com
\/images01\/118\/l_3dcfafe8145a40fc46edacfebe7eaa94.jpg","type":"large"}]}]

NO
YES

 

The Person response

The following is an example of the person response:

{
"totalResults":1,
"startIndex":1,
"itemsPerPage":1,
"sorted":false,
"filtered":false
"entry":[
{"id":"myspace.com:26000010",
"nickname":"shaka",
"profileUrl":"http:\/\/www.myspace.com\/shakasarah",
"thumbnailUrl":"http:\/\/a229.ac-
images.myspacecdn.com\/images01\/118\/s_3dcfafe8145a40fc46edacfebe7eaa94.jpg"
}] }

The Friends Resource

In order to get the friends of the member, a GET request can be made to the following URI:

http://api.myspace.com/v2/people/@me/@friends

Paging parameters

The following parameters may be used to page the collection of friends:

  • startIndex={startIndex} : The index into the paged friends collection
  • count={count} : The number of records in the friends collection

The Friends Response

The following is an example of the person’s friends response:

{
"totalResults":3,
"startIndex":1,
"itemsPerPage":6,
"sorted":false,
"filtered":false,
"entry":[
{"id":"myspace.com:26006316","nickname":"test1118",
"thumbnailUrl":"http:\/\/x.myspacecdn.com\/images\/no_pic.gif",
"profileUrl":"http:\/\/www.myspace.com\/26006316",
"hasAppInstalled": true},

{"id":"myspace.com:26006319","nickname":"test1119",
"thumbnailUrl":"http:\/\/x.myspacecdn.com\/images\/no_pic.gif",
"profileUrl":"http:\/\/www.myspace.com\/26006319"},

{"id":"myspace.com:100531","nickname":"Jules","thumbnailUrl":"http:\/\/a57.ac-
images.myspacecdn.com\/images01\/26\/s_599e302d10a635a83a06b140e8b17310.
jpg","profileUrl":"http:\/\/www.myspace.com\/thisbitchiknow"}],
"link":[{
"href":"http:\/\/local-
api.myspace.com\/v2\/people\/26000010\/@friends?format=json&startindex=2&count=3",
"rel":"next"
}]}

NOTE: Please be aware that only the user ids of the friends are returned. The fields parameter will not work with the friends resource as only the identifiers of the friends of the member will be included in the response.

Possible Error Responses

If the request is successfully processed the status code of the response will be 200. However, if there is a problem with the response, the following error responses may be returned:

Unauthorized = 401

BadRequest = 400

NotFound = 404,

MethodNotAllowed = 405.

InternalServerError = 500