On Demand\Seasons

Get all the seasons on an On Demand page

Information about this method appears below.

get/ondemand/pages/{ondemand_id}/seasons

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

ondemand_idnumber required
Example:61326

The ID of the On Demand.

Query parameters

direction'asc' | 'desc'
Example:asc

The sort direction of the results.

filter'viewable'

The attribute by which to filter the results.

pagenumber
Example:1

The page number of the results to show.

per_pagenumber
Example:10

The number of items to show on each page of results, up to a maximum of 100.

sort'date' | 'manual'

The way to sort the results.

Response

The seasons were returned.

descriptionstring required

The description for this season.

namestring required

The descriptive name of the season.

positionnumber required

The position of the season relative to other seasons in the series.

resource_keystring required

The unique identifier for this On Demand season.

typestring required

The type of season.

uristring required

The season container's relative URI.

Example response

[
  {
    "description": "Season 1",
    "metadata": {
      "connections": {
        "videos": {
          "total": 13,
          "uri": "/ondemand/pages/61326/season/12345/videos"
        }
      }
    },
    "name": "Season 1",
    "position": 1,
    "resource_key": "bac1033deba2310ebba2caec33c23e4beea67aba",
    "type": "main",
    "uri": "/ondemand/pages/61326/seasons/12345",
    "user": {
      "account": "basic",
      "bio": "This is where you will find videos and news updates from the staff.",
      "created_time": "2007-01-18T16:40:11+00:00",
      "email": "user@example.com",
      "link": "https://vimeo.com/staff",
      "location": "New York City",
      "metadata": {
        "connections": {
          "albums": {
            "total": 3,
            "uri": "/users/152184/albums"
          },
          "appearances": {
            "total": 6,
            "uri": "/users/152184/appearances"
          },
          "block": {
            "total": 73,
            "uri": "/me/block"
          },
          "categories": {
            "total": 5,
            "uri": "/users/152184/categories"
          },
          "channels": {
            "total": 4,
            "uri": "/users/152184/channels"
          },
          "feed": {
            "uri": "/users/152184/feed"
          },
          "folders": {
            "total": 9,
            "uri": "/me/folders"
          },
          "followers": {
            "total": 12,
            "uri": "/users/152184/followers"
          },
          "following": {
            "total": 47,
            "uri": "/users/152184/following"
          },
          "groups": {
            "total": 2,
            "uri": "/users/152184/groups"
          },
          "likes": {
            "total": 300,
            "uri": "/users/152184/likes"
          },
          "moderated_channels": {
            "total": 1,
            "uri": "/users/152184/channels?filter=moderated"
          },
          "pictures": {
            "total": 3,
            "uri": "/users/152184/pictures"
          },
          "portfolios": {
            "total": 5,
            "uri": "/users/152184/portfolios"
          },
          "recommended_channels": {
            "total": 4,
            "uri": "/me/recommendations/channels"
          },
          "recommended_users": {
            "total": 6,
            "uri": "/me/recommendations/users"
          },
          "shared": {
            "total": 15,
            "uri": "/users/152184/shared/videos"
          },
          "videos": {
            "total": 36,
            "uri": "/users/152184/videos"
          },
          "watched_videos": {
            "total": 322,
            "uri": "/me/watched/videos"
          },
          "watchlater": {
            "total": 14,
            "uri": "/users/152184/watchlater"
          }
        },
        "interactions": {
          "add_privacy_user": {
            "uri": "/channels/152184/privacy/users"
          },
          "block": {
            "added": true,
            "added_time": "2017-05-16T15:05:43+00:00",
            "uri": "/me/block/3766357"
          },
          "follow": {
            "added": true,
            "uri": "/users/152184/following/3766357"
          },
          "report": {
            "uri": "/users/152184/report"
          }
        }
      },
      "name": "Vimeo Staff",
      "pictures": {
        "active": true,
        "resource_key": "dc724af18fbdd4e59189f5fe768a5f8311527050",
        "sizes": [
          {
            "height": 720,
            "link": "https://i.vimeocdn.com/video/581495283_1280x720.jpg?r=pad",
            "link_with_play_button": "https://i.vimeocdn.com/filter/overlay?src0=https%3A%2F%2Fi.vimeocdn.com%2Fvideo%2F581495283_1280x720.jpg&src1=http%3A%2F%2Ff.vimeocdn.com%2Fp%2Fimages%2Fcrawler_play.png",
            "width": 1280
          }
        ],
        "type": "caution",
        "uri": "/users/152184/pictures/12345"
      },
      "preferences": {
        "videos": {
          "privacy": {
            "add": true,
            "comments": "anybody",
            "download": true,
            "embed": "private",
            "view": "anybody"
          }
        }
      },
      "resource_key": "bac1033deba2310ebba2caec33c23e4beea67aba",
      "upload_quota": {
        "lifetime": {
          "free": 5000000,
          "max": 5368709120,
          "used": 5368704120
        },
        "periodic": {
          "free": 5000000,
          "max": 5368709120,
          "reset_date": "2029-03-13T02:35:13-04:00",
          "used": 5368704120
        },
        "space": {
          "free": 5000000,
          "max": 5368709120,
          "showing": "lifetime",
          "used": 5368704120
        }
      },
      "uri": "/users/152184",
      "websites": [
        {
          "description": "Follow us on Twitter!",
          "link": "https://twitter.com/vimeo",
          "name": "Twitter"
        }
      ]
    }
  }
]

Changes

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