VK (VKontakte) API

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.

POST/vk/v1/user
Real result, captured Nov 16, 2026
nameyear_fromyear_to
Scuola Elementare Coppino - Falletti di Barolo19901992
Академическая гимназия им. Д. К. Фаддеева СПбГУ1996—
28 active endpoints. Every call is 1 credit.user · community · community_addresses · community_members · wall · wall_search+22 more ↓OpenAPI 3.0 spec ↗

1 credit per call≈ $1/1,000 calls1,000 free credits, no card

Get a free API key
Try it live

Run 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

View docs ↗

A VK user's public profile with follower count

1 credit1 required · 0 optional
POST/vk/v1/user
idle
// 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.

Try every endpoint in the playground

Endpoints

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 cr

    A VK user's public profile.

    required
    user
    optional
    lang
  • community

    1 cr

    A VK community's (group, public page or event) public profile.

    required
    community
    optional
    lang
  • community_addresses

    1 cr

    Every address a community publishes (shops, offices, venues).

    required
    community
    optional
    page, per_page, offset, lang
  • community_members

    1 cr

    The member preview VK shows logged-out visitors.

    required
    community
    optional
    lang
  • wall

    1 cr

    Posts 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 cr

    Search 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 cr

    One wall post with everything VK publishes on it.

    required
    post
    optional
    lang
  • post_comments

    1 cr

    Comments on a wall post.

    required
    post
    optional
    sort, comment_id, replies_per_comment, page, per_page, offset, lang
  • followers

    1 cr

    A user's followers (subscribers who are not friends).

    required
    user
    optional
    page, per_page, offset, lang
  • friends

    1 cr

    A user's friends list when the user shows it publicly.

    required
    user
    optional
    page, per_page, offset, lang
  • subscriptions

    1 cr

    The public pages, communities and people a user follows.

    required
    user
    optional
    page, per_page, offset, lang
  • videos

    1 cr

    Videos uploaded to or added by a user or community.

    required
    owner
    optional
    playlist_id, page, per_page, offset, lang
  • video

    1 cr

    One video or clip in full.

    required
    video
    optional
    lang
  • video_comments

    1 cr

    Comments on a video or clip.

    required
    video
    optional
    sort, page, per_page, offset, lang
  • video_playlists

    1 cr

    A user's or community's video playlists.

    required
    owner
    optional
    page, per_page, offset, lang
  • video_search

    1 cr

    Search VK Video like the site's search box, with its filters.

    required
    —
    optional
    query, sort, content_type, duration, hd, cursor, lang
  • clips

    1 cr

    A user's or community's clips (VK short videos).

    required
    owner
    optional
    per_page, cursor, lang
  • photos

    1 cr

    Photos of a user or community.

    required
    owner
    optional
    album, page, per_page, offset, lang
  • articles

    1 cr

    Articles (long reads) a user or community published.

    required
    owner
    optional
    page, per_page, offset, lang
  • article

    1 cr

    One article's full text from its page (vk.com/@<slug>).

    required
    article
    optional
    —
  • community_search

    1 cr

    Search VK communities like the site's search.

    required
    —
    optional
    query, type, sort, city_id, country_id, cursor, lang
  • board_topics

    1 cr

    A community's discussion board topics.

    required
    community
    optional
    order, page, per_page, offset, lang
  • board_comments

    1 cr

    Messages in one discussion-board topic.

    required
    community, topic_id
    optional
    sort, page, per_page, offset, lang
  • market

    1 cr

    A community shop's products.

    required
    community
    optional
    album_id, page, per_page, offset, lang
  • market_item

    1 cr

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

    required
    item
    optional
    lang
  • market_albums

    1 cr

    A community shop's albums (collections).

    required
    community
    optional
    page, per_page, offset, lang
  • cities

    1 cr

    VK's city directory.

    required
    —
    optional
    query, country_id, per_page, offset, lang
  • resolve

    1 cr

    What 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 it works

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.

Authenticate01
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 694 engines.

Call02
POST /vk/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

Pay03
1 credit per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

Read04
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

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.

01community_search?query=фитнес&city_id=60
GET/vk/v1/community_search?query=фитнес&city_id=60

Fitness communities in Kazan with member counts, type, activity and verified marks, 20 per page; next_cursor continues.

02community?community=<screen_name>
GET/vk/v1/community?community=<screen_name>

Members, description, phone, contacts with e-mail, links, main address and how many posts, videos and clips the community has.

03wall?owner=<screen_name>&per_page=50
GET/vk/v1/wall?owner=<screen_name>&per_page=50

The latest 50 posts with likes, reactions by type, comments, reposts, views and attachments.

04post_comments?post=<post_id>&sort=newest
GET/vk/v1/post_comments?post=<post_id>&sort=newest

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.

request
curl -X POST https://api.reefapi.com/vk/v1/user \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"user":"durov"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "vk",
    "endpoint": "user",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

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.

Coverage

VK coverage, measured

Every number below was read from live vk.com on 2026-11-16.

Profiles and communities

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.

Paging

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).

Filters that bite

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.

Accuracy

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).

Limits

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.

Use cases

What people build with VK (VKontakte)

The jobs this data is most often used for.

01

Monitor Russian and CIS brands, media and public figures: posts, reactions, views and comments on their VK walls.

02

Size an influencer or a community before a campaign: followers or members, post frequency and engagement per post.

03

Collect the comments under a post with their replies for sentiment or moderation analysis.

04

Find communities on a topic in a given city with VK's own community search, then read their contacts and addresses.

28

endpoints

1

credit per call

Pricing

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.

$0.67–$1.50 / 1,000 credits
Full pricing →
  • 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
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

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
curl -X POST https://api.reefapi.com/vk/v1/user \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"user":"durov"}'
python
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"])
FAQ

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.

Same key

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.

Already paying for something else?VK (VKontakte) vs Apify
Contact

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.

0/4000

No account needed · we reply from [email protected]

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.