Saturday, July 17, 2010

myVidster API (Beta)

Here is a how to guide for using our API. The API is in beta and we need your feedback to make it better. Only a few functions are available but more will be added soon (requests will be given higher priority).

myVidster account, if you do not have one please register here.

Insert function
This function will bookmark videos to your collection.

Syntax: encrypted password&channel_id=channel id&url=encoded url to video

: Your email you register with myVidster.
password: Sha1 encrypted password use a hash generator to encrypt your password.
url: Encoded url of webpage containing the video use a url encoder to encode the url.
channel_id: This is the ID of the channel that the video will be save to. Go to your video collections homepage and click on the channel link (typically it’s call Favorites). For example the ID for this channel is 13512.
access (optional): By default all videos are given public access. To set to private use 1 and if the video contain adult content set to 2. Note if you are require to flag videos with adult content.
embed (optional): If myVidster is having issues fetching the embed then provide the embed code (url encoded).
count (optional): If multiple videos are found on the source page, then it is recommended to specific which video you want to bookmark. Videos are fetched from bottom to top and by default myVidster will fetch the last video on the page (default:0). If you set the count to 1 it will skip the last video and fetch the next one.
Return values (in XML format):
video_id: Video identifier can be use with the fetch function.
title: Title of the video.
description: Description of the video.
thumbnail_url#: myVidster attempts to fetch a video thumbnail from the video host, if it cannot find one then one will be generate. Use the fetch function to get myVidster's generated thumbnails (recommended).
status: Will have the word Success or an error message.

Fetch Function
This function will retrieve information of a bookmarked video.

Syntax encrypted password&video_id=video
email: Your email you register with myVidster.
password: Sha1 encrypted password use a hash generator to encrypt your password.
video_id: : This is the ID of the video. You can get the video ID when executing the insert function or in the video url. For example the ID for this video the ID is 253050.
Return values (in XML format):
video_id: Video identifier.
title: Title of the video.
description: Description of the video.
thumb_status: Will display either a Completed or Pending message.
thumbnail_url#: Video thumbnails for the video. Wait for the Completed message to appear in the thumb_status. If not you will retrieve a temp thumbnail image.


Ademar said...

Hi Marques,

Is there any way we can get a list of the following for a specific account:

- videos
- collection

We have plans of using your api for video curation.

cprogrammer919 said...

Is this still active...

my curl debug shows 200...but I am not seeing any videos added..

Marques Gunter said...

Yes, the API is still active. Provide me with the API url you are using to add videos.

Don Cojon said...

i have the same problem like cprogrammer919 i get the xml response but if i look in to my account there is no video added, im using this url:

http:[email protected]&password=6151ac1a07b869229bc76f37e6fe9920f02ab9eb&channel_id=557169&url=

Marques Gunter said...

Don, you need to add action=insert to your url.

Anonymous said...

I think there is a bug. I'm inserting into my channel using the api and it doesn't work when I provide a thumnail. I have thumnail= and it get a response in XML saying: "Failed to create thumbnail, thumbnail: reason:"

Anonymous said...

That was a typo in my comment. my code has the correct spelling of thumbnail.

Anonymous said...

@Anonymous (February 21, 2014 at 2:33 PM)

You have to use:



Anonymous said...

You should include a way to set the video as straight or gay. All of my videos are being shared to an account with straight preferences, yet the videos are being labeled as gay.

Please advise?

redd19871920 said...

Horny and sexy boy

Barbie Chiu said...

I understand that every person has the passion in any aspects or things. If you love something and it came in front of you it completes your day and your mood turns into something you won't expected. I love your work and I want to read more about it. Visit my site if you have time . Thank you.

Silvia Jacinto said...

Be proud of what you have and be sports in whatever you do.Thanks for sharing your article and keep on posting.Visit my site if you have time.