Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the VK (VKontakte) API page →
Social Media

VK (VKontakte) API & Scraper

This API reads VK (VKontakte, vk.com / vk.ru), the largest social network in Russia and the CIS, as JSON, logged out, with no VK account.

28 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

`user` returns a public profile: name, screen name, photo, verified badge, follower count, city, country, birthday as published, status, about, website, last seen with platform, occupation, career with company and years, universities, schools, relatives, relationship, languages, religion, interests and favourite music, films, TV, books, games and quotes. A private profile returns what VK shows logged-out visitors (name, photo, closed flag). `community` returns a group, public page or event: name, type, member count, verified and trust marks, activity, status, description, website, phone, contacts with role, phone and e-mail, links, main address, content counts (posts, videos, clips, articles, addresses), cover and event dates. `wall` returns a user's or community's posts newest first with full text and mentions, author, date, edit date, likes, reactions by type, comment count, reposts, views and every attachment (photos in every size, videos, links, polls, documents, articles, shop items) plus reposted originals, filterable to the owner's own posts or visitors' posts, every page to the end. `post_comments` returns comments with author, date, likes, attachments and up to 10 replies each, oldest or newest first; `comment_id` pages through all replies of one comment. `followers`, `friends` and `subscriptions` list people and pages around a user, up to 1,000 per page. `videos`, `video`, `video_comments`, `video_playlists` and `clips` cover VK video with direct MP4 links up to 4K where VK has them and subtitles. `photos` returns every photo size up to the original. `articles` lists long reads with views and shares and `article` returns one article's full text. `community_search` and `video_search` are VK's own search boxes with their filters. `wall_search` searches inside one wall. `board_topics` / `board_comments` read a community's discussion board, `market` / `market_item` / `market_albums` a community's shop, `cities` VK's city directory and `resolve` turns any screen name into its id.

Reference

What a VK field actually contains

Fields that read differently from how they look. Every row was measured against live vk.com on 2026-11-16.

