VK Video Scraper API — Channels, Search & Downloads

Scrape public videos from VK, VKontakte, and VKVideo.ru without a login. Use one Actor for channel/community videos, keyword search, direct videos, clips, playlists, exact engagement counts, thumbnails, subtitles, and optional MP4 or cover downloads.

The Actor uses the anonymous HTTP flow used by VK Video's public web client. Normal runs start no browser and no proxy, keeping compute and bandwidth low.

Result policy: a complete run with 0 valid public videos finishes as FAILED. When at least one row is saved, private/deleted/empty inputs become warnings unless failOnPartialFailure is enabled.

Quick start

Paste mixed VK URLs and let the Actor route them automatically:

{
  "startUrls": [
    { "url": "https://vkvideo.ru/@club228512875/all" },
    { "url": "https://vkvideo.ru/?q=%D0%BA%D0%BE%D1%82%D0%B8%D0%BA%D0%B8" },
    { "url": "https://vkvideo.ru/video-228512875_456239081" },
    { "url": "https://vkvideo.ru/clip-125504191_456260941" }
  ],
  "resultsPerInput": 5,
  "includeClips": true,
  "shouldDownloadVideos": false,
  "shouldDownloadCovers": false
}

Or use dedicated input fields:

{
  "channels": ["kinopix", "club228512875"],
  "searchKeywords": ["котики", "искусственный интеллект"],
  "videoUrls": ["https://vk.com/video-228512875_456239081"],
  "resultsPerInput": 50
}

Start with 5 results and downloads disabled to validate your inputs at minimum cost.

Supported inputs

• VKVideo channel tabs such as https://vkvideo.ru/@channel/all and /clips
• Bare screen names such as kinopix or club228512875
• Legacy VK owner pages such as https://vk.com/videos-228512875
• VK and VKVideo direct video URLs (video-OWNER_ID_VIDEO_ID)
• VK Clip URLs (clip-OWNER_ID_VIDEO_ID)
• Search keywords in Cyrillic or Latin characters
• Search URLs containing a q parameter
• Public catalog and playlist URLs exposed by VK Video

Duplicate inputs and duplicate videos across sources are removed before dataset billing.

Output

Each dataset row represents one public video or clip:

{
  "videoId": "-228512875_456239081",
  "ownerId": "-228512875",
  "webVideoUrl": "https://vkvideo.ru/video-228512875_456239081",
  "title": "Video title",
  "description": "Video description",
  "createTimeISO": "2026-01-03T12:00:00.000Z",
  "duration": 2009,
  "videoType": "video",
  "width": 1920,
  "height": 1080,
  "videoDownloadUrl": "https://...temporary-signed-media-url...",
  "mediaExpiresAt": "2026-09-20T12:00:00.000Z",
  "videoUrls": {
    "mp4_1080": "https://...",
    "mp4_720": "https://...",
    "hls": "https://..."
  },
  "availableQualities": ["1080p", "720p", "480p", "360p", "240p", "144p"],
  "coverUrl": "https://...",
  "author": {
    "id": "-228512875",
    "type": "community",
    "screenName": "club228512875",
    "name": "Channel name",
    "verified": true,
    "followers": 46550,
    "avatar": "https://..."
  },
  "stats": {
    "viewCount": 282409,
    "likeCount": 2565,
    "commentCount": 37,
    "repostCount": 37
  },
  "hashtags": [],
  "mentions": [],
  "subtitles": [],
  "sourceType": "direct",
  "sourceInput": "https://vkvideo.ru/video-228512875_456239081",
  "scrapedAt": "2026-09-15T12:00:00.000Z"
}

Fields that VK does not expose for a particular video are omitted rather than guessed. Counts are exact integer snapshots from VK's response.

Media downloads

Metadata rows include every exposed MP4/HLS/DASH variant and select the requested quality as videoDownloadUrl. These signed URLs are temporary and can be tied to the requesting IP.

Set shouldDownloadVideos: true when you need a durable MP4 in the run's Key-Value Store. The Actor downloads the preferred MP4 (up to 4K when available), stores it under storedVideoKey, and preserves the metadata row if the file is too large or unavailable. maxDownloadMegabytes prevents an unexpectedly large video from exhausting memory or storage.

Downloads increase runtime, storage, network use, and platform charges. They are disabled by default.

Main options

Field	Default	Purpose
startUrls	[]	Auto-detected mixed VK/VKVideo URLs
channels	[]	Channel names, owner IDs, or owner URLs
searchKeywords	[]	VK Video keyword searches
videoUrls	[]	Direct video or clip URLs
resultsPerInput	50	Maximum rows per channel/catalog/search; 0 follows the feed to its end/safety limit
includeClips	true	Keep short-video rows in mixed search/catalog results
shouldDownloadVideos	false	Store selected MP4 files
videoQuality	best	best, 2160, 1440, 1080, 720, 480, 360, 240, or 144
shouldDownloadCovers	false	Store the largest exposed thumbnail
maxPagesPerInput	100	Hard pagination safety guard
failOnPartialFailure	false	Fail the run when any individual input is empty/invalid

Pricing

• Free plan: $0.00225 per result — $2.25 per 1,000
• Bronze: $0.00045 per result — $0.45 per 1,000
• Silver and above: $0.00040 per result — $0.40 per 1,000
• Actor start: $0.0005
• Standard Apify platform usage is billed separately to the user
• Only rows actually written to the default dataset incur the result fee

Apify Free-plan users can receive up to 50 dataset rows per run across all inputs. Paid-plan users do not have this developer-set 50-row cap.

API example

curl -X POST "https://api.apify.com/v2/acts/funny_ground~vk-video-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchKeywords":["котики"],"resultsPerInput":5}'

Русский

Actor собирает публичные видео VK и VKVideo без авторизации: видео каналов и сообществ, поиск по ключевым словам, отдельные видео и клипы, статистику, обложки, субтитры и временные ссылки MP4/HLS. Для первого запуска укажите resultsPerInput: 5 и оставьте скачивание файлов выключенным.

中文

本 Actor 无需登录即可抓取公开 VK/VKVideo 频道视频、关键词搜索结果、单视频与 Clips，并输出作者、互动数、封面、字幕和多清晰度媒体链接。建议先用 resultsPerInput: 5、关闭下载做低成本验证。

Limitations and responsible use

• Public content only; private, deleted, geo-blocked, age-restricted, or login-only items may be unavailable.
• VK can change its public web responses without notice. The Actor validates response shapes and fails visibly instead of returning fabricated rows.
• Signed media URLs expire and may be IP-bound; enable file storage when a durable copy is authorized and required.
• Search ranking and channel feeds are snapshots and can change between runs.
• Respect applicable law, copyright, privacy, and VK's terms. Do not use the Actor to bypass access controls.

Related Actors

• TikTok Scraper API — Video, Profile, Hashtag & Search
• Instagram Reels & Video Scraper
• YouTube Scraper API — Channels, Shorts & Playlists