Home
"It's your data, we're just giving it a good home."
Use the StageBloc API to develop custom, standalone integrations with StageBloc.
Under Development
The API (and therefore these docs) is still currently under development. That means there will be changes made, so if you're planning on using the API, check back here for updates and changes frequently. We also blog about updates on the StageBloc Developers site.
Fork us on GitHub!
All of StageBloc's documentation are up on GitHub for you to fork, modify, and improve. Join us over there to request features, add suggestions, and report bugs. What are you waiting for? Git to it!
General Information
The root URL of the API is https://api.stagebloc.com/2.0/.
All /edit endpoints take POST parameters (as well as /oauth2/token) and all /list endpoints take GET parameters.
All dates returned are in GMT / UTC (+0000).
Responses can be formatted in either JSON, JSONP, or XML by simply changing the extension of the endpoint between .json, .jsonp, or .xml. For instance, to list an account's blog entries, one could use either /list.xml or /list.json. This applies to all endpoints except /oauth2/token since it only returns JSON. Any request that specifies JSONP as the format must include a GET parameter named callback to handle the callback function.
Authorization
Connecting with the StageBloc API uses the OAuth 2.0 standard. You must first create a StageBloc account and then register your application in the StageBloc backend to receive a client ID and secret that will allow users to connect with your application.
Once you've gotten that far, check out the oauth2/token endpoint or look towards the bottom of this page to find a wrapper / framework in your language.
Errors
Errors can be returned for any of the /edit endpoints and differ in content based on the endpoint you're using. However, they will have the following structure:
JSON Example
{
"response": [{
"error": {
"message": "Description of error."
}
}]
}
XML Example
<response>
<error>
<message>Description of error.</message>
</error>
</response>
Wrappers
There is currently a PHP wrapper available for connecting with the API. It can be found on GitHub. Instructions for how to use it are included in the README file of that repository.
An Objective-C framework also exists for easy use with the StageBloc API in your iPhone, iPad, or Mac applications. Instructions on how to get setup with that can be found it its corresponding README file as well. There's also a demo project showcasing the abilities of that framework.
If you want to create your own wrapper in another language, please do! Let us know, and we can link to it from here.
/accounts
This endpoint is used for interacting with the accounts the authenticated user has admin access to.
/accounts/list
Lists the accounts the currently authenticated user has admin access to. No parameters are required for this endpoint.
Explanation of Returned Data
- total
- the total amount of accounts this user has admin access to
- stagebloc_url
- the URL for the account (i.e.
stagebloc.com/<stagebloc_url>/) - authenticated
- whether or not this account is the one currently authenciated with the OAuth access token
- images
- the image for the account
Example Response (XML)
<response>
<total>4</total>
<items>
<item>
<id>2</id>
<name>Team Edward</name>
<stagebloc_url>teamedward</stagebloc_url>
<authenticated>true</authenticated>
<description>We are much better than Team Jacob!</description>
<images>
<image>
<size>thumbnail</size>
<short_url>http://stgb.lc/p/Qf/t</short_url>
<embed_url>http://cdn.stagebloc.com/production/photos/2/thumbnail/20120807_202919_2_2798.jpeg</embed_url>
</image>
<image>
<size>small</size>
<short_url>http://stgb.lc/p/Qf/s</short_url>
<embed_url>http://cdn.stagebloc.com/production/photos/2/small/20120807_202919_2_2798.jpeg</embed_url>
</image>
<image>
<size>medium</size>
<short_url>http://stgb.lc/p/Qf/m</short_url>
<embed_url>http://cdn.stagebloc.com/production/photos/2/medium/20120807_202919_2_2798.jpeg</embed_url>
</image>
<image>
<size>large</size>
<short_url>http://stgb.lc/p/Qf/l</short_url>
<embed_url>http://cdn.stagebloc.com/production/photos/2/large/20120807_202919_2_2798.jpeg</embed_url>
</image>
<image>
<size>original</size>
<short_url>http://stgb.lc/p/Qf/o</short_url>
<embed_url>http://cdn.stagebloc.com/production/photos/2/original/20120807_202919_2_2798.jpeg</embed_url>
</image>
</images>
</item>
<items>
</response>
Example Response (JSON)
{
"response": {
"total": 4,
"items": [{
"item": {
"id": 2,
"name": "Team Edward",
"stagebloc_url": "teamedward",
"authenticated": true,
"description": "We are much better than Team Jacob!",
"images": [{
"image": {
"size": "thumbnail",
"short_url": "http:\/\/stgb.lc\/p\/Qf\/t",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/2\/thumbnail\/20120807_202919_2_2798.jpeg"
}
}, {
"image": {
"size": "small",
"short_url": "http:\/\/stgb.lc\/p\/Qf\/s",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/2\/small\/20120807_202919_2_2798.jpeg"
}
}, {
"image": {
"size": "medium",
"short_url": "http:\/\/stgb.lc\/p\/Qf\/m",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/2\/medium\/20120807_202919_2_2798.jpeg"
}
}, {
"image": {
"size": "large",
"short_url": "http:\/\/stgb.lc\/p\/Qf\/l",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/2\/large\/20120807_202919_2_2798.jpeg"
}
}, {
"image": {
"size": "original",
"short_url": "http:\/\/stgb.lc\/p\/Qf\/o",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/2\/original\/20120807_202919_2_2798.jpeg"
}
}]
}
}]
}
}
/accounts/social/list
Lists the social profiles the currently authenticated user and account has connected to StageBloc. No parameters are required for this endpoint. Useful with the /statuses/edit endpoint for posting to a user's connected social profiles.
Explanation of Returned Data
- total
- the total amount of social accounts this user has access to
- type
- whether or not this social profile is connected to the user or the account
- service
- the connected service
Example Response (XML)
<response>
<total>8</total>
<items>
<item>
<id>191</id>
<service>Twitter</service>
<type>account</type>
<display_name>Brand New Account!'s Twitter</display_name>
</item>
<items>
</response>
Example Response (JSON)
{
"response": {
"total": 8,
"items": [{
"item": {
"id": "191",
"service": "Twitter",
"type": "account",
"display_name": "Brand New Account!'s Twitter"
}
}]
}
}
/audio
These endpoints are used for interacting with an account's audio.
/audio/edit
This endpoint can be used for editing existing audio tracks or adding new audio tracks to a StageBloc account. When adding audio, a WAV or AIFF file is required that is then encoded into two different MP3 files (128kb and 320kb). Upon successful editing/creation, the audio track data will be returned in the same manner /audio/list would return it. Otherwise, an error message will be returned explaining what was wrong.
- id (required to edit an existing audio track)
-
the ID of the audio to edit
possible values are any audio ID that belongs to the authenticated account
- title (required)
-
the title of the audio
possible values are any string <= 100 characters
- audio_data (required when adding a new audio track (i.e. no
idis given)) -
the file to upload and stream
possible values are any
WAVorAIFFfile <200MBin size - artist
-
the artist of this track
possible values are any string <= 250 characters
defaults to empty
- audio_playlist_id
-
a comma seperated list of IDs that this playlist should belong to
possible values are any CSV string that contains IDs of playlists that the authenticated account has access to
defaults to a "Mobile Uploads" playlist for new audio tracks or existing playlists when editing audio tracks
- description
-
a description for the audio track
possible values are any block of text (can contain HTML)
defaults to empty
- private
-
whether or not this audio track should be private
possible values are
1(private) or0(public)defaults to
0 - exclusive
-
whether or not this audio track should be marked as exclusive
possible values are
1(exclusive) or0(not exclusive)defaults to
0 - free_download_quality
-
the quality of the free download to offer for this audio track
possible values are
0(not downloadable),1(128kb MP3),2(320kb MP3),3(source WAV / AIFF file)defaults to
0 - paid_download_quality
-
the quality of the paid download to offer for this audio track, only applicable if this track has been uploaded to StageBloc
possible values are
0(not downloadable),1(128kb MP3),2(320kb MP3),3(source WAV / AIFF file)defaults to
0 - free_download_require_follow
-
whether or not a free download should require a follow, only applicable when
free_download_qualityis not0possible values are
0(not required) and1(required)defaults to
0 - paid_download_require_follow
-
whether or not a paid download should require a follow, only applicable when
paid_download_qualityis not0possible values are
0(not required) and1(required)defaults to
0 - price
-
the price of the audio track (in USD) for purchasing, only applicable when
paid_download_qualityis not0possible values are any number >
0.50defaults to
.5($0.50) - fans_name_price
-
whether or not fans should be able to pay more than
pricewhen purchasing this audio track, only applicable whenpaid_download_qualityis not0possible values are
0(can't name price) or1(can name price)defaults to
1 - tags
-
the tags for the audio
possible values are a comma sepearated string of tags (i.e.
tag1,tag2)defaults to no tags
/audio/list
- id
-
the ID of the audio to return
possible values are any audio ID that belongs to the authenticated account
no default
Important Note: If an id is passed, all other parameters will be ignored and only the requested audio will be returned
- playlist_id
-
the ID of the playlist to receive the audio of
possible values are any audio playlist ID that belongs to the authenticated account
no default
Important Note: If a playlist_id is passed, all other parameters will be ignored and only the audio belonging to that playlist will be returned
- order_by
-
how to order the results
possible values are
created,modified, ortitledefaults to
created - direction
-
what direction to return the results in
possible values are
ASCorDESCdefaults to
DESC - limit
-
the limit of results to return
defaults to
20 - offset
-
the offset of the results to return
possible values are any number > 0
defaults to
0
Explanation of Returned Data
- total
- the total amount of audio tracks for the authenticated account
- length
- the returned length is in seconds
- raw_url
- if the audio wasn't uploader (i.e. was added from SoundCloud, etc), this will be a URL from the service it was added from
Example Response (XML)
<response>
<total>18</total>
<items>
<item>
<id>311</id>
<title>Never Gonna Give You Up</title>
<artist>Rick Astley</artist>
<url>http://stagebloc.com/demo/audio/342</url>
<raw_url/>
<embed_url>http://cdn.stagebloc.com/production/audio/1/mp3_128kb/5190_20120619_175046_1_311.mp3</embed_url>
<short_url>http://stgb.lc/a/6n</short_url>
<description>Audio description here!</description>
<created>2012-06-19 12:50:46</created>
<modified>2012-07-20 16:18:57</modified>
<length>21</length>
<exclusive>true</exclusive>
<private>false</private>
<download_details>
<price>0.50</price>
<fans_name_price>true</fans_name_price>
<free_download_quality>1</free_download_quality>
<paid_download_quality>2</paid_download_quality>
<free_download_require_follow>true</free_download_require_follow>
<paid_download_require_follow>true</paid_download_require_follow>
</download_details>
</item>
</items>
</response>
Example Response (JSON)
{
"response": {
"total": 18,
"items": [{
"item": {
"id": 311,
"title": "Never Gonna Give You Up",
"artist": "Rick Astley",
"url":"http:\/\/stagebloc.com\/demo\/audio\/342",
"raw_url": null,
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/audio\/1\/mp3_128kb\/5190_20120619_175046_1_311.mp3",
"short_url": "http:\/\/stgb.lc\/a\/6n",
"description": "Audio description here!",
"created": "2012-06-19 12:50:46",
"modified": "2012-07-20 16:18:57",
"length": "21",
"exclusive": true,
"private": false,
"download_details": {
"price": 0.50,
"fans_name_price": true,
"free_download_quality": 1,
"paid_download_quality": 2,
"free_download_require_follow": true,
"paid_download_require_follow": true
}
}
}]
}
}
/audio/playlists
This endpoint is used for interacting with an account's audio playlists.
/audio/playlists/edit
This endpoint can be used for editing existing audio playlists or adding a new audio playlist to a StageBloc account. Upon successful editing/creation, the newly created audio playlist will be returned in the same manner /audio/playlist/list would return it. Otherwise, an error message will be returned explaining what was wrong.
- id (required to edit an existing audio playlist)
-
the ID of the audio playlist to edit
possible values are any audio playlist ID that belongs to the authenticated account
- title (required)
-
the title of the audio playlist
possible values are any string <= 100 characters
- description
-
the description of the audio playlist
possible values are any block of text (can contain HTML)
defaults to empty
- audio_ids
-
a comma separated list of IDs that this playlist should contain
possible values are any CSV string of audio IDs that belong to the authenticated account
defaults to none (no audio tracks)
- photo_data
-
an image file to use as the playlist's cover art
possible values are any
JPG,GIF, orPNGfile <10MBin size - private
-
whether or not this audio playlist should be private
possible values are
1(private) or0(public)defaults to
0 - exclusive
-
whether or not this audio playlist should be marked as exclusive
possible values are
1(exclusive) or0(not exclusive)defaults to
0 - free_download_quality
-
the quality of the free download to offer for this audio playlist
possible values are
0(not downloadable),1(128kb MP3),2(320kb MP3),3(source WAV / AIFF file)defaults to
0 - paid_download_quality
-
the quality of the paid download to offer for this audio playlist, only applicable when all tracks in this playlist have been uploaded to StageBloc
possible values are
0(not downloadable),1(128kb MP3),2(320kb MP3),3(source WAV / AIFF file)defaults to
0 - free_download_require_follow
-
whether or not a free download should require a follow, only applicable when
free_download_qualityis not0possible values are
0(not required) and1(required)defaults to
0 - paid_download_require_follow
-
whether or not a paid download should require a follow, only applicable when
paid_download_qualityis not0possible values are
0(not required) and1(required)defaults to
0 - price
-
the price of the audio playlist (in USD) for purchasing, only applicable when
paid_download_qualityis not0possible values are any number >
0.50defaults to
.5($0.50) - fans_name_price
-
whether or not fans should be able to pay more than
pricewhen purchasing this audio playlist, only applicable whenpaid_download_qualityis not0possible values are
0(can't name price) or1(can name price)defaults to
1
/audio/playlists/list
- id
-
the ID of the audio playlist to return
possible values are any audio playlist ID that belongs to the authenticated account
no default
Important Note: If an id is passed, all other parameters will be ignored and only the requested audio playlist will be returned
- order_by
-
how to order the results
possible values are
created,modified, ortitledefaults to
created - direction
-
what direction to return the results in
possible values are
ASCorDESCdefaults to
DESC - limit
-
the limit of results to return
defaults to
20 - offset
-
the offset of the results to return
possible values are any number > 0
defaults to
0 - include_tracks
-
whether or not the audio tracks in this playlist should also be returned
possible values are
0(don't include tracks) and1(include tracks)defaults to
0
Explanation of Returned Data
- total
- the total amount of audio playlists for the authenticated account
- images
- the album art for this audio playlist (if one exists)
- track_count
- the amount of audio tracks currently in this playlist
Example Response (XML)
<response>
<total>4</total>
<items>
<item>
<id>40</id>
<title>Animal Sounds</title>
<description>Nature at its finest!</description>
<created>2012-04-16 11:30:19</created>
<modified>2012-06-04 18:12:11</modified>
<url>http://stagebloc.com/demo/audio/playlists/42</url>
<short_url>http://stgb.lc/ap/G</short_url>
<exclusive>true</exclusive>
<private>false</private>
<download_details>
<price>1.60</price>
<fans_name_price>false</fans_name_price>
<free_download_quality>0</free_download_quality>
<paid_download_quality>2</paid_download_quality>
<free_download_require_follow>false</free_download_require_follow>
<paid_download_require_follow>true</paid_download_require_follow>
</download_details>
<images>
<image>
<size>thumbnail</size>
<short_url>http://stgb.lc/p/PZ/t</short_url>
<embed_url>http://cdn.stagebloc.com/production/photos/1/thumbnail/20120717_144734_1_2783.jpeg</embed_url>
</image>
<image>
<size>small</size>
<short_url>http://stgb.lc/p/PZ/s</short_url>
<embed_url>http://cdn.stagebloc.com/production/photos/1/small/20120717_144734_1_2783.jpeg</embed_url>
</image>
<image>
<size>medium</size>
<short_url>http://stgb.lc/p/PZ/m</short_url>
<embed_url>http://cdn.stagebloc.com/production/photos/1/medium/20120717_144734_1_2783.jpeg</embed_url>
</image>
<image>
<size>large</size>
<short_url>http://stgb.lc/p/PZ/l</short_url>
<embed_url>http://cdn.stagebloc.com/production/photos/1/large/20120717_144734_1_2783.jpeg</embed_url>
</image>
<image>
<size>original</size>
<short_url>http://stgb.lc/p/PZ/o</short_url>
<embed_url>http://cdn.stagebloc.com/production/photos/1/original/20120717_144734_1_2783.jpeg</embed_url>
</image>
</images>
<track_count>6</track_count>
</item>
</items>
</response>
Example Response (JSON)
{
"response": {
"total": 4,
"items": [{
"item": {
"id": 40,
"title": "Animal Sounds",
"description": "Nature at its finest!",
"created": "2012-04-16 11:30:19",
"modified": "2012-06-04 18:12:11",
"url":"http:\/\/stagebloc.com\/demo\/audio\/playlists\/42",
"short_url": "http:\/\/stgb.lc\/ap\/G",
"exclusive": true,
"private": false,
"download_details": {
"price": 1.60,
"fans_name_price": false,
"free_download_quality": 0,
"paid_download_quality": 2,
"free_download_require_follow": false,
"paid_download_require_follow": true
},
"images": [{
"image": {
"size": "thumbnail",
"short_url": "http:\/\/stgb.lc\/p\/PZ\/t",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/thumbnail\/20120717_144734_1_2783.jpeg"
}
}, {
"image": {
"size": "small",
"short_url": "http:\/\/stgb.lc\/p\/PZ\/s",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/small\/20120717_144734_1_2783.jpeg"
}
}, {
"image": {
"size": "medium",
"short_url": "http:\/\/stgb.lc\/p\/PZ\/m",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/medium\/20120717_144734_1_2783.jpeg"
}
}, {
"image": {
"size": "large",
"short_url": "http:\/\/stgb.lc\/p\/PZ\/l",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/large\/20120717_144734_1_2783.jpeg"
}
}, {
"image": {
"size": "original",
"short_url": "http:\/\/stgb.lc\/p\/PZ\/o",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/original\/20120717_144734_1_2783.jpeg"
}
}],
"track_count": 6
}
}]
}
}
/blog
This endpoint is used for interacting with an account's blog posts
/blog/edit
This endpoint can be used for editing existing blog posts or adding new blog posts to a StageBloc account. Upon successful editing/creation, the blog post data will be returned in the same manner /blog/list would return it. Otherwise, an error message will be returned explaining what was wrong.
- id (required to edit an existing blog post)
-
the ID of the blog post to edit
possible values are any blog post ID that belongs to the authenticated account
- title (required)
-
the title of the blog post
possible values are any string <= 100 characters
- body (required)
-
the body of the blog post
possible values are any block of text (can contain HTML)
- published
-
the published time of the post, setting it to a date in the future will cause it to be published at that date (assuming
statusis1)possible values are a formatted timestamp of the form
"Y-m-d H:i:s O"(capital o, not zero) (see PHP's date() function formatters)defaults to a UTC date of the current time in timezone America/Chicago (UTC/GMT -5)
- author_id
-
the ID of the user who should be set as the author of the post
possible values are any ID of an admin for the currently authenticated account
defaults to the authenticated user's ID
- status
-
whether or not this blog post should be published
possible values are
1(published) or0(draft)defaults to
1 - sticky
-
whether or not this blog post should be sticky
possible values are
1(sticky) or0(not sticky)defaults to
0 - exclusive
-
whether or not this photo should be marked as exclusive
possible values are
1(exclusive) or0(not exclusive)defaults to
0
/blog/list
- id
-
the ID of the blog entry to return
possible values are any blog entry ID that belongs to the authenticated account
no default
Important Note: If an id is passed, all other parameters will be ignored and only the requested blog entry will be returned
- order_by
-
how to order the results
possible values are
published,created,modified, ortitledefaults to
published - direction
-
what direction to return the results in
possible values are
ASCorDESCdefaults to
DESC - limit
-
the limit of results to return
defaults to
20 - offset
-
the offset of the results to return
possible values are any number > 0
defaults to
0 - status
-
comma seperated list of the status of blog entries to return
possible values are
0(draft),1(published), or0,1(both)defaults to
1 - year
-
the year to limit the published dates of the entries to
no default
- month
-
the month to limit the published dates of the entries to
no default
- ignore_sticky
-
whether or not to ignore sticky posts (i.e. posts that will be returned first regardless of the
order_byanddirectionparameters)possible values are
1(true) or0(false)defaults to
0
Explanation of Returned Data
- total
- the total amount of blog entries for the authenticated account
- status
- a value of
1means published and a value of0means draft
Example Response (XML)
<response>
<total>486</total>
<items>
<item>
<id>6317</id>
<title>50 Shades of Grey</title>
<body>Lions, tables, and chairs, oh my!</body>
<status>1</status>
<url>http://stagebloc.com/demo/blog/6319</url>
<short_url>http://stgb.lc/b/2SV</short_url>
<published>2012-06-25 12:30:00</published>
<created>2012-06-25 12:30:53</created>
<modified>2012-07-17 15:33:11</modified>
<sticky>false</sticky>
<exclusive>true</exclusive>
<author>
<id>8</id>
<name>Demo Admin</name>
</author>
</item>
</items>
</response>
Example Response (JSON)
{
"response": {
"total": 486,
"items": [{
"item": {
"id": 6317,
"title": "50 Shades of Grey",
"body": "Lions, tables, and chairs, oh my!",
"status": 1,
"url":"http:\/\/stagebloc.com\/demo\/blog\/6319",
"short_url": "http:\/\/stgb.lc\/b\/2SV",
"published": "2012-06-25 12:30:00",
"created": "2012-06-25 12:30:53",
"modified": "2012-07-17 15:33:11",
"sticky": false,
"exclusive": true,
"author": {
"id": 8,
"name": "Demo Admin"
}
}
}]
}
}
/events
This endpoint is used for interacting with an account's events.
/events/list
- id
-
the ID of the event to return
possible values are any event ID that belongs to the authenticated account
no default
Important Note: If an id is passed, all other parameters will be ignored and only the requested event will be returned
- order_by
-
how to order the results
possible values are
created,modified, orstartDateTimedefaults to
startDateTime - direction
-
what direction to return the results in
possible values are
ASCorDESCdefaults to
ASC - limit
-
the limit of results to return
defaults to
20 - offset
-
the offset of the results to return
possible values are any number > 0
defaults to
0 - include_past
-
whether or not to include events that have already occurred
possible values are
1(include past events) or0(don't include past events)defaults to
0 - include_upcoming
-
whether or not to include events that have not yet occurred
possible values are
1(include upcoming events) or0(don't include upcoming events)defaults to
1
Explanation of Returned Data
- total
- the total amount of events for the authenticated account
- buy_link
- a link to an external service where tickets can be purchased
- image
- the image used as the main image for the event
- collaborators
- a list of people also involved in this event
Examples Response (XML)
<response>
<total>3</total>
<items>
<item>
<id>115</id>
<title>End of The World</title>
<minimum_age>21</minimum_age>
<buy_link>http://www.eventbrite.com/event/3906955810/es2?rank=1</buy_link>
<created>2012-01-04 08:19:53</created>
<modified>2012-08-10 08:47:24</modified>
<start_date>2013-01-04 13:00:00</start_date>
<end_date>2013-01-04 16:00:00</end_date>
<description>It's the end of the world as we know it...</description>
<price>1.50</price>
<currency>USD</currency>
<url>http://stagebloc.com/demo/events/115</url>
<short_url>http://stgb.lc/e/2Z</short_url>
<images>
<image>
<size>thumbnail</size>
<short_url>http://stgb.lc/p/Qg/t</short_url>
<embed_url>http://cdn.stagebloc.com/production/photos/1/thumbnail/20120810_134720_1_2799.jpeg</embed_url>
</image>
<image>
<size>small</size>
<short_url>http://stgb.lc/p/Qg/s</short_url>
<embed_url>http://cdn.stagebloc.com/production/photos/1/small/20120810_134720_1_2799.jpeg</embed_url>
</image>
<image>
<size>medium</size>
<short_url>http://stgb.lc/p/Qg/m</short_url>
<embed_url>http://cdn.stagebloc.com/production/photos/1/medium/20120810_134720_1_2799.jpeg</embed_url>
</image>
<image>
<size>large</size>
<short_url>http://stgb.lc/p/Qg/l</short_url>
<embed_url>http://cdn.stagebloc.com/production/photos/1/large/20120810_134720_1_2799.jpeg</embed_url>
</image>
<image>
<size>original</size>
<short_url>http://stgb.lc/p/Qg/o</short_url>
<embed_url>http://cdn.stagebloc.com/production/photos/1/original/20120810_134720_1_2799.jpeg</embed_url>
</image>
</images>
<location>
<id>14</id>
<global_id>17</global_id>
<name>Best Place On Earth</name>
<website></website>
<address>
<street_address>12345 Awesome Street</street_address>
<city>Big Bend</city>
<state_province>WI</state_province>
<postal_code>53103</postal_code>
<country>USA</country>
</address>
</location>
<collaborators>
<collaborator>
<id>16</id>
<name>Dirt Nasty</name>
<website>http://dirtnastymusic.com/</website>
</collaborator>
</collaborators>
</item>
</items>
</response>
Examples Response (JSON)
{
"response": {
"total": 3,
"items": [{
"item": {
"id": 115,
"title": "End of The World",
"minimum_age": 21,
"buy_link": "http:\/\/www.eventbrite.com\/event\/3906955810\/es2?rank=1",
"created": "2012-01-04 08:19:53",
"modified": "2012-08-10 08:57:38",
"start_date": "2013-01-04 13:00:00",
"end_date": "2013-01-04 16:00:00",
"description": "It's the end of the world we know it...",
"price": "1.50",
"currency": "USD",
"url":"http:\/\/stagebloc.com\/demo\/events\/115",
"short_url": "http:\/\/stgb.lc\/e\/2Z",
"images": [{
"image": {
"size": "thumbnail",
"short_url": "http:\/\/stgb.lc\/p\/Qg\/t",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/thumbnail\/20120810_134720_1_2799.jpeg"
}
}, {
"image": {
"size": "small",
"short_url": "http:\/\/stgb.lc\/p\/Qg\/s",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/small\/20120810_134720_1_2799.jpeg"
}
}, {
"image": {
"size": "medium",
"short_url": "http:\/\/stgb.lc\/p\/Qg\/m",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/medium\/20120810_134720_1_2799.jpeg"
}
}, {
"image": {
"size": "large",
"short_url": "http:\/\/stgb.lc\/p\/Qg\/l",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/large\/20120810_134720_1_2799.jpeg"
}
}, {
"image": {
"size": "original",
"short_url": "http:\/\/stgb.lc\/p\/Qg\/o",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/original\/20120810_134720_1_2799.jpeg"
}
}],
"location": {
"id": 14,
"global_id": 17,
"name": "Best Place On Earth",
"website": "",
"address": {
"street_address": "12345 Awesome Street",
"city": "Big Bend",
"state_province": "WI",
"postal_code": "53103",
"country": "USA"
}
},
"collaborators": [{
"collaborator": {
"id": 16,
"name": "Dirt Nasty",
"website": "http:\/\/dirtnastymusic.com\/"
}
}]
}
}]
}
}
/photos
These endpoints are used for interacting with an account's photos.
/photos/edit
This endpoint can be used for editing existing photos or adding new photos to a StageBloc account. When adding a photo, a JPG, GIF, or PNG file is required that is less than 10MB in size. Upon successful editing/creation, the photo data will be returned in the same manner /photos/list would return it. Otherwise, an error message will be returned explaining what was wrong.
- id (required to edit an existing photo)
-
the ID of the photo to edit
possible values are any photo ID that belongs to the authenticated account
- title (required)
-
the title of the photo
possible values are any string <= 200 characters
- photo_data (required when adding a new photo (i.e. no
idis given)) -
the file to upload
possible values are any
JPG,GIF, orPNGfile <10MBin size - album_id
-
the ID of the photo album to add this photo to
possible values are any photo album ID that belongs to the authenticated account
defaults to none
- album_type
-
an ID representing which type of album to upload this photo to, only applicable if
album_idisn't given, setting it to5will change the account's profile imagepossible values are
2(mobile uploads),5(account images),4(blog images), or6(event images)defaults to
2 - description
-
the description of the photo
possible values are any block of text (can contain HTML)
default to none
- exclusive
-
whether or not this photo should be marked as exclusive
possible values are
1(exclusive) or0(not exclusive)defaults to
0 - tags
-
the tags for the photo
possible values are a comma sepearated string of tags (i.e.
tag1,tag2)defaults to no tags
/photos/list
- id
-
the ID of the photo to return
possible values are any photo ID that belongs to the authenticated account
no default
Important Note: If an id is passed, all other parameters will be ignored and only the requested photo will be returned
- album_id
-
the ID of the album to receive the photos of
possible values are any album ID that belongs to the authenticated account
no default
Important Note: If a album_id is passed, all other parameters will be ignored and only the photos belonging to that album will be returned
- order_by
-
how to order the results
possible values are
created,modified, ortitledefaults to
created - direction
-
what direction to return the results in
possible values are
ASCorDESCdefaults to
DESC - limit
-
the limit of results to return
defaults to
20 - offset
-
the offset of the results to return
possible values are any number > 0
defaults to
0
Explanation of Returned Data
- total
- the total amount of photos for the authenticated account
Example Response (XML)
<response>
<total>153</total>
<items>
<item>
<id>2797</id>
<title>Surface of Mars</title>
<description>Yay Curiosity!</description>
<exclusive>false</exclusive>
<modified>2012-07-23 21:16:32</modified>
<created>2012-07-23 21:16:29</created>
<url>http://stagebloc.com/demo/photos/2814</url>
<short_url>http://stgb.lc/p/QK</short_url>
<images>
<image>
<size>thumbnail</size>
<short_url>http://stgb.lc/p/Qe/t</short_url>
<embed_url>http://cdn.stagebloc.com/production/photos/1/thumbnail/20120724_021629_1_2797.jpeg</embed_url>
</image>
<image>
<size>small</size>
<short_url>http://stgb.lc/p/Qe/s</short_url>
embed_url>http://cdn.stagebloc.com/production/photos/1/small/20120724_021629_1_2797.jpeg</embed_url>
</image>
<image>
<size>medium</size>
<short_url>http://stgb.lc/p/Qe/m</short_url>
embed_url>http://cdn.stagebloc.com/production/photos/1/medium/20120724_021629_1_2797.jpeg</embed_url>
</image>
<image>
<size>large</size>
<short_url>http://stgb.lc/p/Qe/l</short_url>
embed_url>http://cdn.stagebloc.com/production/photos/1/large/20120724_021629_1_2797.jpeg</embed_url>
</image>
<image>
<size>original</size>
<short_url>http://stgb.lc/p/Qe/o</short_url>
embed_url>http://cdn.stagebloc.com/production/photos/1/original/20120724_021629_1_2797.jpeg</embed_url>
</image>
</images>
<location>
<id>5</id>
<name>Allen Hall</name>
<website>http://illinois.edu</website>
<address>
<street_address>1005 West Gregory Avenue</street_address>
<city>Urbana</city>
<state_province>IL</state_province>
<postal_code>61801</postal_code>
<country>USA</country>
</address>
</location>
</item>
</items>
</response>
Example Response (JSON)
{
"response": {
"total": 153,
"items": [{
"item": {
"id": 2797,
"title": "Surface of Mars",
"description": "Yay Curiosity!",
"exclusive": false,
"modified": "2012-08-09 17:35:23",
"created": "2012-07-23 21:16:29",
"url":"http:\/\/stagebloc.com\/demo\/photos\/2814",
"short_url":"http:\/\/stgb.lc\/p\/QK",
"images": [{
"image": {
"size": "thumbnail",
"short_url": "http:\/\/stgb.lc\/p\/Qe\/t",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/thumbnail\/20120724_021629_1_2797.jpeg"
}
}, {
"image": {
"size": "small",
"short_url": "http:\/\/stgb.lc\/p\/Qe\/s",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/small\/20120724_021629_1_2797.jpeg"
}
}, {
"image": {
"size": "medium",
"short_url": "http:\/\/stgb.lc\/p\/Qe\/m",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/medium\/20120724_021629_1_2797.jpeg"
}
}, {
"image": {
"size": "large",
"short_url": "http:\/\/stgb.lc\/p\/Qe\/l",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/large\/20120724_021629_1_2797.jpeg"
}
}, {
"image": {
"size": "original",
"short_url": "http:\/\/stgb.lc\/p\/Qe\/o",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/original\/20120724_021629_1_2797.jpeg"
}
}],
"location": {
"id": 5,
"name": "Allen Hall",
"website": "http:\/\/illinois.edu",
"address": {
"street_address": "1005 West Gregory Avenue",
"city": "Urbana",
"state_province": "IL",
"postal_code": "61801",
"country": "USA"
}
}
}
}]
}
}
/photos/albums
This endpoint is used for interacting with an account's photo albums.
/photos/albums/list
- id
-
the ID of the photo to return
possible values are any photo album ID that belongs to the authenticated account
no default
Important Note: If an id is passed, all other parameters will be ignored and only the requested photo will be returned
- order_by
-
how to order the results
possible values are
created,modified, ortitledefaults to
created - direction
-
what direction to return the results in
possible values are
ASCorDESCdefaults to
DESC - limit
-
the limit of results to return
defaults to
20 - offset
-
the offset of the results to return
possible values are any number > 0
defaults to
0
Explanation of Returned Data
- total
- the total amount of photo albums for the authenticated account
- images
- the cover image used for the photo album
Example Response (XML)
<response>
<total>14</total>
<items>
<item>
<id>166</id>
<title>Cats</title>
<url>http://stagebloc.com/demo/photos/albums/166</url>
<short_url>http://stgb.lc/pa/3S</short_url>
<photo_count>3</photo_count>
<description>Cats will one day rule the world!</description>
<private>false</private>
<exclusive>false</exclusive>
<modified>2012-08-09 19:12:26</modified>
<created>2011-11-16 13:31:57</created>
<images>
<image>
<size>thumbnail</size>
<short_url>http://stgb.lc/p/zn/t</short_url>
<embed_url>http://cdn.stagebloc.com/production/photos/1/thumbnail/20111116_193157_1_1935.jpeg</embed_url>
</image>
<image>
<size>small</size>
<short_url>http://stgb.lc/p/zn/s</short_url>
<embed_url>http://cdn.stagebloc.com/production/photos/1/small/20111116_193157_1_1935.jpeg</embed_url>
</image>
<image>
<size>medium</size>
<short_url>http://stgb.lc/p/zn/m</short_url>
<embed_url>http://cdn.stagebloc.com/production/photos/1/medium/20111116_193157_1_1935.jpeg</embed_url>
</image>
<image>
<size>large</size>
<short_url>http://stgb.lc/p/zn/l</short_url>
<embed_url>http://cdn.stagebloc.com/production/photos/1/large/20111116_193157_1_1935.jpeg</embed_url>
</image>
<image>
<size>original</size>
<short_url>http://stgb.lc/p/zn/o</short_url>
<embed_url>http://cdn.stagebloc.com/production/photos/1/original/20111116_193157_1_1935.jpeg</embed_url>
</image>
</images>
<location>
<id>7</id>
<name>The Rave</name>
<website>http://therave.com</website>
<address>
<street_address>12345 Street</street_address>
<city>Milwaukee</city>
<state_province>WI</state_province>
<postal_code>53103</postal_code>
<country>USA</country>
</address>
</location>
</item>
</items>
</response>
Example Response (JSON)
{
"response": {
"total": 14,
"items": [{
"item": {
"id": 166,
"title": "Cats",
"url":"http:\/\/stagebloc.com\/demo\/photos\/albums\/166",
"short_url": "http:\/\/stgb.lc\/pa\/3S",
"photo_count": 3,
"description": "Cats will one day rule the world!",
"private": false,
"exclusive": false,
"modified": "2012-08-09 19:12:26",
"created": "2011-11-16 13:31:57",
"images": [{
"image": {
"size": "thumbnail",
"short_url": "http:\/\/stgb.lc\/p\/zn\/t",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/thumbnail\/20111116_193157_1_1935.jpeg"
}
}, {
"image": {
"size": "small",
"short_url": "http:\/\/stgb.lc\/p\/zn\/s",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/small\/20111116_193157_1_1935.jpeg"
}
}, {
"image": {
"size": "medium",
"short_url": "http:\/\/stgb.lc\/p\/zn\/m",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/medium\/20111116_193157_1_1935.jpeg"
}
}, {
"image": {
"size": "large",
"short_url": "http:\/\/stgb.lc\/p\/zn\/l",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/large\/20111116_193157_1_1935.jpeg"
}
}, {
"image": {
"size": "original",
"short_url": "http:\/\/stgb.lc\/p\/zn\/o",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/original\/20111116_193157_1_1935.jpeg"
}
}],
"location": {
"id": 7,
"name": "The Rave",
"website": "http:\/\/therave.com",
"address": {
"street_address": "12345 Street",
"city": "Milwaukee",
"state_province": "WI",
"postal_code": "53103",
"country": "USA"
}
}
}
}]
}
}
/oauth2
This is used during the OAuth2 authentication process to get an access token from a request token for StageBloc Connect. Curious? Check out our OAuth2 PHP or Objective-C wrapper on GitHub to get started.
General Flow
In order to authenticate a user with our application, you must first send them to the stagebloc.com/connect/ page along with a few GET parameters.
https://stagebloc.com/connect/?client_id=<your_client_id>&redirect_uri=<your_redirect_uri>&response_type=code&scope=non-expiring&consumer_key=<your_client_secret>
Once they authorize on that page, they'll be redirected back to your redirect URI with a request token as a GET parameter named code. Using that code, you must submit a POST request to oauth2/token.
/oauth2/token
This endpoint is used to get an access token once a request token is received from the stagebloc.com/connect/ auth flow and the user is redirected back to your application. The only response format for this endpoint is JSON! Do not add an XML extension to this endpoint!
- client_id (required)
-
the ID of the application an account is connecting to
possible values are any string that matches a registered application
- client_secret (required)
-
the secret of the application an account is connecting to
possible values are any string that matches a registered application
- grant_type (required)
-
the grant type being requested
possible value is
authorization_code - code (required)
-
the request token code received after connecting with a registered application via
https://stagebloc.com/connect/possible values are any string received during the authentication / connection process
Example Response (JSON)
{"access_token":"<access_token_here>","scope":"non-expiring"}
/oauth2/token/disconnect
No parameters required. Hitting this endpoint will simply invalidate the OAuth access token, essentially "logging out" the user.
Example Response (JSON)
{"response":{"message":"Token succesfully invalidated."}}
Example Response (XML)
<response>
<message>Token succesfully invalidated.</message>
</response>
/oauth2/token/info
This endpoint will return data about the currently authenticated user and account as well as the application for the given access token.
Example Response (JSON)
{
"response": [{
"items": [{
"item": {
"access_token": "5badcaf789d3d1d09794d8f021f40f0e",
"account": {
"id": 1,
"name": "The Jonas Brothers",
"stagebloc_url": "jobros"
},
"user": {
"id": 8,
"name": "Carly Rae Jepsen"
},
"application": {
"name": "Music Maker",
"description": "Make all your music the bomb diggity!"
}
}
}]
}]
}
Example Response (XML)
<response>
<items>
<item>
<access_token>5badcaf789d3d1d09794d8f021f40f0e</access_token>
<account>
<id>1</id>
<name>The Jonas Brothers</name>
<stagebloc_url>jobros</stagebloc_url>
</account>
<user>
<id>8</id>
<name>Carly Rae Jepsen</name>
</user>
<application>
<name>Music Maker</name>
<description>Make all your music the bomb diggity!</description>
</application>
</item>
</items>
</response>
/oauth2/token/edit
This endpoint will change the currently authenticated account for this access token. The response will be the same as /oauth2/token/info.
- account_id
- the ID of the account to use with this access token
/statuses
This endpoint is used for interacting with an account's statuses.
/statuses/list
- id
-
the ID of the status to return
possible values are any status ID that belongs to the authenticated account
no default
Important Note: If an id is passed, all other parameters will be ignored and only the requested status will be returned
- order_by
-
how to order the results
possible values are
publisheddefaults to
published - direction
-
what direction to return the results in
possible values are
ASCorDESCdefaults to
DESC - limit
-
the limit of results to return
defaults to
20 - offset
-
the offset of the results to return
possible values are any number > 0
defaults to
0
Explanation of Returned Data
- total
- the total amount of statuses for the authenticated account
Example Response (XML)
<response>
<total>29</total>
<items>
<item>
<id>161</id>
<url>http://stagebloc.com/demo/statuses/164</url>
<short_url>http://stgb.lc/s/3Q</short_url>
<text>Sometimes I feel like nobody cares about what I have to say.</text>
<published>2012-08-01 22:23:41</published>
<author>
<id>8</id>
<name>Lone Wolf</name>
</author>
</item>
<item>
<id>154</id>
<text>It's hard to breathe in this thing!</text>
<published>2012-07-16 15:05:26</published>
<author>
<id>8</id>
<name>Lord Dark Helmet</name>
</author>
</item>
</items>
</response>
Example Response (JSON)
{
"response": {
"total": 29,
"items": [{
"item": {
"id": 161,
"url":"http:\/\/stagebloc.com\/demo\/statuses\/164",
"short_url":"http:\/\/stgb.lc\/s\/3Q",
"text": "Sometimes I feel like nobody cares about what I have to say.",
"published": "2012-08-01 22:23:41",
"author": {
"id": 8,
"name": "Lone Wolf"
}
}
}, {
"item": {
"id": 154,
"text": "It's hard to breathe in this thing!",
"published": "2012-07-16 15:05:26",
"author": {
"id": 8,
"name": "Lord Dark Helmet"
}
}
}]
}
}
/statuses/edit
This endpoint can be used for adding statuses to a StageBloc account (note: statuses cannot be edited, only deleted). Upon successful addition, the status data will be returned in the same manner /statuses/list would return it. Otherwise, an error message will be returned explaining what was wrong.
- text (required)
-
the text of the status update
possible values are any string (when sharing to services such as Twitter the text will be truncated to the character limit with a link to the status on StageBloc appended to the end)
- account_id
-
a comma seperated list of additional account IDs to post this status to, don't incude the currently authorized account's ID in this string as it will always post to at least that account
possible values are any IDs that the authenticated user has admin access to, see
/accounts/list - profile_id
-
a comma seperated list of social profile IDs to post this status to
possible values are IDs of social profiles (only Twitter or Facebook) that the authenticated user or account has connected to StageBloc, see
/accounts/social/list
/videos
This endpoint is used for interacting with an account's videos.
/videos/list
- id
-
the ID of the video to return
possible values are any video ID that belongs to the authenticated account
no default
Important Note: If an id is passed, all other parameters will be ignored and only the requested video will be returned
- order_by
-
how to order the results
possible values are
createdandtitledefaults to
created - direction
-
what direction to return the results in
possible values are
ASCorDESCdefaults to
DESC - limit
-
the limit of results to return
defaults to
20 - offset
-
the offset of the results to return
possible values are any number > 0
defaults to
0
Explanation of Returned Data
- total
- the total amount of videos for the authenticated account
- raw_url
- the link to the video on the external service it belongs to
Example Response (XML)
<response>
<total>29</total>
<items>
<item>
<id>663</id>
<title>Not A Rick Roll</title>
<description>I promise you, it's not a rick roll...</description>
<url>http://stagebloc.com/demo/videos/663</url>
<short_url>http://stgb.lc/v/cr</short_url>
<raw_url>http://www.youtube.com/watch?v=oHg5SJYRHA0</raw_url>
<created>2012-06-16 13:47:37</created>
<modified>2012-06-16 14:11:59</modified>
<embed_code><iframe width="460" height="259" src="http://www.youtube.com/embed/oHg5SJYRHA0?fs=1&feature=oembed&wmode=transparent" frameborder="0" allowfullscreen></iframe></embed_code>
<images>
<image>
<size>thumbnail</size>
<embed_url>http://cdn.stagebloc.com/production/photos/1/thumbnail/20120713_153517_1_2779.jpeg</embed_url>
<short_url>http://stgb.lc/p/PV/t</short_url>
</image>
<image>
<size>small</size>
<embed_url>http://cdn.stagebloc.com/production/photos/1/small/20120713_153517_1_2779.jpeg</embed_url>
<short_url>http://stgb.lc/p/PV/s</short_url>
</image>
<image>
<size>medium</size>
<embed_url>http://cdn.stagebloc.com/production/photos/1/medium/20120713_153517_1_2779.jpeg</embed_url>
<short_url>http://stgb.lc/p/PV/m</short_url>
</image>
<image>
<size>large</size>
<embed_url>http://cdn.stagebloc.com/production/photos/1/large/20120713_153517_1_2779.jpeg</embed_url>
<short_url>http://stgb.lc/p/PV/l</short_url>
</image>
<image>
<size>original</size>
<embed_url>http://cdn.stagebloc.com/production/photos/1/original/20120713_153517_1_2779.jpeg</embed_url>
<short_url>http://stgb.lc/p/PV/o</short_url>
</image>
</images>
</item>
</items>
</response>
Example Response (JSON)
{
"response": {
"total": "29",
"items": [{
"item": {
"id": 663,
"title": "Not A Rick Roll",
"description": "I promise you, it's not a rick roll...",
"url": "http:\/\/stagebloc.com\/demo\/videos\/663",
"short_url": "http:\/\/stgb.lc\/v\/cr",
"raw_url": "https:\/\/www.youtube.com\/watch?v=oHg5SJYRHA0",
"created": "2012-06-16 13:47:37",
"modified": "2012-06-16 14:11:59",
"embed_code": "<iframe width=\"460\" height=\"259\" src=\"http:\/\/www.youtube.com\/embed\/oHg5SJYRHA0?fs=1&feature=oembed&wmode=transparent\" frameborder=\"0\" allowfullscreen><\/iframe>",
"images": [{
"image": {
"size": "thumbnail",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/thumbnail\/20120713_153517_1_2779.jpeg",
"short_url": "http:\/\/stgb.lc\/p\/PV\/t"
}
}, {
"image": {
"size": "small",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/small\/20120713_153517_1_2779.jpeg",
"short_url": "http:\/\/stgb.lc\/p\/PV\/s"
}
}, {
"image": {
"size": "medium",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/medium\/20120713_153517_1_2779.jpeg",
"short_url": "http:\/\/stgb.lc\/p\/PV\/m"
}
}, {
"image": {
"size": "large",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/large\/20120713_153517_1_2779.jpeg",
"short_url": "http:\/\/stgb.lc\/p\/PV\/l"
}
}, {
"image": {
"size": "original",
"embed_url": "http:\/\/cdn.stagebloc.com\/production\/photos\/1\/original\/20120713_153517_1_2779.jpeg",
"short_url": "http:\/\/stgb.lc\/p\/PV\/o"
}
}]
}
}]
}
}
/videos/edit
This endpoint can be used for editing existing videos or adding new videos to a StageBloc account. Upon successful editing/creation, the video will be returned in the same manner /videos/list would return it. Otherwise, an error message will be returned explaining what was wrong.
- id (required to edit an existing video)
-
the ID of the video to edit
possible values are any video ID that belongs to the authenticated account
- url (required if
idisn't sent (i.e. adding a new video)) -
the url of the video, sending this will allow oEmbed to fetch a title and embed code automatically for the video
possible values are any valid video URL from the following services: YouTube, Vimeo, Hulu, Flickr, Viddler, Qik, Revision3, Blip, DailyMotion
- title
- the title of the video, if
urlis sent this will be populated by the oEmbed request but can be overriden by passing an explicittitle