Vimeo API

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 subscription_id from the last video on the previous page (a new field added to the response). Although not required, passing the offset will ensure that there is no overlap or missing videos between pages. As part of these changes, we will also be removing the sort ability for vimeo.videos.getSubscriptions. Results will always be returned with the newest subscription video first.

These changes will take effect in one month, on January 16, 2012, but you should start passing offset as soon as possible.

If you have any questions about these changes, please let us know in the API Forum.

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.

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.

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 participating in the competition, check out the list here.

Have fun and make something cool with our API! (and let us know if you do)

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, but we encourage you to use the subscription methods instead (vimeo.videos.getSubscriptions in the Advanced API or user/subscriptions in the Simple API).

We apologize for any inconvenience this may cause.

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.

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:

1. 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.

2. Totally rewritten API Documentation! Our player has changed a lot in the past few months, and unfortunately our documentation had not. This time, we wrote the documentation as we were retooling the API, so it should be completely accurate.

3. New version of Froogaloop! Froogaloop has been updated to be compatible with the new version of the API. We also changed the way it works (a lot like jQuery) to make it a lot easier to use. The example page has also been improved a lot (thanks to Joe!) and now includes every API method.

Be sure to check out the updated documentation and our new API Playground page. As always, let us know if you run into any trouble, have any ideas to improve the API further, or notice anything inaccurate in the documentation.

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.

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.

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.