Vimeo API: Archive

1 tag

Subscription method changes

To accomodate improvements to our subscriptions system, we have a few changes coming to subscriptions methods in the Advanced API. The first change is that we will be dropping support for the types parameter on vimeo.people.getSubscriptions. It will return all subscription types. A new parameter is going to be introduced to vimeo.videos.getSubscriptions: offset. The value passed should be the...

Dec 15th

1 tag

More Method Deprecations

Effective today, the following Advanced API methods are deprecated: vimeo.groups.getFiles vimeo.groups.events.getMonth vimeo.groups.events.getPast vimeo.groups.events.getUpcoming These methods will no longer work after February 29, 2012. We apologize for any inconvenience this may cause.

Dec 5th

Maintenance

Starting at 10:30 am EST (about an hour from now), all API methods that modify data will be unavailable. You will receive a 105: Service currently unavailable error. Everything should be back up and running by 11:30 am EST. All read methods will remain available during this time. We apologize for the inconvienience.

Nov 18th

NYC BigApps 3.0 Competition

We’re happy to announce our participation in NYC BigApps 3.0. The competition, which offers $50,000 in cash and other prizes, is open to software developers who create the best new apps that utilize NYC Open Data to help NYC residents, visitors, and businesses. If you’d like to participate, check out the rules for the competition. If you’re curious about the other APIs...

Nov 11th

4 notes

2 tags

Method Deprecations

To make way for some internal improvements, we will be deprecating the following methods in the Advanced API: vimeo.videos.getContactsLiked vimeo.videos.getContactsUploaded and the following in the Simple API: user/contacts_videos user/contacts_like activity/happened_to_contacts These methods will no longer work after September 30, 2011. There are no direct replacements for these methods,...

Aug 5th

5 notes

3 tags

Streaming Upload API

We added support for streaming uploads a while ago, but now we’ve finally gotten around to documenting it! We also tried to clarify some things in our POST upload API that were giving people some trouble, so make sure to check that section out too.

Apr 21st

5 notes

1 tag

Player API Updates

We’re happy to announce that we just released a whole bunch of updates for our Player APIs! Here’s a list of what changed: New version of the API! We’ve added a bunch of new methods that you’ve been asking for, and added some extra information to things that were already there. Totally rewritten API Documentation! Our player has changed a lot in the past few months, and...

Mar 25th

20 notes

1 tag

Video Collections

We had to remove collections information from video responses for performance reasons. There is a new method available now to get a list of the collections that a video belongs to: vimeo.videos.getCollections. We apologize for any inconvenience.

Nov 18th

7 notes

2 tags

Activity in the Advanced API

In a few minutes, we’ll be pushing some backend changes to activity methods that will fix a number of bugs. Please let us know in the forums if you find any bugs.

Nov 8th

8 notes

Old Auth in v2

Just a reminder, we’ll be removing the old authentication mechanism from version 2 of the Advanced API later today (as announced). We won’t be deleting any tokens though, so you can still use vimeo.oauth.convertAuthToken to convert your old tokens for awhile.

Sep 15th

7 notes

1 tag

Universal Player and the JavaScript API

Today we announced the availability of our new Universal Player which allows just about any device to view a Vimeo video embedded on any blog. To achieve this, we used the iframe HTML element. While iframes are great for allowing you to host external content on a different site, they also come with a huge set of browser limitations in terms of security. One of these limitations is that a parent...

Aug 17th

9 notes

2 tags

Upload API Enhancements

You can now replace a video using the Upload API! Just pass the video_id of the video you’d like to replace when making your call to vimeo.videos.upload.getTicket and when you upload the file it will replace that video instead of creating a new one.

Aug 13th

7 notes

3 tags

Old Authentication in API v2

We’re going to be removing the old Flickr-style authentication mechanism from version 2 of the Advanced API —at the end of this month, on August 31—. You will need to use OAuth to authenticate with version 2 from then on. We’ve made it really simple to switch over: you can easily convert your auth tokens into OAuth tokens through the API without having to re-authenticate...

Aug 13th

5 notes

Check out our new page on Github! →

We’ll be moving our example API code there in the next few days. We’ll also be putting up some other things that might be helpful for various web-related projects.

