video.get

The translation was generated automatically and may contain mistakes

The method returns information about the video recordings.

Note. Hidden videos will not be reflected in the method response. Fewer videos may return than you specified in the parameter count .

To call this method, you can use:

• user access token (access right required: video — this is issued in exceptional cases by a request to support at devsupport@corp.vk.com)

Parameters

owner_id

integer

An optional parameter. The identity of the user or community that owns the videos. The community ID should start with a sign - .

videos

string

An optional parameter. Identifiers in format {owner_id}_{video_id} listed by comma. The community ID should start with a sign - .

Example: -166562603_456239104,743784474_456239017 .

Some videos are private and cannot be accessed without the Access Key . In this case, send the ID in the format {owner_id}_{video_id}_{access_key} .

Example: 1_129207899_220df2876123d3542f,6492_135055734_e0a9bcc31144f67fbd .

Note. The access key is returned along with the rest of the video data in methods that return private videos available in this context. For example, videos returned by the method have this field.. messages.getHistory .

album_id

string

An optional parameter. The ID of the album, the videos of which need to be returned. If the parameter is not transmitted, the video recordings from the album are returned Added .

count

positive

An optional parameter. Number of videos returned.

offset

positive

An optional parameter. Offset to return videos relative to the start of the list.

extended

checkbox

An optional parameter. Information about whether to return information about video privacy settings to the current user, as well as additional fields profiles and groups . Possible values:

•
1 Return additional information.
•
0 Do not return additional information.

fields

string

An optional parameter. Additional Field Information profiles and groups . Considered if a parameter is passed extended with meaning 1 .

sort_album

integer

An optional parameter. Sort videos by date of addition. Possible values:

•
0 From new to old.
•
1 From old to new.

Result

The method returns an object. Object fields:

Field	Type	Description
`count`	`integer`	Number of videos.
`items`	`array[object]`	Object Array videos With an additional field `comments` The number of comments in the video.

If a parameter is passed extended with meaning 1 Additional fields are returned:

Field	Type	Description
`privacy_view`	`string`	Privacy settings in format privacy settings . It only works for the current user.
`privacy_comment`	`string`	Privacy settings in format privacy settings . It only works for the current user.
`can_comment`	`boolean`	Information about whether the user can comment on the video. Possible values: • `1` The user can comment on the video. • `0` The user cannot comment on the video.
`can_repost`	`boolean`	Information about whether the user can share the video with the function “Tell your friends?2?. Possible values: • `1` The user can share the video. • `0` The user cannot share the video.
`likes`	`object`	Posts Tagged ?2?like’. Object fields: • `user_likes` Whether the user has made a mark. • `count` Number of marks.
`repeat`	`boolean`	Information about whether to loop the video playback. Possible values: • `1` - loop the playback. • `0` - do not loop the playback.

Example of response:

JSON

{
  "response":{
    "count":1
    "items":[
      {
        "adding_date":1671701038,
        "can_comment":0,
        "can_like":1,
        "can_repost":1,
        "can_subscribe":1,
        "can_add_to_faves":1,
        "can_add":1,
        "comments":0,
        "date":1671701032,
        "description":"",
        "duration":15,
        "image":[
          {
            "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=1&type=39&tkn=3uLZ5s_T4TtRsvZfIwLngp8Qdjs&fn=vid_s",
            "width":130,
            "height":96,
            "with_padding":1
          },
          {
            "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=1&type=39&tkn=3uLZ5s_T4TtRsvZfIwLngp8Qdjs&fn=vid_m",
            "width":160,
            "height":120,
            "with_padding":1
          },
          {
            "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=1&type=39&tkn=3uLZ5s_T4TtRsvZfIwLngp8Qdjs&fn=vid_l",
            "width":320,
            "height":240,
            "with_padding":1
          },
          {
            "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=1&type=39&tkn=3uLZ5s_T4TtRsvZfIwLngp8Qdjs&fn=vid_x",
            "width":800,
            "height":450,
            "with_padding":1
          },
          {
            "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=1&type=39&tkn=3uLZ5s_T4TtRsvZfIwLngp8Qdjs&fn=vid_w",
            "width":1280,
            "height":720
          },
          {
            "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=1&type=39&tkn=3uLZ5s_T4TtRsvZfIwLngp8Qdjs&fn=vid_t",
            "width":320,
            "height":180
          },
          {
            "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=1&type=39&tkn=3uLZ5s_T4TtRsvZfIwLngp8Qdjs&fn=vid_u",
            "width":720,
            "height":405
          }
        ],
        "first_frame":[
          {
            "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=0&type=39&tkn=WK9Wdwpqr6z6g9umM95aW3Ch3QM&fn=vid_f",
            "width":720,
            "height":405
          },
          {
            "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=0&type=39&tkn=WK9Wdwpqr6z6g9umM95aW3Ch3QM&fn=vid_md",
            "width":480,
            "height":270
          },
          {
            "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=0&type=39&tkn=WK9Wdwpqr6z6g9umM95aW3Ch3QM&fn=vid_d",
            "width":240,
            "height":135
          },
          {
            "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=0&type=39&tkn=WK9Wdwpqr6z6g9umM95aW3Ch3QM&fn=vid_sm",
            "width":128,
            "height":72
          },
          {
            "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=0&type=39&tkn=WK9Wdwpqr6z6g9umM95aW3Ch3QM&fn=vid_w",
            "width":1280,
            "height":720
          },
          {
            "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=0&type=39&tkn=WK9Wdwpqr6z6g9umM95aW3Ch3QM&fn=vid_h",
            "width":960,
            "height":540
          },
          {
            "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=0&type=39&tkn=WK9Wdwpqr6z6g9umM95aW3Ch3QM&fn=vid_w",
            "width":1280,
            "height":720
          }
        ],
        "width":1920,
        "height":1080,
        "id":456242110,
        "owner_id":-22822305,
        "title":"Анимированные vmoji в VK Звонках",
        "is_favorite":false,
        "player":"https://vk.com/video_ext.php?oid=-22822305&id=456242110&hash=e037414127166efe&__ref=vk.api&api_hash=1677682946870d1f6fa590a9b323_HAZDCNJWG42DA",
        "added":0,
        "repeat":1,
        "type":"video",
        "views":19271183,
        "likes":{
          "count":15007,
          "user_likes":0
        },
        "reposts":{
          "count":137,
          "user_reposted":0
        }
      }
    ]
  }
}

