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.
🤖 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.
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.
| Field | What 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_id | VK'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_at | UTC 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, mentions | text 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 rows | Follower 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.
Real request and response JSON
Captured from the indexed primary action, user, on .
{
"method": "POST",
"url": "https://api.reefapi.com/vk/v1/user",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"user": "durov"
}
}{
"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"
}
}What the VK (VKontakte) API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| user | 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`. | Social-listening tools call user to get a VK user's public profile. | user, lang |
| community | 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`. | Creator and influencer platforms call community to get a VK community's (group, public page or event) public profile. | community, lang |
| community_addresses | Every 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_members | 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. | Audience analysts call community_members to get the member preview VK shows logged-out visitors. | community, lang |
| wall | 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). | 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_search | Search 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, ... |
| post | 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). | Brand-monitoring teams call post to get one wall post with everything VK publishes on it. | post, lang |
| post_comments | 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. | Audience analysts call post_comments to get comments on a wall post. | post, sort, comment_id, replies_per_comment, page, ... |
| followers | 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). | Social-listening tools call followers to get a user's followers (subscribers who are not friends). | user, page, per_page, offset, lang |
| friends | 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. | 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 |
| subscriptions | The 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 |
| videos | 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. | Audience analysts call videos to get videos uploaded to or added by a user or community. | owner, playlist_id, page, per_page, offset, ... |
| video | 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. | Social-listening tools call video to get one video or clip in full. | video, lang |
| video_comments | Comments 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_playlists | 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`. | Brand-monitoring teams call video_playlists to get a user's or community's video playlists. | owner, page, per_page, offset, lang |
| video_search | Search 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, ... |
| clips | 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`. | Social-listening tools call clips to get a user's or community's clips (VK short videos). | owner, per_page, cursor, lang |
| photos | 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. | Creator and influencer platforms call photos to get photos of a user or community. | owner, album, page, per_page, offset, ... |
| articles | Articles (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 |
| article | 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`. | Audience analysts call article to get one article's full text from its page (vk.com/@<slug>). | article |
| community_search | Search 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_topics | 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. | Creator and influencer platforms call board_topics to get a community's discussion board topics. | community, order, page, per_page, offset, ... |
| board_comments | Messages 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, ... |
| market | 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. | Audience analysts call market to get a community shop's products. | community, album_id, page, per_page, offset, ... |
| market_item | One 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_albums | A 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 |
| cities | 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. | Brand-monitoring teams call cities to get vK's city directory. | query, country_id, per_page, offset, lang |
| resolve | What 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 |
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"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/vk/v1/user",
headers={"x-api-key": REEF_KEY},
json={
"user": "durov"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/vk/v1/user", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"user": "durov"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.vk.user with {"user":"durov"}.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.
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.