# VK API — VKontakte profiles, communities, posts, comments, followers, videos, photos and search (vk.com / vk.ru)

> 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`.
> ReefAPI engine `vk` · 28 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/vk/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/vk/v1/user — 1 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`.

**Parameters:**
- `user` (string, required) — The user: screen name (`durov`), numeric id (`1`), `id1`, or a vk.com / vk.ru profile link.
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** id, screen_name, name, first_name, last_name, url, photo, verified, is_closed, followers_count, sex, bdate, city, country, online, last_seen, status, about, site, home_town, relation, occupation, career[], universities[], schools[], military[], relatives[], personal{}, interests, activities, music, movies, tv, books, games, quotes, connections, photo_id, photos{}, cover, trending, is_nft, is_dead, wall_default

**Example request body:**
```json
{
  "user": "durov"
}
```

### POST https://api.reefapi.com/vk/v1/community — 1 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`.

**Parameters:**
- `community` (string, required) — 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` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** id, owner_id, screen_name, name, community_type, url, photo, verified, trust_mark, is_closed, members_count, members_count_text, activity, status, description, site, phone, contacts[]{user_id, user, description, phone, email}, links[]{url, name, description}, main_address{}, addresses_count, counts{wall, videos, short_videos, articles, addresses, …}, menu[], cover_images[], photos{}, age_limits, age_mark, start_date, finish_date, city, country, place, market{}, fixed_post_id, wiki_page, wall, is_business, category, rating, videos_count, ban_info

**Example request body:**
```json
{
  "community": "vk"
}
```

### POST https://api.reefapi.com/vk/v1/community_addresses — 1 credit
Every address a community publishes (shops, offices, venues): title, street address, city, country, metro, coordinates, phone, opening hours and open-now status.

**Parameters:**
- `community` (string, required) — 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` (integer, optional, default 1) — Page, 1-based.
- `per_page` (integer, optional, default 100) — Addresses per page, 1-100 (VK's own maximum for this list).
- `offset` (integer, optional) — Start at this position instead of `page` (0-based).
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** community{id}, total, page, per_page, has_more, rows[]{id, title, address, additional_address, city, country, metro_station, latitude, longitude, phone, time_offset, timetable, open_status}

**Example request body:**
```json
{
  "community": "vk"
}
```

### POST https://api.reefapi.com/vk/v1/community_members — 1 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.

**Parameters:**
- `community` (string, required) — 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` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** community{id}, total, preview_limit (8), rows[]{type, id, owner_id, screen_name, name, first_name, last_name, url, photo, verified, is_closed, deactivated, sex, city{id, name}, country{id, name}, followers_count, online, last_seen{at, platform}, bdate}

**Example request body:**
```json
{
  "community": "vk"
}
```

### POST https://api.reefapi.com/vk/v1/wall — 1 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).

**Parameters:**
- `owner` (string, required) — 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` (enum, optional, default "all") — all (default), owner (the owner's own posts) or others (posts by others). [one of: all, owner, others]
- `page` (integer, optional, default 1) — Page, 1-based.
- `per_page` (integer, optional, default 20) — Posts per page, 1-100 (VK's own maximum for this list).
- `offset` (integer, optional) — Start at this position instead of `page` (0-based).
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** owner, total, page, per_page, offset, has_more, filter, rows[]{id, owner_id, post_id, url, from_id, signer_id, author (user or community card), owner, published_at, published_at_unix, edited_at, post_type, is_pinned, marked_as_ads, text, text_raw, mentions[], likes, reactions_total, reactions[]{id, title, count}, comments_count, comments_open, reposts, views, attachments[]{type, photo|video|link|poll|doc|audio|article|market_item|…}, copy_history[] (reposted posts, same shape), geo, source, copyright, is_donut}

**Example request body:**
```json
{
  "owner": "vk",
  "per_page": 10
}
```

### POST https://api.reefapi.com/vk/v1/wall_search — 1 credit
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.

**Parameters:**
- `owner` (string, required) — 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.
- `query` (string, required) — Word or phrase (`Telegram`, `#news`).
- `owners_only` (boolean, optional, default true) — Only the owner's own posts (default true).
- `page` (integer, optional, default 1) — Page, 1-based.
- `per_page` (integer, optional, default 20) — Posts per page, 1-100 (VK's own maximum for this list).
- `offset` (integer, optional) — Start at this position instead of `page` (0-based).
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** owner, query, page, per_page, offset, has_more, rows[]{id, owner_id, post_id, url, from_id, signer_id, author (user or community card), owner, published_at, published_at_unix, edited_at, post_type, is_pinned, marked_as_ads, text, text_raw, mentions[], likes, reactions_total, reactions[]{id, title, count}, comments_count, comments_open, reposts, views, attachments[]{type, photo|video|link|poll|doc|audio|article|market_item|…}, copy_history[] (reposted posts, same shape), geo, source, copyright, is_donut}

**Example request body:**
```json
{
  "owner": "vk",
  "query": "music"
}
```

### POST https://api.reefapi.com/vk/v1/post — 1 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).

**Parameters:**
- `post` (string, required) — The post: `<owner_id>_<post_id>` (`-22822305_1738794`, `1_2442097`) or its link (`https://vk.com/wall-22822305_1738794`, also `?w=wall…` links).
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** {id, owner_id, post_id, url, from_id, signer_id, author (user or community card), owner, published_at, published_at_unix, edited_at, post_type, is_pinned, marked_as_ads, text, text_raw, mentions[], likes, reactions_total, reactions[]{id, title, count}, comments_count, comments_open, reposts, views, attachments[]{type, photo|video|link|poll|doc|audio|article|market_item|…}, copy_history[] (reposted posts, same shape), geo, source, copyright, is_donut}

**Example request body:**
```json
{
  "post": "-22822305_1738794"
}
```

### POST https://api.reefapi.com/vk/v1/post_comments — 1 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.

**Parameters:**
- `post` (string, required) — The post: `<owner_id>_<post_id>` (`-22822305_1738794`, `1_2442097`) or its link (`https://vk.com/wall-22822305_1738794`, also `?w=wall…` links).
- `sort` (enum, optional, default "oldest") — oldest (default, the site's order) or newest first. [one of: oldest, newest]
- `comment_id` (integer, optional) — Return the replies of this comment instead of the top level.
- `replies_per_comment` (integer, optional, default 10) — Replies included inline under each comment, 0-10 (default 10).
- `page` (integer, optional, default 1) — Page, 1-based.
- `per_page` (integer, optional, default 20) — Comments per page, 1-100 (VK's own maximum for this list).
- `offset` (integer, optional) — Start at this position instead of `page` (0-based).
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** post{owner_id, id, url}, total, total_with_replies, page, per_page, offset, has_more, sort, rows[]{id, from_id, author, owner_id, post_id, posted_at, posted_at_unix, text, text_raw, mentions[], likes, reply_to_user, reply_to_comment, parents_stack[], deleted, attachments[], replies_count, replies[] (same shape)}

**Example request body:**
```json
{
  "post": "-22822305_1738794"
}
```

### POST https://api.reefapi.com/vk/v1/followers — 1 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).

**Parameters:**
- `user` (string, required) — The user: screen name (`durov`), numeric id (`1`), `id1`, or a vk.com / vk.ru profile link.
- `page` (integer, optional, default 1) — Page, 1-based.
- `per_page` (integer, optional, default 100) — Followers per page, 1-1000 (VK's own maximum for this list).
- `offset` (integer, optional) — Start at this position instead of `page` (0-based).
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** user{id}, total, page, per_page, offset, has_more, rows[]{type, id, owner_id, screen_name, name, first_name, last_name, url, photo, verified, is_closed, deactivated, sex, city{id, name}, country{id, name}, followers_count, online, last_seen{at, platform}, bdate}

**Example request body:**
```json
{
  "user": "durov",
  "per_page": 50
}
```

### POST https://api.reefapi.com/vk/v1/friends — 1 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.

**Parameters:**
- `user` (string, required) — The user: screen name (`durov`), numeric id (`1`), `id1`, or a vk.com / vk.ru profile link.
- `page` (integer, optional, default 1) — Page, 1-based.
- `per_page` (integer, optional, default 100) — Friends per page, 1-1000 (VK's own maximum for this list).
- `offset` (integer, optional) — Start at this position instead of `page` (0-based).
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** user{id}, total, page, per_page, offset, has_more, rows[]{type, id, owner_id, screen_name, name, first_name, last_name, url, photo, verified, is_closed, deactivated, sex, city{id, name}, country{id, name}, followers_count, online, last_seen{at, platform}, bdate}

**Example request body:**
```json
{
  "user": "durov"
}
```

### POST https://api.reefapi.com/vk/v1/subscriptions — 1 credit
The public pages, communities and people a user follows: name, link, photo, type, members count, activity. Up to 200 per page.

**Parameters:**
- `user` (string, required) — The user: screen name (`durov`), numeric id (`1`), `id1`, or a vk.com / vk.ru profile link.
- `page` (integer, optional, default 1) — Page, 1-based.
- `per_page` (integer, optional, default 50) — Subscriptions per page, 1-200 (VK's own maximum for this list).
- `offset` (integer, optional) — Start at this position instead of `page` (0-based).
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** user{id}, total, page, per_page, offset, has_more, rows[] (community card or user card)

**Example request body:**
```json
{
  "user": "durov"
}
```

### POST https://api.reefapi.com/vk/v1/videos — 1 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.

**Parameters:**
- `owner` (string, required) — 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_id` (integer, optional) — Only this playlist (album) id.
- `page` (integer, optional, default 1) — Page, 1-based.
- `per_page` (integer, optional, default 20) — Videos per page, 1-200 (VK's own maximum for this list).
- `offset` (integer, optional) — Start at this position instead of `page` (0-based).
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** owner, total, page, per_page, offset, has_more, rows[]{id, owner_id, video_id, type, is_clip, url, title, description, duration_seconds, published_at, added_at, views, local_views, likes, reposts, comments, width, height, thumbnail, images[], first_frame[], player_url, platform, is_live, live_status, access_key, wall_post_id, files{mp4_144 … mp4_2160, hls, dash_*} (temporary signed links), trailer{}, subtitles[]{lang, title, is_auto, url}, share_url, direct_url, timeline_thumbs{}}

**Example request body:**
```json
{
  "owner": "vk"
}
```

### POST https://api.reefapi.com/vk/v1/video — 1 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.

**Parameters:**
- `video` (string, required) — The video or clip: `<owner_id>_<video_id>` (`-22822305_456243492`) or its link (vk.com/video…, vk.com/clip…, vkvideo.ru/video…).
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** {id, owner_id, video_id, type, is_clip, url, title, description, duration_seconds, published_at, added_at, views, local_views, likes, reposts, comments, width, height, thumbnail, images[], first_frame[], player_url, platform, is_live, live_status, access_key, wall_post_id, files{mp4_144 … mp4_2160, hls, dash_*} (temporary signed links), trailer{}, subtitles[]{lang, title, is_auto, url}, share_url, direct_url, timeline_thumbs{}} + owner

**Example request body:**
```json
{
  "video": "-22822305_456243492"
}
```

### POST https://api.reefapi.com/vk/v1/video_comments — 1 credit
Comments on a video or clip: author, date, text, likes, reply count; oldest or newest first, up to 100 per page.

**Parameters:**
- `video` (string, required) — The video or clip: `<owner_id>_<video_id>` (`-22822305_456243492`) or its link (vk.com/video…, vk.com/clip…, vkvideo.ru/video…).
- `sort` (enum, optional, default "oldest") — oldest (default, the site's order) or newest first. [one of: oldest, newest]
- `page` (integer, optional, default 1) — Page, 1-based.
- `per_page` (integer, optional, default 20) — Comments per page, 1-100 (VK's own maximum for this list).
- `offset` (integer, optional) — Start at this position instead of `page` (0-based).
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** video{owner_id, id, url}, total, total_with_replies, page, has_more, rows[]{id, from_id, author, owner_id, post_id, posted_at, posted_at_unix, text, text_raw, mentions[], likes, reply_to_user, reply_to_comment, parents_stack[], deleted, attachments[], replies_count, replies[] (same shape)}

**Example request body:**
```json
{
  "video": "-22822305_456243492"
}
```

### POST https://api.reefapi.com/vk/v1/video_playlists — 1 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`.

**Parameters:**
- `owner` (string, required) — 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` (integer, optional, default 1) — Page, 1-based.
- `per_page` (integer, optional, default 50) — Playlists per page, 1-100 (VK's own maximum for this list).
- `offset` (integer, optional) — Start at this position instead of `page` (0-based).
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** owner, total, page, per_page, has_more, rows[]{id, owner_id, title, count, updated_at, first_video_id, url, image}

**Example request body:**
```json
{
  "owner": "vk"
}
```

### POST https://api.reefapi.com/vk/v1/video_search — 1 credit
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`.

**Parameters:**
- `query` (string, optional) — What to search for (`футбол`, `music`). Needed unless `cursor` is given.
- `sort` (enum, optional, default "relevance") — relevance (default), newest or longest. [one of: relevance, newest, longest]
- `content_type` (enum, optional, default "all") — all (default), video, clip, live (broadcasts) or channel (authors). [one of: all, video, clip, live, channel]
- `duration` (enum, optional, default "any") — any (default), short or long. [one of: any, short, long]
- `hd` (boolean, optional) — Only HD videos.
- `cursor` (string, optional) — The `next_cursor` of the previous page; the query and filters ride inside it.
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** query, filters{}, page, has_more, next_cursor, dropped_repeats, rows[]{id, owner_id, video_id, type, is_clip, url, title, description, duration_seconds, published_at, added_at, views, local_views, likes, reposts, comments, width, height, thumbnail, images[], first_frame[], player_url, platform, is_live, live_status, access_key, wall_post_id, files{mp4_144 … mp4_2160, hls, dash_*} (temporary signed links), trailer{}, subtitles[]{lang, title, is_auto, url}, share_url, direct_url, timeline_thumbs{}} + owner + marks[], playlists[]

**Example request body:**
```json
{
  "query": "футбол"
}
```

### POST https://api.reefapi.com/vk/v1/clips — 1 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`.

**Parameters:**
- `owner` (string, required) — 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` (integer, optional, default 20) — Clips per page, 1-100.
- `cursor` (string, optional) — The `next_cursor` of the previous page; the query and filters ride inside it.
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** owner, total, page, has_more, next_cursor, rows[]{id, owner_id, video_id, type, is_clip, url, title, description, duration_seconds, published_at, added_at, views, local_views, likes, reposts, comments, width, height, thumbnail, images[], first_frame[], player_url, platform, is_live, live_status, access_key, wall_post_id, files{mp4_144 … mp4_2160, hls, dash_*} (temporary signed links), trailer{}, subtitles[]{lang, title, is_auto, url}, share_url, direct_url, timeline_thumbs{}}

**Example request body:**
```json
{
  "owner": "vk"
}
```

### POST https://api.reefapi.com/vk/v1/photos — 1 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.

**Parameters:**
- `owner` (string, required) — 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` (string, optional, default "all") — all (default), profile, wall, or an album id.
- `page` (integer, optional, default 1) — Page, 1-based.
- `per_page` (integer, optional, default 30) — Photos per page, 1-1000 (VK's own maximum for this list).
- `offset` (integer, optional) — Start at this position instead of `page` (0-based).
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** owner, album, total, page, per_page, offset, has_more, rows[]{id, owner_id, photo_id, album_id, user_id, url, image_url, width, height, text, posted_at, likes, comments, reposts, tags, sizes[]{type, width, height, url}}

**Example request body:**
```json
{
  "owner": "vk"
}
```

### POST https://api.reefapi.com/vk/v1/articles — 1 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.

**Parameters:**
- `owner` (string, required) — 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` (integer, optional, default 1) — Page, 1-based.
- `per_page` (integer, optional, default 20) — Articles per page, 1-50 (VK's own maximum for this list).
- `offset` (integer, optional) — Start at this position instead of `page` (0-based).
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** owner, total, page, per_page, has_more, rows[]{id, owner_id, owner_name, title, subtitle, lead, url, slug, published_at, views, shares, time_to_read_minutes, image}

**Example request body:**
```json
{
  "owner": "vk"
}
```

### POST https://api.reefapi.com/vk/v1/article — 1 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`.

**Parameters:**
- `article` (string, required) — The article slug (`vk-verify`), `@vk-verify` or its link.

**Returns:** id, owner_id, article_id, url, slug, title, description, author{name, type}, published_at, modified_at, blocks[]{type, text}, text, word_count, images[], links[]{url, text}

**Example request body:**
```json
{
  "article": "vk-verify"
}
```

### POST https://api.reefapi.com/vk/v1/community_search — 1 credit
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`.

**Parameters:**
- `query` (string, optional) — Keyword (`фитнес`, `music`). Needed unless `cursor` is given.
- `type` (enum, optional, default "all") — all (default), group, page or event. [one of: all, group, page, event]
- `sort` (enum, optional, default "relevance") — relevance (default), popularity or members. [one of: relevance, popularity, members]
- `city_id` (integer, optional) — VK city id (`1` Moscow, `2` Saint Petersburg, `60` Kazan; look one up with `cities`).
- `country_id` (integer, optional) — VK country id (`1` Russia, `2` Ukraine, `3` Belarus, `4` Kazakhstan).
- `cursor` (string, optional) — The `next_cursor` of the previous page; the query and filters ride inside it.
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** query, filters{}, page, has_more, next_cursor, dropped_nearby, rows[]{type, community_type (group|page|event), id, owner_id, screen_name, name, url, photo, verified, is_closed (open|closed|private), deactivated, members_count, members_count_text, activity, trust_mark, is_government_organization}

**Example request body:**
```json
{
  "query": "music"
}
```

### POST https://api.reefapi.com/vk/v1/board_topics — 1 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.

**Parameters:**
- `community` (string, required) — 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` (enum, optional, default "updated") — updated (default, last activity first), created (newest topic first), updated_asc, created_asc. [one of: updated, created, updated_asc, created_asc]
- `page` (integer, optional, default 1) — Page, 1-based.
- `per_page` (integer, optional, default 20) — Topics per page, 1-100 (VK's own maximum for this list).
- `offset` (integer, optional) — Start at this position instead of `page` (0-based).
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** community{id}, total, page, per_page, has_more, rows[]{id, title, created_at, created_by, created_by_owner, updated_at, updated_by, comments, is_closed, is_fixed, first_comment}

**Example request body:**
```json
{
  "community": "vk"
}
```

### POST https://api.reefapi.com/vk/v1/board_comments — 1 credit
Messages in one discussion-board topic: author, date, text, likes, attachments. Up to 100 per page, oldest or newest first.

**Parameters:**
- `community` (string, required) — 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_id` (string, required) — Topic id (from `board_topics`) or the topic link (vk.com/topic-1_35487172).
- `sort` (enum, optional, default "oldest") — oldest (default, the site's order) or newest first. [one of: oldest, newest]
- `page` (integer, optional, default 1) — Page, 1-based.
- `per_page` (integer, optional, default 20) — Messages per page, 1-100 (VK's own maximum for this list).
- `offset` (integer, optional) — Start at this position instead of `page` (0-based).
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** community{id}, topic_id, total, page, per_page, has_more, rows[]{id, from_id, author, posted_at, text, text_raw, mentions[], likes, attachments[]}

**Example request body:**
```json
{
  "community": "vk",
  "topic_id": 35487172
}
```

### POST https://api.reefapi.com/vk/v1/market — 1 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.

**Parameters:**
- `community` (string, required) — 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_id` (integer, optional) — Only this shop album (collection).
- `page` (integer, optional, default 1) — Page, 1-based.
- `per_page` (integer, optional, default 10) — Products per page, 1-200 (VK's own maximum for this list).
- `offset` (integer, optional) — Start at this position instead of `page` (0-based).
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** community{id}, total, page, per_page, has_more, rows[]{id, owner_id, item_id, url, title, description, price, old_price, currency, price_text, category[], availability, thumb, photos[], likes, reposts, sku, dimensions, weight, rating, labels, created_at}

**Example request body:**
```json
{
  "community": "vk"
}
```

### POST https://api.reefapi.com/vk/v1/market_item — 1 credit
One shop product in full (same fields as `market`, plus every photo).

**Parameters:**
- `item` (string, required) — `<owner_id>_<item_id>` (`-214324786_13083330`) or the product link (…?w=product-214324786_13083330).
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** id, owner_id, item_id, url, title, description, price, old_price, currency, price_text, category[], availability, photos[], likes, reposts, sku, dimensions, weight, rating

**Example request body:**
```json
{
  "item": "-214324786_13083330"
}
```

### POST https://api.reefapi.com/vk/v1/market_albums — 1 credit
A community shop's albums (collections): id, title, number of products, update date, cover.

**Parameters:**
- `community` (string, required) — 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` (integer, optional, default 1) — Page, 1-based.
- `per_page` (integer, optional, default 50) — Albums per page, 1-100 (VK's own maximum for this list).
- `offset` (integer, optional) — Start at this position instead of `page` (0-based).
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** community{id}, total, page, has_more, rows[]{id, owner_id, title, count, updated_at, is_main, is_hidden, image}

**Example request body:**
```json
{
  "community": "vk"
}
```

### POST https://api.reefapi.com/vk/v1/cities — 1 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.

**Parameters:**
- `query` (string, optional) — Start of a city name in any spelling (`Казань`, `Kazan`).
- `country_id` (integer, optional, default 1) — VK country id (1 Russia, 2 Ukraine, 3 Belarus, 4 Kazakhstan …); default 1.
- `per_page` (integer, optional, default 20) — Cities per page, 1-1000.
- `offset` (integer, optional) — Start position (0-based).
- `lang` (enum, optional, default "ru") — Language 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. [one of: ru, en, uk, be, de, es, it, fi]

**Returns:** total, rows[]{id, name, area, region, important}

**Example request body:**
```json
{
  "query": "Казань"
}
```

### POST https://api.reefapi.com/vk/v1/resolve — 1 credit
What a VK address points to: a screen name or link → its type (user, group, page, event, application) and numeric id.

**Parameters:**
- `name` (string, required) — Screen name or link (`durov`, `vk.com/vk`).

**Returns:** name, type, id, owner_id, url

**Example request body:**
```json
{
  "name": "durov"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=vk
- Human docs page: https://reefapi.com/docs/vk
- Overview page: https://reefapi.com/vk-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