Example response with parameter extended=1 :

JSON

{
  "response":{
  "count":1,
  "items":[
    {
      "adding_date":1671701038,
      "can_comment":0,
      "can_like":1,
      "can_repost":1,
      "can_subscribe":1,
      "can_add_to_faves":1,
      "can_add":1,
      "comments":0,
      "date":1671701032,
      "description":"",
      "duration":15,
      "image":[
        {
          "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=1&type=39&tkn=3uLZ5s_T4TtRsvZfIwLngp8Qdjs&fn=vid_s",
          "width":130,
          "height":96,
          "with_padding":1
        },
        {
          "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=1&type=39&tkn=3uLZ5s_T4TtRsvZfIwLngp8Qdjs&fn=vid_m",
          "width":160,
          "height":120,
          "with_padding":1
        },
        {
          "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=1&type=39&tkn=3uLZ5s_T4TtRsvZfIwLngp8Qdjs&fn=vid_l",
          "width":320,
          "height":240,
          "with_padding":1
        },
        {
          "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=1&type=39&tkn=3uLZ5s_T4TtRsvZfIwLngp8Qdjs&fn=vid_x",
          "width":800,
          "height":450,
          "with_padding":1
        },
        {
          "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=1&type=39&tkn=3uLZ5s_T4TtRsvZfIwLngp8Qdjs&fn=vid_w",
          "width":1280,
          "height":720
        },
        {
          "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=1&type=39&tkn=3uLZ5s_T4TtRsvZfIwLngp8Qdjs&fn=vid_t",
          "width":320,
          "height":180
        },
        {
          "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=1&type=39&tkn=3uLZ5s_T4TtRsvZfIwLngp8Qdjs&fn=vid_u",
          "width":720,
          "height":405
        }
      ],
      "first_frame":[
        {
          "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=0&type=39&tkn=WK9Wdwpqr6z6g9umM95aW3Ch3QM&fn=vid_f",
          "width":720,
          "height":405
        },
        {
          "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=0&type=39&tkn=WK9Wdwpqr6z6g9umM95aW3Ch3QM&fn=vid_md",
          "width":480,
          "height":270
        },
        {
          "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=0&type=39&tkn=WK9Wdwpqr6z6g9umM95aW3Ch3QM&fn=vid_d",
          "width":240,
          "height":135
        },
        {
          "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=0&type=39&tkn=WK9Wdwpqr6z6g9umM95aW3Ch3QM&fn=vid_sm",
          "width":128,
          "height":72
        },
        {
          "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=0&type=39&tkn=WK9Wdwpqr6z6g9umM95aW3Ch3QM&fn=vid_w",
          "width":1280,
          "height":720
        },
        {
          "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=0&type=39&tkn=WK9Wdwpqr6z6g9umM95aW3Ch3QM&fn=vid_h",
          "width":960,
          "height":540
        },
        {
          "url":"https://i.mycdn.me/getVideoPreview?id=3376734079543&idx=0&type=39&tkn=WK9Wdwpqr6z6g9umM95aW3Ch3QM&fn=vid_w",
          "width":1280,
          "height":720
        }
      ],
      "width":1920,
      "height":1080,
      "id":456242110,
      "owner_id":-22822305,
      "title":"Анимированные vmoji в VK Звонках",
      "is_favorite":false,
      "player":"https://vk.com/video_ext.php?oid=-22822305&id=456242110&hash=e037414127166efe&__ref=vk.api&api_hash=16776826036e5b8c0303e6f9b28a_HAZDCNJWG42DA",
      "added":0,
      "repeat":1,
      "type":"video",
      "views":19271178,
      "likes":{
        "count":15007,
        "user_likes":0
      },
      "reposts":{
        "count":137,
        "user_reposted":0
      }
    }
  }
}

Error codes

204

Access denied

Common errors may occur during execution

Linked versions

Go to API versions page

5.54

If no end date is specified in the method call parameters, return objects that describe community They no longer have a field.. finish_data . Previously, this field was present in the response and contained the default, equal to start_date + 2 hours.

5.30

The data format has been changed, describes the privacy .

video.get

Parameters

Result

Error codes

Linked versions

Технические работы