Every public VK profile, community, post and comment, with its real counters
- endpoints
- 28
- credit per call
- 1
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.
| name | year_from | year_to |
|---|---|---|
| Scuola Elementare Coppino - Falletti di Barolo | 1990 | 1992 |
| Академическая гимназия им. Д. К. Фаддеева СПбГУ | 1996 | — |
1 credit per call≈ $1/1,000 calls1,000 free credits, no card
Get a free API keyRun the call yourself, on the real endpoint
Change a parameter and press Try it. The response on the right is what your code will receive.
VK (VKontakte) API
5 of 28 endpoints, ready to run
A VK user's public profile with follower count
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
What VK (VKontakte) endpoints does ReefAPI ship?
28 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
user
1 crA VK user's public profile.
- required
- user
- optional
- lang
community
1 crA VK community's (group, public page or event) public profile.
- required
- community
- optional
- lang
community_addresses
1 crEvery address a community publishes (shops, offices, venues).
- required
- community
- optional
- page, per_page, offset, lang
community_members
1 crThe member preview VK shows logged-out visitors.
- required
- community
- optional
- lang
wall
1 crPosts on a user's or community's wall, newest first (the pinned post first when there is one).
- required
- owner
- optional
- filter, page, per_page, offset, lang
wall_search
1 crSearch one user's or community's wall for a word or phrase (VK's own in-wall search).
- required
- owner, query
- optional
- owners_only, page, per_page, offset, lang
post
1 crOne wall post with everything VK publishes on it.
- required
- post
- optional
- lang
post_comments
1 crComments on a wall post.
- required
- post
- optional
- sort, comment_id, replies_per_comment, page, per_page, offset, lang
followers
1 crA user's followers (subscribers who are not friends).
- required
- user
- optional
- page, per_page, offset, lang
friends
1 crA user's friends list when the user shows it publicly.
- required
- user
- optional
- page, per_page, offset, lang
subscriptions
1 crThe public pages, communities and people a user follows.
- required
- user
- optional
- page, per_page, offset, lang
videos
1 crVideos uploaded to or added by a user or community.
- required
- owner
- optional
- playlist_id, page, per_page, offset, lang
video
1 crOne video or clip in full.
- required
- video
- optional
- lang
video_comments
1 crComments on a video or clip.
- required
- video
- optional
- sort, page, per_page, offset, lang
video_playlists
1 crA user's or community's video playlists.
- required
- owner
- optional
- page, per_page, offset, lang
video_search
1 crSearch VK Video like the site's search box, with its filters.
- required
- —
- optional
- query, sort, content_type, duration, hd, cursor, lang
clips
1 crA user's or community's clips (VK short videos).
- required
- owner
- optional
- per_page, cursor, lang
photos
1 crPhotos of a user or community.
- required
- owner
- optional
- album, page, per_page, offset, lang
articles
1 crArticles (long reads) a user or community published.
- required
- owner
- optional
- page, per_page, offset, lang
article
1 crOne article's full text from its page (vk.com/@<slug>).
- required
- article
- optional
- —
community_search
1 crSearch VK communities like the site's search.
- required
- —
- optional
- query, type, sort, city_id, country_id, cursor, lang
board_topics
1 crA community's discussion board topics.
- required
- community
- optional
- order, page, per_page, offset, lang
board_comments
1 crMessages in one discussion-board topic.
- required
- community, topic_id
- optional
- sort, page, per_page, offset, lang
market
1 crA community shop's products.
- required
- community
- optional
- album_id, page, per_page, offset, lang
market_item
1 crOne shop product in full (same fields as market, plus every photo).
- required
- item
- optional
- lang
market_albums
1 crA community shop's albums (collections).
- required
- community
- optional
- page, per_page, offset, lang
cities
1 crVK's city directory.
- required
- —
- optional
- query, country_id, per_page, offset, lang
resolve
1 crWhat a VK address points to.
- required
- name
- optional
- —
Every parameter, every allowed value →
Missing a VK (VKontakte) endpoint, or need a source we don't have yet?Contact us real people · same-day reply.How the VK (VKontakte) API works
VK (VKontakte) is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 694 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From a topic to the communities that own it and what their audience says
Search communities with VK's filters, open the ones you want, then read their posts and the comments under them.
Fitness communities in Kazan with member counts, type, activity and verified marks, 20 per page; next_cursor continues.
Members, description, phone, contacts with e-mail, links, main address and how many posts, videos and clips the community has.
The latest 50 posts with likes, reactions by type, comments, reposts, views and attachments.
The comments under one post with authors, likes and up to 10 replies each.
A dated list of the communities on a topic in a city, each with its audience size, contacts and how its posts and comments perform.
curl -X POST https://api.reefapi.com/vk/v1/user \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"user":"durov"}'{
"ok": true,
"data": { … },
"meta": {
"api": "vk",
"endpoint": "user",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}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.
VK coverage, measured
Every number below was read from live vk.com on 2026-11-16.
Every open VK profile, group, public page and event; screen names, numeric ids, id… / club… / public… forms and vk.com, vk.ru and m.vk.com links all resolve to the same record.
Walls to the last post (durov: 1,020 of 1,020), followers to the last follower (4,515,567), friends to the last friend, comments to the last comment; community search up to about 19 pages of 20 (383 different communities for one keyword).
Wall: 7,800 posts → 5,429 by the owner and 2,371 by visitors. Community search by city returned Kazan clubs for city_id 60 and Belarusian ones for country_id 3; sort by members put an 11.1 M-member page first. Video search newest returned only videos from the previous 26 hours, longest only videos over 8 hours, short only videos under 5 minutes.
Follower counts equal to the user's own vk.com page on 7 of 7 profiles; member counts equal on 7 of 7 communities (2 grew by 1-2 members between the two reads); likes, reposts and dates equal on 70 of 70 posts read from the communities' own pages, comments on 69 (one new comment arrived between the two reads).
Community members: the total plus a preview of 8, as VK shows logged-out visitors. No people search and no VK-wide post search (VK answers nothing logged out); search inside one wall works. Old posts carry no view counter. Private profiles return name and photo only.
What people build with VK (VKontakte)
The jobs this data is most often used for.
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.
endpoints
credit per call
What VK (VKontakte) data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
- 1,000 free credits on signup, no card
- One key, all 694 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
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"])Have a question? We got answers.
The questions people actually ask before wiring up VK (VKontakte).
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.
18 Social Media APIs on the same key
One key, one credit pool, one response envelope. If you are pulling VK (VKontakte), you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 693 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-16.