vimeovimeo-api

Vimeo URL I've never seen before with two different IDS. How do I get it to work with one?


I have this Vimeo URL.

https://vimeo.com/192207770/0faf1dd09d

I don't understand what the two IDS represent and how I can shorten it into a single ID URL.

All other vimeo URLs I've seen are vimeo.com/<id>

What do these two IDS signify in this order? Where is the unique video ID I can address with vimeo.com/<id>?


Solution

  • That URL is an unlisted video. Unlisted videos are only playable by viewers with the full URL (https://vimeo.com/[video_id]/[unlisted_hash]) and are not returned in Vimeo search results.

    Video privacy settings are outlined here: https://help.vimeo.com/hc/en-us/articles/224817847-Privacy-settings-overview

    In general, an unlisted video will have a uri like this:

    "uri":"/[video_id]:[unlisted_hash]"
    

    However, it's best practice to get that uri from the API, instead of building it yourself. You can get the video's uri and metadata by making this request:

    GET https://api.vimeo.com/videos?links=https://vimeo.com/[video_id]/[unlisted_hash]
    

    Finally, for unlisted videos you must have the unlisted_hash to get its metadata or to view it on vimeo.com. For an unlisted video with the url https://vimeo.com/1234567/abcde, both vimeo.com and the API will return 404 for https://vimeo.com/1234567.

    I hope this information helps!