VIvimeo
On Demand\Genres

Get a specific On Demand genre

Information about this method appears below.

get/ondemand/genres/{genre_id}

Request

  • Base URL
    https://api.vimeo.com
  • Auth
    OAuth 2
    Authorization code/oauth/authorize, token URL /oauth/access_token
    Client credentialsToken URL /oauth/authorize/client
    Scopescreate, delete, edit, email, interact, private, promo_codes, public, purchase, purchased, stats, upload, video_files
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Path parameters

genre_idstring required
Example:animation

The ID of the genre.

Response

The On Demand genre was returned.

canonicalstring required

The canonical name or URL slug of the genre.

linkstring required

The Vimeo URL for this genre.

namestring required

The descriptive name of the genre.

uristring required

The relative URI of the On Demand genre.

Example response

{
  "canonical": "horror",
  "interactions": {
    "page": {
      "added": true,
      "uri": "/ondemand/genres/horror/pages/12345"
    }
  },
  "link": "http://vimeo.com/ondemand/browse/horror",
  "metadata": {
    "connections": {
      "pages": {
        "uri": "/ondemand/genres/horror/pages"
      }
    }
  },
  "name": "Horror",
  "uri": "/ondemand/genres/horror"
}

Changes

No recorded changes to this operation across all 13 revisions of this API.