Jun 30th

4 notes

New version of Vimeo Desktop Uploader, version... →

Release notes: NEW: Added “add to” tab to automatically add uploads to a Group, Channel, or Album. NEW: Added ability to create Albums from within the Uploader. NEW: Compatibility with AIR 2.0 NEW: Privacy icon to videos in queue marked for uploading as private. NEW: Added an Upload Scheduler to schedule posts up to 23 hours in...

Jun 3rd

1 tag

New Embed Code

We’re going to start testing a new embed code through the OEmbed API today. The new code is a good bit shorter than the old one, will validate properly, and should work in all browsers. We’re adding a new parameter, xhtml, for you to use to specify if you want the code returned as HTML or XHTML; It will default to XHTML if you omit the parameter. Let us know on the forums if you run...

Mar 29th

2 notes

2 tags

oEmbed Thumbnails

Starting next Wednesday (March 17) the oEmbed response will contain the largest thumbnail that fits within the size requested. Previously, the response would always include a 200x150px thumbnail. See this post for the thumbnail sizes that are available.

Mar 11th

3 tags

Mobile versions

vimeo.videos.getInfo now includes a new URL for videos if there is a mobile version available. The type will be “mobile” and it will look something like this: http://www.vimeo.com/m/#/6354402 The Simple API will also return this URL as part of the video response in the “mobile_url” tag. We do not have plans at this time to provide direct links to mobile versions of...

Mar 4th

1 tag

Simple API Paging

In order to prevent abuse of the Simple API, we will no longer offer more than 3 pages (60 videos) through the Simple API. If you request a page higher than 3, you will receive a blank response. You can access all videos using the Advanced API.

Mar 2nd

1 tag

bitcast.vimeo.com

Just a reminder: if you’re loading Moogaloop into your project, you should be loading it from http://vimeo.com/moogaloop.swf not bitcast.vimeo.com or any other address.

Feb 5th

2 notes

5 tags

OAuth Signature Fixes

We’ve discovered a bug in our OAuth signature checking when passing parameters that have characters that should be encoded. We were not encoding those characters before creating the base string. We’ve pushed a fix out for it, but we’ll continue to accept signatures that previously would have validated (that are technically incorrect) for a little while. If you’re using our...

Feb 4th

2 notes

2 tags

Single-file Upload Changes

If you’re only uploading a single file through the API, we just made the process a little simpler: there’s no need to pass an MD5 manifest to vimeo.videos.upload.confim. Just call confirm and the file you uploaded will be automatically recognized. The PHP library has been updated to reflect this change. We’ve also included a few more fixes in the PHP library, so make sure to...

Nov 24th

2 notes

2 tags

Video URLs Bug in Advanced API v2

We’re going to be pushing a fix for a bug that’s been in the PHP and JSON response formats to vimeo.videos.getInfo (and any other method that returns the full video response). When a video belonged to a group, the “url” element was an array of urls, but when a video didn’t belong to a group that element was not an array. We’ll be fixing this so that the...

Oct 22nd

5 notes

3 tags

Convert Auth tokens to OAuth Access Tokens

We just added a new method to the API that allows you to convert your old auth tokens to OAuth Access tokens. When you call this method, the old auth token will be permanently deleted, so don’t call this method until you’re ready to switch. Make sure to keep information on your old tokens just in case something happens. The documentation can be found here:...

Oct 22nd

5 notes

Proper HTTP Status Codes

The Advanced API will start returning proper HTTP status codes for API errors soon, in addition to the normal error response. Please make sure your applications are prepared to handle HTTP codes other than 200.

Oct 20th

7 notes

New OAuth Client Library

Our new PHP client library with OAuth support is now up! It shouldn’t be too difficult to update your application to work with it, just remember you have to store both a token and a token secret now. You can pick it up on the download page.

Oct 15th

1 note

Search API Back Up

The Search API is now working again. We apologize for the inconvenience.

Oct 14th

Search API Down

The search API is currently down because we are performing some maintenance on it. We expect it to be down for a couple hours. We’ll update this post when it’s back up. Update: Search is still down, we apologize for the inconvenience. Update 10/14: The search API is back up.

Oct 6th