FieldWhat it holds
followers_count (user)The user's follower count as VK publishes it (people who follow without being friends). Compared with the number on the user's own vk.com page for 7 profiles: 7 of 7 equal.
members_count, members_count_text (community)The community's member / subscriber count and VK's own printed label ("14 148 456 подписчиков"). The digits of the label equalled members_count on 7 of 7 communities, and members_count equalled the community page's own number (within 2 for the two largest, which grew between the two reads).
likes, reactions, reactions_total (post)likes is VK's like counter; reactions splits it by reaction type with VK's own titles (Лайк and the other reaction names); the reaction counts add up to reactions_total.
views (post)VK's view counter for the post. VK did not count views on old posts: on durov's wall 25 of 45 posts carry it, on community walls 100 %. Against the counter on the community's own page 66 of 70 posts were equal or a few views ahead; 4 were 2 to 4 views lower (VK's counter differs slightly between reads).
owner_id, from_idVK's own convention: users are positive numbers, communities negative (-22822305 is the VK community). from_id is who wrote the post or comment.
published_at, edited_at, posted_atUTC timestamps (ISO 8601 with Z) of the post's publication, last edit and a comment's posting; the raw Unix seconds are in *_unix.
text, text_raw, mentionstext is the readable text. VK's own link markup ([id1|Pavel], [club1|VK], [https://…|label]) stays verbatim in text_raw and every link target is listed in mentions.
total (post_comments)The number of top-level comments; total_with_replies counts every comment including replies (133 and 307 on one VK post).
files (video)Direct MP4 links per resolution (mp4_144 … mp4_2160) plus HLS / DASH. They are temporary signed links: fetch them soon after the call.
followers / friends rowsFollower rows carry name, profile link, photo and, when the person publishes them, city (39 % of 1,617 rows), country, follower count and last seen. Friend rows are the shorter card VK shows logged-out visitors: name, screen name, link, photo and city on about 40 %.
price (market)The product price in roubles (or the shop's currency), from VK's amount in kopecks; price_text is VK's own printed price ("30 000 ₽").

Filters were checked on 2026-11-16 by comparing the unfiltered and the filtered result in the same minute; options VK ignores are not offered.

Live example

Real request and response JSON

Captured from the indexed primary action, user, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/vk/v1/user",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "user": "durov"
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "vk",
    "endpoint": "user",
    "mode": "live",
    "latency_ms": 480,
    "record_count": 1,
    "bytes": 4853,
    "cache_hit": false,
    "upstream_requests": 1,
    "charged_credits": 1,
    "version": "1.0.0",
    "request_id": "8bca16e56b174b14",
    "queue_ms": 1.9,
    "fetched_at": "2026-11-16T15:58:09.572Z"
  },
  "data": {
    "type": "user",
    "id": 1,
    "owner_id": 1,
    "screen_name": "durov",
    "name": "Павел Дуров",
    "first_name": "Павел",
    "last_name": "Дуров",
    "url": "https://vk.com/durov",
    "photo": "https://sun9-81.vkuserphoto.ru/s/v1/ig1/36o_rXYV8irRb3HevhJemHEWX0J-MqFQSBXuIL9eVSUxNnbbsmmtQLxbNDJO6018NVaaMmfH.jpg?quality=96&crop=514,119,337,337&blur=5,10&as=32x32,48x48,72x72,108x108,160x160,240x240&ava=1&u=uOFKBVit3fNWiRE5u2E0F4zm_GiXN0pazp8LoszekMM&cs=400x400",
    "verified": true,
    "is_closed": false,
    "deactivated": null,
    "sex": "male",
    "city": {
      "id": 2,
      "name": "Санкт-Петербург"
    },
    "country": {
      "id": 1,
      "name": "Россия"
    },
    "followers_count": 4515562,
    "online": false,
    "last_seen": null,
    "bdate": "10.10.1984",
    "activity": "道德經",
    "first_name_nominative": "Павел",
    "maiden_name": null,
    "nickname": null,
    "domain": "durov",
    "status": "道德經",
    "about": null,
    "site": "http://t.me/durov",
    "home_town": null,
    "relation": null,
    "relation_partner": null,
    "occupation": {
      "type": "work",
      "name": "Telegram",
      "id": null,
      "city_id": null,
      "country_id": null,
      "graduate_year": null
    },
    "career": [
      {
        "company": null,
        "group_id": 22822305,
        "position": "Генеральный директор",
        "from": 2006,
        "until": 2014,
        "city_id": 2,
        "city_name": null,
        "country_id": 1
      },
      {
        "company": "Telegram",
        "group_id": null,
        "position": "CEO",
        "from": 2014,
        "until": null,
        "city_id": 458,
        "city_name": null,
        "country_id": 65
      }
    ],
    "universities": [
      {
        "id": 1,
        "name": "СПбГУ",
        "faculty": null,
        "chair": null,
        "graduation": 2006,
        "education_form": null,
        "education_status": null,
        "city_id": 2,
        "country_id": 1
      }
    ],
    "schools": [
      {
        "id": 1035386,
        "name": "Scuola Elementare Coppino - Falletti di Barolo",
        "type": null,
        "class": null,
        "speciality": null,
        "year_from": 1990,
        "year_to": 1992,
        "year_graduated": null,
        "city_id": 16,
        "country_id": 88
      },
      {
        "id": 1,
        "name": "Академическая гимназия им. Д. К. Фаддеева СПбГУ",
        "type": "Гимназия",
        "class": "о",
        "speciality": null,
        "year_from": 1996,
        "year_to": 2001,
        "year_graduated": 2001,
        "city_id": 2,
        "country_id": 1
      }
    ],
    "military": [],
    "relatives": [],
    "personal": {
      "political": "libertarian",
      "langs": [
        "Русский",
        "English",
        "Français"
      ],
      "religion": "Laissez-faire",
      "inspired_by": "Steve Jobs",
      "people_main": "courage_and_persistence",
      "life_main": "personal_development",
      "smoking": "very_negative",
      "alcohol": "very_negative"
    },
    "interests": null,
    "activities": null,
    "music": null,
    "movies": "12 Angry Men",
    "tv": null,
    "books": null,
    "games": null,
    "quotes": "Being free, being truly free consists of not being bound by the opinions that others choose to display in regards to the decisions that one chooses to make on a daily weekly, or lifetime basis. \n\nIn order to be free we have to be willing to think for ourselves, learn for our selves, and to live our lives as our real true selves. Being free is when you are able to stand up and speak in public spewing your beliefs not caring what anyone else will think of them. \n\nBeing free is when you are able to go against the grain, when you are able to make a left when everyone else is going right, and not w",
    "contacts": null,
    "connections": null,
    "photo_id": "1_456264771",
    "photo_max_size": {
      "album_id": 0,
      "date": 0,
      "id": 0,
      "owner_id": 0,
      "height": 452,
      "width": 400,
      "has_tags": false
    },
    "photos": {
      "photo_50": "https://sun9-81.vkuserphoto.ru/s/v1/ig1/36o_rXYV8irRb3HevhJemHEWX0J-MqFQSBXuIL9eVSUxNnbbsmmtQLxbNDJO6018NVaaMmfH.jpg?quality=96&crop=514,119,337,337&blur=5,10&as=32x32,48x48,72x72,108x108,160x160,240x240&ava=1&u=uOFKBVit3fNWiRE5u2E0F4zm_GiXN0pazp8LoszekMM&cs=50x50",
      "photo_100": "https://sun9-81.vkuserphoto.ru/s/v1/ig1/36o_rXYV8irRb3HevhJemHEWX0J-MqFQSBXuIL9eVSUxNnbbsmmtQLxbNDJO6018NVaaMmfH.jpg?quality=96&crop=514,119,337,337&blur=5,10&as=32x32,48x48,72x72,108x108,160x160,240x240&ava=1&u=uOFKBVit3fNWiRE5u2E0F4zm_GiXN0pazp8LoszekMM&cs=100x100",
      "photo_200": "https://sun9-81.vkuserphoto.ru/s/v1/ig1/36o_rXYV8irRb3HevhJemHEWX0J-MqFQSBXuIL9eVSUxNnbbsmmtQLxbNDJO6018NVaaMmfH.jpg?quality=96&crop=514,119,337,337&blur=5,10&as=32x32,48x48,72x72,108x108,160x160,240x240&ava=1&u=uOFKBVit3fNWiRE5u2E0F4zm_GiXN0pazp8LoszekMM&cs=200x200",
      "photo_400": "https://sun9-81.vkuserphoto.ru/s/v1/ig1/36o_rXYV8irRb3HevhJemHEWX0J-MqFQSBXuIL9eVSUxNnbbsmmtQLxbNDJO6018NVaaMmfH.jpg?quality=96&crop=514,119,337,337&blur=5,10&as=32x32,48x48,72x72,108x108,160x160,240x240&ava=1&u=uOFKBVit3fNWiRE5u2E0F4zm_GiXN0pazp8LoszekMM&cs=400x400",
      "photo_max": "https://sun9-81.vkuserphoto.ru/s/v1/ig1/36o_rXYV8irRb3HevhJemHEWX0J-MqFQSBXuIL9eVSUxNnbbsmmtQLxbNDJO6018NVaaMmfH.jpg?quality=96&crop=514,119,337,337&blur=5,10&as=32x32,48x48,72x72,108x108,160x160,240x240&ava=1&u=uOFKBVit3fNWiRE5u2E0F4zm_GiXN0pazp8LoszekMM&cs=400x400",
      "photo_base": "https://sun9-81.vkuserphoto.ru/s/v1/ig1/36o_rXYV8irRb3HevhJemHEWX0J-MqFQSBXuIL9eVSUxNnbbsmmtQLxbNDJO6018NVaaMmfH.jpg?quality=96&crop=514,119,337,337&blur=5,10&as=32x32,48x48,72x72,108x108,160x160,240x240&ava=1&u=uOFKBVit3fNWiRE5u2E0F4zm_GiXN0pazp8LoszekMM"
    },
    "has_photo": true,
    "cover": {
      "enabled": 1
    },
    "wall_default": "owner",
    "trending": false,
    "is_nft": false,
    "is_dead": false,
    "online_info": {
      "visible": false,
      "status": "recently"
    },
    "can_access_closed": true,
    "bdate_visibility": 1,
    "image_status": null,
    "no_index": "all"
  }
}
Actions

