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 “url” element will always be an array.

Please have your applications ready to handle this change by next Thursday, October 29th.

Please also take the time to switch from using “caption” to “description” as we will be removing “caption” in the near future to make things more consistent.

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: http://www.vimeo.com/api/docs/methods/vimeo.oauth.convertAuthToken

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.

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.

Search API Back Up

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

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.

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 would be hard for you to reauthenticate all of them, send an email to brad@vimeo.com and we’ll see if we can work something out to migrate your old tokens to new ones.

We’ll be releasing a new version of the PHP client to go along with this change. You’ll need to change some of your code to support having secrets for access tokens.

We’re also working on supporting SSL for API calls (and the ability to get an OAuth access token with a username and password!). We’ll let you know when we get it up and running.

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.

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.

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.