OAuth Support

We’ll be releasing preliminary support for OAuth early next week. With this release we’ll be deprecating the old authentication method. We’re moving to OAuth primarily for two reasons: 1) it’s more secure than the old method, and 2) it will help to cut down on abuse of the API. This change will require new tokens. If your application has a lot of authenticated users and it...

Oct 2nd

3 notes

Unicode Support in the Advanced API

Due to a vulnerability that’s been discovered in Flickr’s call signing process (ours operates the same way), unicode support may be broken in the API. We’re currently working on oAuth support which will bring back full support for unicode. We do not have an ETA at this time.

Sep 28th

oEmbed Privacy Changes

We’ve made some changes to the oEmbed API with regards to privacy. If your video isn’t public or password protected, the oEmbed response will now only include the embed code, width, and height.

Sep 1st

Advanced API v2

We’re happy to announce that Advanced API v2 is now live! We encourage you to move off of v1 as soon as possible, but we’ll be supporting it through at least November 13, at which point we will be turning off Upload API v1. For a list of the major changes, see the changelog. For more details, see the Advanced API Documentation.

Aug 12th

1 note

Moogaloop Flash Embedding

We just updated our sample code for embedding Moogaloop into Flash. There are a couple of catches though: You have to use AS3 You can only embed one player at a time Fullscreen is disabled More details and the full source-code can be found on the documentation page.

Aug 4th

Moogaloop Javascript API

We’ve changed the Moogaloop JS API to remove some Flash keyword conflicts that were showing up in IE. All of the function names are now prepended with “api_”. Take a look at the updated documentation for more details.

Aug 4th

Advanced API v2

Version 2 of the Advanced API is finally nearing completion. We expect to make it public within the next week. Here are some of the highlights of the update: Album, channel, and group methods Set embed options for Plus users Brand new, more reliable Upload API with support for segmented uploads Improved documentation Most of the changes won’t break your apps, but there are a couple that...

Jul 20th

2 notes

vimeo.videos.getListByTag

We are no longer accepting the “user_id” parameter on this method. vimeo.videos.search should be a suitable replacement for this method. Just set the “user_id” parameter and use the “query” parameter for the tag.

Jul 20th

Moogaloop Javascript API Launched!

We just launched the Moogaloop Javascript API! Check out the documentation.

Jul 14th

Portrait and Thumbnail Images Changing

Sorry for the short notice, but portrait and thumbnail images will be changing by tomorrow (July 14) instead of July 16. Here are the new sizes: Portraits: 30px square (small) 75px square (medium) 100px square (large) 300px square (huge) Thumbnails: 100x75 (small) 200x150 (medium) 640px width (large) 1280px width (HD only, will be available in the future)

Jul 13th

21 notes

oEmbed Update

The oEmbed API is now accepting the height and maxheight parameters. We also fixed a bug that caused the height to not be returned. http://www.vimeo.com/api/docs/oembed

Jul 9th

3 tags

Portrait Image Updates

Sorry to change this around again, but we’re adding 75px portraits back to the API. The sizes will now be: 30px square (small) 75px square (medium) 100px square (large) 300px square (huge) This applies to Simple API v2 now, and will change, as scheduled, for the Advanced API on July 16.

Jul 8th

4 tags

Portrait and Thumbnail Image Changes

We’re going to be changing the sizes of portraits and thumbnails that are returned through the API (both Simple and Advanced). Available portrait sizes will now be: 30px square (small) 100px square (medium) 300px square (large) Available thumbnail sizes will now be: 100x75 (small) 200x150 (medium) 640px width (large) 1280px width (HD only, will be available in the future) We’ll continue...

Jul 7th

1 note

1 tag

Simple API v2 Now Available

Simple API v2 is now available. The documentation and examples have been updated to use the new version.

Jul 7th

1 tag

Simple API v2

In the next day or so we’ll be releasing an update for the Simple API. It’s mostly a backend update, but there are a couple things changing: Anything that referenced “clips” is now “videos” “caption” is now “description” “user_thumbnail_x” is now “user_portrait_x” “subject_user_x” is now “subject_x” in the activity feed Thumbnail and portrait sizes are changing (more...

Jul 7th