What the VK (VKontakte) API does

ActionDescriptionConcrete use caseKey params
userA VK user's public profile: name, screen name, photo, verified badge, follower count, city, country, birthday (as published), status, about, site, last seen + platform, online, occupation, career (company / position / years), universities, schools, military, relatives, relationship, personal views (languages, religion, inspired by, life / people priorities), interests, favourite music / movies / TV / books / games / quotes, cover and every photo size. A private profile returns what VK shows logged-out visitors: name, photo, is_closed=true. Deleted / banned → NOT_FOUND with `reason`.Social-listening tools call user to get a VK user's public profile.user, lang
communityA VK community's (group, public page or event) public profile: name, screen name, type, members count, verified / trust marks, activity, status, description, site, phone, contacts (people with role, phone, e-mail), links, main address, city / country, content counts (wall posts, videos, clips, articles, addresses), menu, cover, age limit, event start / end dates, market settings, wiki page, pinned post id. Deleted / banned → NOT_FOUND with `reason`.Creator and influencer platforms call community to get a VK community's (group, public page or event) public profile.community, lang
community_addressesEvery address a community publishes (shops, offices, venues): title, street address, city, country, metro, coordinates, phone, opening hours and open-now status.Brand-monitoring teams call community_addresses to get every address a community publishes (shops, offices, venues).community, page, per_page, offset, lang
community_membersThe member preview VK shows logged-out visitors: the real total member count plus up to 8 members (name, profile link, photo, city). VK refuses any offset or cursor without login, so the full member list is not reachable.Audience analysts call community_members to get the member preview VK shows logged-out visitors.community, lang
wallPosts on a user's or community's wall, newest first (the pinned post first when there is one): full text with mentions, author, date, edit date, likes, reactions by type, comments count, reposts, views, every attachment (photos in all sizes, videos, links, polls, documents, articles, market items) and reposted originals. `filter`: all, owner (only the owner's own posts), others (posts by visitors). Every page is reachable to the end (`total` = VK's post count).Social-listening tools call wall to get posts on a user's or community's wall, newest first (the pinned post first when there is one).owner, filter, page, per_page, offset, ...
wall_searchSearch one user's or community's wall for a word or phrase (VK's own in-wall search). `owners_only` (default true) searches the owner's posts; false also searches visitors' posts and is much slower on VK's side. VK publishes no total for this search: `has_more` is true while a page comes back full.Creator and influencer platforms call wall_search to search one user's or community's wall for a word or phrase (VK's own in-wall search).owner, query, owners_only, page, per_page, ...
postOne wall post with everything VK publishes on it: full text, author and owner, date, edit date, likes, reactions by type, comments count, reposts, views, every attachment and the reposted original(s).Brand-monitoring teams call post to get one wall post with everything VK publishes on it.post, lang
post_commentsComments on a wall post: author (name, profile link, photo), date, text with mentions, likes, attachments and up to 10 replies inline per comment (with the reply count); oldest or newest first, every page reachable. Pass `comment_id` to page through all replies of one comment. `total` counts top-level comments, `total_with_replies` everything.Audience analysts call post_comments to get comments on a wall post.post, sort, comment_id, replies_per_comment, page, ...
followersA user's followers (subscribers who are not friends): name, profile link, photo, verified, city, country, follower count, last seen. Up to 1,000 per page; every page is reachable to the end (4,515,565 followers of `durov` paged to the last 565).Social-listening tools call followers to get a user's followers (subscribers who are not friends).user, page, per_page, offset, lang
friendsA user's friends list when the user shows it publicly: name, profile link, photo, city, country, follower count, last seen. Up to 1,000 per page. A user who hides friends → NOT_FOUND, reason private.Creator and influencer platforms call friends to get a user's friends list when the user shows it publicly.user, page, per_page, offset, lang
subscriptionsThe public pages, communities and people a user follows: name, link, photo, type, members count, activity. Up to 200 per page.Brand-monitoring teams call subscriptions to get the public pages, communities and people a user follows.user, page, per_page, offset, lang
videosVideos uploaded to or added by a user or community: title, description, duration, date, views, likes, reposts, comments, thumbnails, player link and direct MP4 links (144p up to 4K where VK has them), subtitles. Optional playlist (`playlist_id`, from `video_playlists`). Up to 200 per page.Audience analysts call videos to get videos uploaded to or added by a user or community.owner, playlist_id, page, per_page, offset, ...
videoOne video or clip in full: title, description, duration, dates, views, likes, reposts, comments, size, thumbnails, player link, direct MP4 / HLS / DASH links, trailer, subtitles, share link.Social-listening tools call video to get one video or clip in full.video, lang
video_commentsComments on a video or clip: author, date, text, likes, reply count; oldest or newest first, up to 100 per page.Creator and influencer platforms call video_comments to get comments on a video or clip.video, sort, page, per_page, offset, ...
video_playlistsA user's or community's video playlists: id, title, number of videos, update date, cover, first video link. Use the id as `playlist_id` in `videos`.Brand-monitoring teams call video_playlists to get a user's or community's video playlists.owner, page, per_page, offset, lang
video_searchSearch VK Video like the site's search box, with its filters: sort (relevance, newest, longest), content type (video, clip, live, channel), duration (short, long), HD only. Each row is a full video with its channel and direct MP4 links; matching playlists come back separately. VK serves ~20-30 rows on the first page and 10 per page after; from page 3 it repeats rows it already served, which are dropped (`dropped_repeats`). Page on with `cursor`.Audience analysts call video_search to search VK Video like the site's search box, with its filters.query, sort, content_type, duration, hd, ...
clipsA user's or community's clips (VK short videos): caption, views, likes, comments, reposts, date, duration, thumbnails, direct MP4 links. Up to 100 per page; page on with `cursor`.Social-listening tools call clips to get a user's or community's clips (VK short videos).owner, per_page, cursor, lang
photosPhotos of a user or community: every size VK keeps (up to the original), caption, date, likes, comments, reposts. `album`: all (default), profile (profile photos), wall (wall photos) or a numeric album id. Up to 200 per page for `all`, 1,000 for one album.Creator and influencer platforms call photos to get photos of a user or community.owner, album, page, per_page, offset, ...
articlesArticles (long reads) a user or community published: title, subtitle, lead, link, date, views, shares, reading time, cover image. Up to 50 per page.Brand-monitoring teams call articles to get articles (long reads) a user or community published.owner, page, per_page, offset, lang
articleOne article's full text from its page (vk.com/@<slug>): title, description, author, publish and modify dates, the body as headings / paragraphs / list items / quotes, plain text, word count, images and links. Views and shares are in `articles`.Audience analysts call article to get one article's full text from its page (vk.com/@<slug>).article
community_searchSearch VK communities like the site's search: by keyword, with type (group, page, event), city or country, and sort (relevance, popularity, members). 20 per page; VK serves up to ~19 pages (383 unique communities measured for `футбол`) — narrow by city or type for more. Page on with `cursor`.Social-listening tools call community_search to search VK communities like the site's search.query, type, sort, city_id, country_id, ...
board_topicsA community's discussion board topics: title, author, created / updated dates, comment count, closed / pinned flags and the topic's opening message in full. Up to 100 per page.Creator and influencer platforms call board_topics to get a community's discussion board topics.community, order, page, per_page, offset, ...
board_commentsMessages in one discussion-board topic: author, date, text, likes, attachments. Up to 100 per page, oldest or newest first.Brand-monitoring teams call board_comments to get messages in one discussion-board topic.community, topic_id, sort, page, per_page, ...
marketA community shop's products: title, description, price and old price (with currency and VK's printed price), category path, availability, photos, likes, reposts, SKU / dimensions / weight when published, ratings. Optional shop album (`album_id`, from `market_albums`). Up to 200 per page.Audience analysts call market to get a community shop's products.community, album_id, page, per_page, offset, ...
market_itemOne shop product in full (same fields as `market`, plus every photo).Social-listening tools call market_item to get one shop product in full (same fields as `market`, plus every photo)..item, lang
market_albumsA community shop's albums (collections): id, title, number of products, update date, cover.Creator and influencer platforms call market_albums to get a community shop's albums (collections).community, page, per_page, offset, lang
citiesVK's city directory: city ids with region and district, for the `city_id` filter of `community_search`. Without `query` VK returns the country's main cities.Brand-monitoring teams call cities to get vK's city directory.query, country_id, per_page, offset, lang
resolveWhat a VK address points to: a screen name or link → its type (user, group, page, event, application) and numeric id.Audience analysts call resolve to get what a VK address points to.name
Code samples

Call user from your stack

curl -X POST https://api.reefapi.com/vk/v1/user \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"user":"durov"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.vk.user with {"user":"durov"}.
Use cases

Who uses this API and why

  • Monitor Russian and CIS brands, media and public figures: posts, reactions, views and comments on their VK walls.
  • Size an influencer or a community before a campaign: followers or members, post frequency and engagement per post.
  • Collect the comments under a post with their replies for sentiment or moderation analysis.
  • Find communities on a topic in a given city with VK's own community search, then read their contacts and addresses.
  • Track a VK shop's products and prices, or archive a channel's videos and clips with their view counts.
FAQ

Questions developers ask before integrating

Do I need a VK account or a VK developer app?

No. Everything is read logged out, as any visitor sees vk.com. You only send your ReefAPI key.

Which profiles and communities can I read?

Every open profile and community. A private profile returns its name, photo and is_closed=true, as VK shows it to logged-out visitors; its wall, friends and photos are not shown and come back as NOT_FOUND with reason private. Deleted and banned pages come back as NOT_FOUND with reason deleted or banned.

Can I get every post on a wall?

Yes. Up to 100 posts per page and every page to the end: durov's wall holds 1,020 posts and page 11 of 100 returned the last 20. filter=owner or filter=others splits a wall into the owner's posts and visitors' posts (one user's wall: 7,800 → 5,429 own and 2,371 by others).

