VK Scraper - VKontakte Social Data Extractor

Extract social data from VK (VKontakte), Russia's largest social network, through VK's own official API. Five modes cover the data researchers and analysts need most: user profiles, wall posts, group members, group posts, and user search.

Features

• User Profiles — demographics, location, occupation, follower/friend counts, verification status
• User Posts (Wall) — post text, publication date, likes/comments/reposts/views, attachments
• Group Members — member profiles for any public VK group or page
• Group Posts — a community's wall content with the same engagement metrics as user posts
• User Search — find VK users by query, with optional city/country filters
• Structured, consistent output across all five modes — one dataset schema, every field present (null where a mode doesn't produce it)

Before You Start: VK API Access Token

This actor calls VK's official API directly, so it needs your own VK API access token:

1. Go to dev.vk.com and sign in with your VK account.
2. Create an app (Settings → My apps → Create app).
3. Generate an access token for that app with the permissions you need (reading profiles, walls, and groups generally only needs the default scope).
4. Paste the token into the VK API Access Token field when you run this actor.

Your token is only ever used to call VK's API on your behalf for the run you start — it is never stored or reused by us.

Without a token the run still finishes, but it returns no records and the log tells you the token is missing.

Input

Extract user profiles

{
  "mode": "profiles",
  "userIds": ["1", "durov"],
  "vkAccessToken": "YOUR_VK_ACCESS_TOKEN",
  "maxItems": 100
}

Extract a user's wall posts

{
  "mode": "posts",
  "userIds": ["durov"],
  "vkAccessToken": "YOUR_VK_ACCESS_TOKEN",
  "maxItems": 50
}

Extract a group's members

{
  "mode": "group_members",
  "groupIds": ["apiclub"],
  "vkAccessToken": "YOUR_VK_ACCESS_TOKEN",
  "maxItems": 200
}

Extract a group's wall posts

{
  "mode": "group_posts",
  "groupIds": ["apiclub"],
  "vkAccessToken": "YOUR_VK_ACCESS_TOKEN",
  "maxItems": 50
}

Search for users

{
  "mode": "search",
  "searchQuery": "software engineer",
  "searchCity": "Moscow",
  "vkAccessToken": "YOUR_VK_ACCESS_TOKEN",
  "maxItems": 100
}

User IDs and group IDs both accept either the numeric VK id or the screen name (e.g. 1 or durov).

Output Fields

Every record uses the same flat shape; fields that don't apply to the active mode are null.

{
  "user_id": 1,
  "first_name": "Pavel",
  "last_name": "Durov",
  "screen_name": "durov",
  "profile_url": "https://vk.com/durov",
  "photo_url": "https://sun1-xx.userapi.com/...",
  "city": "Dubai",
  "country": "United Arab Emirates",
  "sex": "male",
  "birth_date": "10.9",
  "occupation": null,
  "university": null,
  "followers_count": 1300000,
  "friends_count": 0,
  "is_verified": true,
  "last_seen": "2026-03-15T14:30:00.000Z",
  "post_id": null,
  "post_text": null,
  "post_date": null,
  "likes_count": null,
  "comments_count": null,
  "reposts_count": null,
  "views_count": null,
  "attachments": null,
  "group_id": null,
  "group_name": null,
  "group_url": null,
  "group_type": null,
  "members_count": null,
  "group_description": null
}

Field reference:

Field	Description
user_id	VK user ID
first_name / last_name	User's name
screen_name	VK username
profile_url	VK profile URL
photo_url	Profile photo URL
city / country	User's location
sex	male / female
birth_date	Birth date as reported by VK
occupation	Job title or university
university	University name
followers_count / friends_count	Social graph size
is_verified	Verified-account flag
last_seen	Last activity timestamp
post_id / post_text / post_date	Wall post identity and content
likes_count / comments_count / reposts_count / views_count	Post engagement metrics
attachments	Post attachments (photos, videos, links)
group_id / group_name / group_url / group_type	Group identity
members_count / group_description	Group size and description

FAQ

Do I need my own VK account?

Yes. VK's API requires every caller to authenticate with their own access token — see Before You Start above.

What's the difference between Group Members and Group Posts?

Group Members returns the profiles of people who belong to a group. Group Posts returns the group's own wall content (posts the group or page has published).

Can I use a numeric ID or a screen name?

Either. userIds and groupIds both accept numeric VK IDs or screen names, mixed freely in the same list.

How does pricing work?

You're charged per record returned, regardless of mode.