Can I get all followers of a large account?

Yes, up to 1,000 per page with every page reachable: Pavel Durov's 4,515,567 followers paged to the last 567. friends works the same way when the user shows friends publicly; for friends VK returns name, screen name, profile link and photo (city on about 40 % of rows), not country or birthday.

Can I list all members of a community?

No. To logged-out visitors VK shows the real member count and a preview of 8 members, and refuses to page further, so `community_members` returns exactly that.

Can I search people or all posts on VK?

No. VK's people search and global post search answer nothing to logged-out visitors. You can search communities (`community_search`), videos (`video_search`) and the posts inside one wall (`wall_search`).

Which search filters work?

Community search: type (group, page, event), city, country and sort by relevance, popularity or members. Video search: sort by relevance, newest or longest, content type (video, clip, live, channel), duration (short, long) and HD only. Each was checked to change the results.

How fresh is the data?

Every call reads vk.com live; counters are the ones VK shows at that moment.

What is the VK (VKontakte) API?

VK (VKontakte) API is a ReefAPI endpoint group for vk profiles with follower counts, communities with member counts, wall posts with likes, reactions, comments, reposts and views, comments, followers, friends, videos with mp4 links, photos, articles, shops and vk's own community and video search. It returns live JSON through POST requests under /vk/v1.

Is the VK (VKontakte) API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. VK (VKontakte) calls use the same shared credit balance as every other ReefAPI engine.

Do I need a VK (VKontakte) login or account?

No login to VK (VKontakte) is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the VK (VKontakte) data?

The page example is captured from a live user call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the VK (VKontakte) API use?

VK (VKontakte) actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call VK (VKontakte) from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call vk actions with the same key, credit pool and JSON envelope used by normal REST requests.

docs / vk

VK (VKontakte)

VK profiles with follower counts, communities with member counts, wall posts with likes, reactions, comments, reposts and views, comments, followers, friends, videos with MP4 links, photos, articles, shops and VK's own community and video search.

base /vk/v128 endpoints
post/vk/v1/user1 credit

A VK user's public profile: name, screen name, photo, verified badge, follower count, city, country, birthday (as published), status, about, site, last seen + platform, online, occupation, career (company / position / years), universities, schools, military, relatives, relationship, personal views (languages, religion, inspired by, life / people priorities), interests, favourite music / movies / TV / books / games / quotes, cover and every photo size. A private profile returns what VK shows logged-out visitors: name, photo, is_closed=true. Deleted / banned → NOT_FOUND with `reason`.

ParameterAllowed / rangeDescription
userrequired—The user: screen name (`durov`), numeric id (`1`), `id1`, or a vk.com / vk.ru profile link.
lang = ruoptionalru · en · uk · be · de · es · it · fiLanguage VK answers in: names, city / country names and labels as VK shows them in that interface language — ru (default, VK's own), en (Latin transliteration: `Pavel Durov`, `Saint Petersburg`), uk, be, de, es, it, fi.
Try in playground →
post/vk/v1/community1 credit

A VK community's (group, public page or event) public profile: name, screen name, type, members count, verified / trust marks, activity, status, description, site, phone, contacts (people with role, phone, e-mail), links, main address, city / country, content counts (wall posts, videos, clips, articles, addresses), menu, cover, age limit, event start / end dates, market settings, wiki page, pinned post id. Deleted / banned → NOT_FOUND with `reason`.

ParameterAllowed / rangeDescription
communityrequired—The community (group, public page or event): screen name (`vk`), id (`22822305` or `-22822305`), `club22822305` / `public22822305` / `event…`, or a vk.com / vk.ru link.
lang = ruoptionalru · en · uk · be · de · es · it · fiLanguage VK answers in: names, city / country names and labels as VK shows them in that interface language — ru (default, VK's own), en (Latin transliteration: `Pavel Durov`, `Saint Petersburg`), uk, be, de, es, it, fi.
Try in playground →
post/vk/v1/community_addresses1 credit

Every address a community publishes (shops, offices, venues): title, street address, city, country, metro, coordinates, phone, opening hours and open-now status.

ParameterAllowed / rangeDescription
communityrequired—The community (group, public page or event): screen name (`vk`), id (`22822305` or `-22822305`), `club22822305` / `public22822305` / `event…`, or a vk.com / vk.ru link.
page = 1optional1–Page, 1-based.
per_page = 100optional1–100Addresses per page, 1-100 (VK's own maximum for this list).
offsetoptional0–Start at this position instead of `page` (0-based).
lang = ruoptionalru · en · uk · be · de · es · it · fiLanguage VK answers in: names, city / country names and labels as VK shows them in that interface language — ru (default, VK's own), en (Latin transliteration: `Pavel Durov`, `Saint Petersburg`), uk, be, de, es, it, fi.
Try in playground →
post/vk/v1/community_members1 credit

The member preview VK shows logged-out visitors: the real total member count plus up to 8 members (name, profile link, photo, city). VK refuses any offset or cursor without login, so the full member list is not reachable.

ParameterAllowed / rangeDescription
communityrequired—The community (group, public page or event): screen name (`vk`), id (`22822305` or `-22822305`), `club22822305` / `public22822305` / `event…`, or a vk.com / vk.ru link.
lang = ruoptionalru · en · uk · be · de · es · it · fiLanguage VK answers in: names, city / country names and labels as VK shows them in that interface language — ru (default, VK's own), en (Latin transliteration: `Pavel Durov`, `Saint Petersburg`), uk, be, de, es, it, fi.
Try in playground →
post/vk/v1/wall1 credit

Posts on a user's or community's wall, newest first (the pinned post first when there is one): full text with mentions, author, date, edit date, likes, reactions by type, comments count, reposts, views, every attachment (photos in all sizes, videos, links, polls, documents, articles, market items) and reposted originals. `filter`: all, owner (only the owner's own posts), others (posts by visitors). Every page is reachable to the end (`total` = VK's post count).

ParameterAllowed / rangeDescription
ownerrequired—The user or community: screen name (`durov`, `vk`), numeric id (users positive `1`, communities negative `-22822305`), `id1` / `club22822305` / `public22822305` / `event…`, or any vk.com / vk.ru link to the page.
filter = alloptionalall · owner · othersall (default), owner (the owner's own posts) or others (posts by others).
page = 1optional1–Page, 1-based.
per_page = 20optional1–100Posts per page, 1-100 (VK's own maximum for this list).
offsetoptional0–Start at this position instead of `page` (0-based).
lang = ruoptionalru · en · uk · be · de · es · it · fiLanguage VK answers in: names, city / country names and labels as VK shows them in that interface language — ru (default, VK's own), en (Latin transliteration: `Pavel Durov`, `Saint Petersburg`), uk, be, de, es, it, fi.
Try in playground →
post/vk/v1/post1 credit

One wall post with everything VK publishes on it: full text, author and owner, date, edit date, likes, reactions by type, comments count, reposts, views, every attachment and the reposted original(s).

ParameterAllowed / rangeDescription
postrequired—The post: `<owner_id>_<post_id>` (`-22822305_1738794`, `1_2442097`) or its link (`https://vk.com/wall-22822305_1738794`, also `?w=wall…` links).
lang = ruoptionalru · en · uk · be · de · es · it · fiLanguage VK answers in: names, city / country names and labels as VK shows them in that interface language — ru (default, VK's own), en (Latin transliteration: `Pavel Durov`, `Saint Petersburg`), uk, be, de, es, it, fi.
Try in playground →
post/vk/v1/post_comments1 credit

Comments on a wall post: author (name, profile link, photo), date, text with mentions, likes, attachments and up to 10 replies inline per comment (with the reply count); oldest or newest first, every page reachable. Pass `comment_id` to page through all replies of one comment. `total` counts top-level comments, `total_with_replies` everything.

ParameterAllowed / rangeDescription
postrequired—The post: `<owner_id>_<post_id>` (`-22822305_1738794`, `1_2442097`) or its link (`https://vk.com/wall-22822305_1738794`, also `?w=wall…` links).
sort = oldestoptionaloldest · newestoldest (default, the site's order) or newest first.
comment_idoptional—Return the replies of this comment instead of the top level.
replies_per_comment = 10optional0–10Replies included inline under each comment, 0-10 (default 10).
page = 1optional1–Page, 1-based.
per_page = 20optional1–100Comments per page, 1-100 (VK's own maximum for this list).
offsetoptional0–Start at this position instead of `page` (0-based).
lang = ruoptionalru · en · uk · be · de · es · it · fiLanguage VK answers in: names, city / country names and labels as VK shows them in that interface language — ru (default, VK's own), en (Latin transliteration: `Pavel Durov`, `Saint Petersburg`), uk, be, de, es, it, fi.
Try in playground →
post/vk/v1/followers1 credit

A user's followers (subscribers who are not friends): name, profile link, photo, verified, city, country, follower count, last seen. Up to 1,000 per page; every page is reachable to the end (4,515,565 followers of `durov` paged to the last 565).

ParameterAllowed / rangeDescription
userrequired—The user: screen name (`durov`), numeric id (`1`), `id1`, or a vk.com / vk.ru profile link.
page = 1optional1–Page, 1-based.
per_page = 100optional1–1000Followers per page, 1-1000 (VK's own maximum for this list).
offsetoptional0–Start at this position instead of `page` (0-based).
lang = ruoptionalru · en · uk · be · de · es · it · fiLanguage VK answers in: names, city / country names and labels as VK shows them in that interface language — ru (default, VK's own), en (Latin transliteration: `Pavel Durov`, `Saint Petersburg`), uk, be, de, es, it, fi.
Try in playground →
post/vk/v1/friends1 credit

A user's friends list when the user shows it publicly: name, profile link, photo, city, country, follower count, last seen. Up to 1,000 per page. A user who hides friends → NOT_FOUND, reason private.

ParameterAllowed / rangeDescription
userrequired—The user: screen name (`durov`), numeric id (`1`), `id1`, or a vk.com / vk.ru profile link.
page = 1optional1–Page, 1-based.
per_page = 100optional1–1000Friends per page, 1-1000 (VK's own maximum for this list).
offsetoptional0–Start at this position instead of `page` (0-based).
lang = ruoptionalru · en · uk · be · de · es · it · fiLanguage VK answers in: names, city / country names and labels as VK shows them in that interface language — ru (default, VK's own), en (Latin transliteration: `Pavel Durov`, `Saint Petersburg`), uk, be, de, es, it, fi.
Try in playground →
post/vk/v1/subscriptions1 credit

The public pages, communities and people a user follows: name, link, photo, type, members count, activity. Up to 200 per page.

ParameterAllowed / rangeDescription
userrequired—The user: screen name (`durov`), numeric id (`1`), `id1`, or a vk.com / vk.ru profile link.
page = 1optional1–Page, 1-based.
per_page = 50optional1–200Subscriptions per page, 1-200 (VK's own maximum for this list).
offsetoptional0–Start at this position instead of `page` (0-based).
lang = ruoptionalru · en · uk · be · de · es · it · fiLanguage VK answers in: names, city / country names and labels as VK shows them in that interface language — ru (default, VK's own), en (Latin transliteration: `Pavel Durov`, `Saint Petersburg`), uk, be, de, es, it, fi.
Try in playground →
post/vk/v1/videos1 credit

Videos uploaded to or added by a user or community: title, description, duration, date, views, likes, reposts, comments, thumbnails, player link and direct MP4 links (144p up to 4K where VK has them), subtitles. Optional playlist (`playlist_id`, from `video_playlists`). Up to 200 per page.

ParameterAllowed / rangeDescription
ownerrequired—The user or community: screen name (`durov`, `vk`), numeric id (users positive `1`, communities negative `-22822305`), `id1` / `club22822305` / `public22822305` / `event…`, or any vk.com / vk.ru link to the page.
playlist_idoptional—Only this playlist (album) id.
page = 1optional1–Page, 1-based.
per_page = 20optional1–200Videos per page, 1-200 (VK's own maximum for this list).
offsetoptional0–Start at this position instead of `page` (0-based).
lang = ruoptionalru · en · uk · be · de · es · it · fiLanguage VK answers in: names, city / country names and labels as VK shows them in that interface language — ru (default, VK's own), en (Latin transliteration: `Pavel Durov`, `Saint Petersburg`), uk, be, de, es, it, fi.
Try in playground →
post/vk/v1/video1 credit

One video or clip in full: title, description, duration, dates, views, likes, reposts, comments, size, thumbnails, player link, direct MP4 / HLS / DASH links, trailer, subtitles, share link.

ParameterAllowed / rangeDescription
videorequired—The video or clip: `<owner_id>_<video_id>` (`-22822305_456243492`) or its link (vk.com/video…, vk.com/clip…, vkvideo.ru/video…).
lang = ruoptionalru · en · uk · be · de · es · it · fiLanguage VK answers in: names, city / country names and labels as VK shows them in that interface language — ru (default, VK's own), en (Latin transliteration: `Pavel Durov`, `Saint Petersburg`), uk, be, de, es, it, fi.
Try in playground →
post/vk/v1/video_comments1 credit

Comments on a video or clip: author, date, text, likes, reply count; oldest or newest first, up to 100 per page.

ParameterAllowed / rangeDescription
videorequired—The video or clip: `<owner_id>_<video_id>` (`-22822305_456243492`) or its link (vk.com/video…, vk.com/clip…, vkvideo.ru/video…).
sort = oldestoptionaloldest · newestoldest (default, the site's order) or newest first.
page = 1optional1–Page, 1-based.
per_page = 20optional1–100Comments per page, 1-100 (VK's own maximum for this list).
offsetoptional0–Start at this position instead of `page` (0-based).
lang = ruoptionalru · en · uk · be · de · es · it · fiLanguage VK answers in: names, city / country names and labels as VK shows them in that interface language — ru (default, VK's own), en (Latin transliteration: `Pavel Durov`, `Saint Petersburg`), uk, be, de, es, it, fi.
Try in playground →
post/vk/v1/video_playlists1 credit

A user's or community's video playlists: id, title, number of videos, update date, cover, first video link. Use the id as `playlist_id` in `videos`.

ParameterAllowed / rangeDescription
ownerrequired—The user or community: screen name (`durov`, `vk`), numeric id (users positive `1`, communities negative `-22822305`), `id1` / `club22822305` / `public22822305` / `event…`, or any vk.com / vk.ru link to the page.
page = 1optional1–Page, 1-based.
per_page = 50optional1–100Playlists per page, 1-100 (VK's own maximum for this list).
offsetoptional0–Start at this position instead of `page` (0-based).
lang = ruoptionalru · en · uk · be · de · es · it · fiLanguage VK answers in: names, city / country names and labels as VK shows them in that interface language — ru (default, VK's own), en (Latin transliteration: `Pavel Durov`, `Saint Petersburg`), uk, be, de, es, it, fi.
Try in playground →
post/vk/v1/clips1 credit

A user's or community's clips (VK short videos): caption, views, likes, comments, reposts, date, duration, thumbnails, direct MP4 links. Up to 100 per page; page on with `cursor`.

ParameterAllowed / rangeDescription
ownerrequired—The user or community: screen name (`durov`, `vk`), numeric id (users positive `1`, communities negative `-22822305`), `id1` / `club22822305` / `public22822305` / `event…`, or any vk.com / vk.ru link to the page.
per_page = 20optional1–100Clips per page, 1-100.
cursoroptional—The `next_cursor` of the previous page; the query and filters ride inside it.
lang = ruoptionalru · en · uk · be · de · es · it · fiLanguage VK answers in: names, city / country names and labels as VK shows them in that interface language — ru (default, VK's own), en (Latin transliteration: `Pavel Durov`, `Saint Petersburg`), uk, be, de, es, it, fi.
Try in playground →
post/vk/v1/photos1 credit

Photos of a user or community: every size VK keeps (up to the original), caption, date, likes, comments, reposts. `album`: all (default), profile (profile photos), wall (wall photos) or a numeric album id. Up to 200 per page for `all`, 1,000 for one album.

ParameterAllowed / rangeDescription
ownerrequired—The user or community: screen name (`durov`, `vk`), numeric id (users positive `1`, communities negative `-22822305`), `id1` / `club22822305` / `public22822305` / `event…`, or any vk.com / vk.ru link to the page.
album = alloptional—all (default), profile, wall, or an album id.
page = 1optional1–Page, 1-based.
per_page = 30optional1–1000Photos per page, 1-1000 (VK's own maximum for this list).
offsetoptional0–Start at this position instead of `page` (0-based).
lang = ruoptionalru · en · uk · be · de · es · it · fiLanguage VK answers in: names, city / country names and labels as VK shows them in that interface language — ru (default, VK's own), en (Latin transliteration: `Pavel Durov`, `Saint Petersburg`), uk, be, de, es, it, fi.
Try in playground →
post/vk/v1/articles1 credit

Articles (long reads) a user or community published: title, subtitle, lead, link, date, views, shares, reading time, cover image. Up to 50 per page.

ParameterAllowed / rangeDescription
ownerrequired—The user or community: screen name (`durov`, `vk`), numeric id (users positive `1`, communities negative `-22822305`), `id1` / `club22822305` / `public22822305` / `event…`, or any vk.com / vk.ru link to the page.
page = 1optional1–Page, 1-based.
per_page = 20optional1–50Articles per page, 1-50 (VK's own maximum for this list).
offsetoptional0–Start at this position instead of `page` (0-based).
lang = ruoptionalru · en · uk · be · de · es · it · fiLanguage VK answers in: names, city / country names and labels as VK shows them in that interface language — ru (default, VK's own), en (Latin transliteration: `Pavel Durov`, `Saint Petersburg`), uk, be, de, es, it, fi.
Try in playground →
post/vk/v1/article1 credit

One article's full text from its page (vk.com/@<slug>): title, description, author, publish and modify dates, the body as headings / paragraphs / list items / quotes, plain text, word count, images and links. Views and shares are in `articles`.

ParameterAllowed / rangeDescription
articlerequired—The article slug (`vk-verify`), `@vk-verify` or its link.
Try in playground →
post/vk/v1/board_topics1 credit

A community's discussion board topics: title, author, created / updated dates, comment count, closed / pinned flags and the topic's opening message in full. Up to 100 per page.

ParameterAllowed / rangeDescription
communityrequired—The community (group, public page or event): screen name (`vk`), id (`22822305` or `-22822305`), `club22822305` / `public22822305` / `event…`, or a vk.com / vk.ru link.
order = updatedoptionalupdated · created · updated_asc · created_ascupdated (default, last activity first), created (newest topic first), updated_asc, created_asc.
page = 1optional1–Page, 1-based.
per_page = 20optional1–100Topics per page, 1-100 (VK's own maximum for this list).
offsetoptional0–Start at this position instead of `page` (0-based).
lang = ruoptionalru · en · uk · be · de · es · it · fiLanguage VK answers in: names, city / country names and labels as VK shows them in that interface language — ru (default, VK's own), en (Latin transliteration: `Pavel Durov`, `Saint Petersburg`), uk, be, de, es, it, fi.
Try in playground →
post/vk/v1/board_comments1 credit

Messages in one discussion-board topic: author, date, text, likes, attachments. Up to 100 per page, oldest or newest first.

ParameterAllowed / rangeDescription
communityrequired—The community (group, public page or event): screen name (`vk`), id (`22822305` or `-22822305`), `club22822305` / `public22822305` / `event…`, or a vk.com / vk.ru link.
topic_idrequired—Topic id (from `board_topics`) or the topic link (vk.com/topic-1_35487172).
sort = oldestoptionaloldest · newestoldest (default, the site's order) or newest first.
page = 1optional1–Page, 1-based.
per_page = 20optional1–100Messages per page, 1-100 (VK's own maximum for this list).
offsetoptional0–Start at this position instead of `page` (0-based).
lang = ruoptionalru · en · uk · be · de · es · it · fiLanguage VK answers in: names, city / country names and labels as VK shows them in that interface language — ru (default, VK's own), en (Latin transliteration: `Pavel Durov`, `Saint Petersburg`), uk, be, de, es, it, fi.
Try in playground →
post/vk/v1/market1 credit

A community shop's products: title, description, price and old price (with currency and VK's printed price), category path, availability, photos, likes, reposts, SKU / dimensions / weight when published, ratings. Optional shop album (`album_id`, from `market_albums`). Up to 200 per page.

ParameterAllowed / rangeDescription
communityrequired—The community (group, public page or event): screen name (`vk`), id (`22822305` or `-22822305`), `club22822305` / `public22822305` / `event…`, or a vk.com / vk.ru link.
album_idoptional—Only this shop album (collection).
page = 1optional1–Page, 1-based.
per_page = 10optional1–200Products per page, 1-200 (VK's own maximum for this list).
offsetoptional0–Start at this position instead of `page` (0-based).
lang = ruoptionalru · en · uk · be · de · es · it · fiLanguage VK answers in: names, city / country names and labels as VK shows them in that interface language — ru (default, VK's own), en (Latin transliteration: `Pavel Durov`, `Saint Petersburg`), uk, be, de, es, it, fi.
Try in playground →
post/vk/v1/market_item1 credit

One shop product in full (same fields as `market`, plus every photo).

ParameterAllowed / rangeDescription
itemrequired—`<owner_id>_<item_id>` (`-214324786_13083330`) or the product link (…?w=product-214324786_13083330).
lang = ruoptionalru · en · uk · be · de · es · it · fiLanguage VK answers in: names, city / country names and labels as VK shows them in that interface language — ru (default, VK's own), en (Latin transliteration: `Pavel Durov`, `Saint Petersburg`), uk, be, de, es, it, fi.
Try in playground →
post/vk/v1/market_albums1 credit

A community shop's albums (collections): id, title, number of products, update date, cover.

ParameterAllowed / rangeDescription
communityrequired—The community (group, public page or event): screen name (`vk`), id (`22822305` or `-22822305`), `club22822305` / `public22822305` / `event…`, or a vk.com / vk.ru link.
page = 1optional1–Page, 1-based.
per_page = 50optional1–100Albums per page, 1-100 (VK's own maximum for this list).
offsetoptional0–Start at this position instead of `page` (0-based).
lang = ruoptionalru · en · uk · be · de · es · it · fiLanguage VK answers in: names, city / country names and labels as VK shows them in that interface language — ru (default, VK's own), en (Latin transliteration: `Pavel Durov`, `Saint Petersburg`), uk, be, de, es, it, fi.
Try in playground →
post/vk/v1/cities1 credit

VK's city directory: city ids with region and district, for the `city_id` filter of `community_search`. Without `query` VK returns the country's main cities.

ParameterAllowed / rangeDescription
queryoptional—Start of a city name in any spelling (`Казань`, `Kazan`).
country_id = 1optional—VK country id (1 Russia, 2 Ukraine, 3 Belarus, 4 Kazakhstan …); default 1.
per_page = 20optional1–1000Cities per page, 1-1000.
offsetoptional0–Start position (0-based).
lang = ruoptionalru · en · uk · be · de · es · it · fiLanguage VK answers in: names, city / country names and labels as VK shows them in that interface language — ru (default, VK's own), en (Latin transliteration: `Pavel Durov`, `Saint Petersburg`), uk, be, de, es, it, fi.
Try in playground →
post/vk/v1/resolve1 credit

What a VK address points to: a screen name or link → its type (user, group, page, event, application) and numeric id.

ParameterAllowed / rangeDescription
namerequired—Screen name or link (`durov`, `vk.com/vk`).
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.

Comparing scraping APIs?ReefAPI vs Apify