/
VK

VK

Source Vitals

Source Attributes

Description

Source Attributes

Description

Data Collection Method

real-time firehose

Geographic Coverage

primarily Russia & Eastern Europe

Key Use Cases

product & market research; company reputation analysis; influencer identification

Delivery Methods

full stream; filtered stream; search API


Data Dictionary

VK Field

Message Types

Description

VK Field

Message Types

Description

Access

Posts, Shares & Comments

Access level of the message. Always set to 'public'.

ActionTime

Posts & Shares Only

Timestamp for when the user action was taken, including creation, update or deletion of a post, share or comment.

Attachments - Attachment - Comments

Posts & Shares Only

Number of comments for a post or share.

Attachments - Attachment - Date

Posts, Shares & Comments

Creation date of the attached link, video, photo or album.

Attachments - Attachment - Description

Posts, Shares & Comments

Text description of the attached link, video, photo or album.

Attachments - Attachment - Duration

Posts, Shares & Comments

Duration of an attachment video.

Attachments - Attachment - Id

Posts, Shares & Comments

Numeric ID of an attachment photo or video.

Attachments - Attachment - Link - Caption

Posts, Shares & Comments

Caption text for a shared link

Attachments - Attachment - Link - Description

Posts, Shares & Comments

Description of an attached link

Attachments - Attachment - Link - IsExternal

Posts, Shares & Comments

Boolean flag indicating whether a shared link is internal to VK.

Attachments - Attachment - Link - Photo - AlbumId

Posts, Shares & Comments

Photo album ID

Attachments - Attachment - Link - Photo - Date

Posts, Shares & Comments

Photo date in Unix timestamp format

Attachments - Attachment - Link - Photo - Height

Posts, Shares & Comments

Photo height in pixels

Attachments - Attachment - Link - Photo - Id

Posts, Shares & Comments

Numeric photo ID

Attachments - Attachment - Link - Photo - OwnerId

Posts, Shares & Comments

Photo owner ID

Attachments - Attachment - Link - Photo - Photo130

Posts, Shares & Comments

Photo image URL at 130 pixels wide

Attachments - Attachment - Link - Photo - Photo604

Posts, Shares & Comments

Photo image URL at 604 pixels wide

Attachments - Attachment - Link - Photo - Photo75

Posts, Shares & Comments

Photo image URL at 75 pixels wide

Attachments - Attachment - Link - Photo - Text

Posts, Shares & Comments

Text description of a photo image URL

Attachments - Attachment - Link - Photo - Width

Posts, Shares & Comments

Photo width in pixels

Attachments - Attachment - Link - Target

Posts, Shares & Comments

Value is either "internal" or "external" depending on link type.

Attachments - Attachment - Link - Title

Posts, Shares & Comments

Title of an attached link

Attachments - Attachment - Link - Url

Posts, Shares & Comments

Shared link URL

Attachments - Attachment - Title

Posts, Shares & Comments

Title of attached link, video, photo or album

Attachments - Attachment - Type

Posts, Shares & Comments

Attachment type such as link, video, photo, album, market, note*, photos_list, or podcast (*doesn't appear often in stream)

Attachments - Attachment - Views

Posts, Shares & Comments

Number of views of an attached video or photo

AuthorId

Posts, Shares & Comments

Numeric VK author ID

Author - Platform

Posts, Shares & Comments

platform (integer) – content creation platform. Possible values:
1 – mobile web version;
2 – iPhone;
3 – iPad;
4 – Android;
5 – Windows Phone;
6 – Windows 8;
7 – full web version;
8 – other apps.

AuthorUrl

Posts, Shares & Comments

Author profile URL

CreationTime

Posts, Shares & Comments

Creation timestamp for the message. 

EventId - CommentId

Comments Only

Appears on a comment message with an ID corresponding to the message itself. 

EventId - PostId

Posts, Shares & Comments

Unique, numeric post ID

EventId - PostOwnerId

Posts, Shares & Comments

Post owner ID. For shared posts, refers to the shared post's owner. 

EventType

Posts, Shares & Comments

Type of message, i.e. 'post', 'share' or 'comment'

ExtKey

Posts, Shares & Comments

Json contains post owner ID, post ID and comment ID

Geo

Posts

Json object containing geo coordinates and metadata for a place check-in. Example:                                                          

"geo": { "coordinates": "56.995972942424 60.605288300943", "place": { "checkins": 7, "city": 1154688, "country": 1, "created": 1530211122, "icon": "https://vk.com/images/places/place.png", "id": 112666463, "latitude": 56.995962, "longitude": 60.605264, "title": "Балтым", "type": 33 },

                                              },

 

Id

Posts, Shares & Comments

Numeric ID of the post, share or comment

Inserted

Posts, Shares & Comments

Timestamp when the message was inserted into the Socialgist search index.

LastModified

Posts, Shares & Comments

Last modified timestamp of the message. Message updates and deletes are processed in the search index. 

Published

Posts, Shares & Comments

Timestamp when the post, share or comment was published. 

Text

Posts, Shares & Comments

Body text of the message

Url

Posts, Shares & Comments

URL of the post, share or comment

 

Example Messages

 

Post

{ "code": 100, "event": { "access": "public", "action": "new", "action_time": 1723214106, "attachments": [ { "photo": { "access_key": "ce4aa1cf916d07f9e3", "album_id": -7, "date": 1723214098, "height": 487, "id": 457239019, "owner_id": 872559029, "photo_1280": "https://sun9-9.userapi.com/impg/AjUYeJh5RmRgTuF_ezhnDcfQWGGhJsh9qbUE-g/uf9DCC_HBKM.jpg?size=390x487&quality=95&sign=5eab615c629335f79f09e3ed5cee1c71&c_uniq_tag=EWFjsUdhVYYirtVWFANJhv1vG3NUrJNI5f8hfOeven4&type=album", "photo_130": "https://sun9-9.userapi.com/impg/AjUYeJh5RmRgTuF_ezhnDcfQWGGhJsh9qbUE-g/uf9DCC_HBKM.jpg?size=104x130&quality=95&sign=a3f30e3a6c22d6fa4e62b6f942f6313b&c_uniq_tag=i0i9GmMdWA_Be3kUXt4rJXoCgWrLLrP7wr3G_ZWiGWY&type=album", "photo_2560": "https://sun9-9.userapi.com/impg/AjUYeJh5RmRgTuF_ezhnDcfQWGGhJsh9qbUE-g/uf9DCC_HBKM.jpg?size=390x487&quality=95&sign=5eab615c629335f79f09e3ed5cee1c71&c_uniq_tag=EWFjsUdhVYYirtVWFANJhv1vG3NUrJNI5f8hfOeven4&type=album", "photo_604": "https://sun9-9.userapi.com/impg/AjUYeJh5RmRgTuF_ezhnDcfQWGGhJsh9qbUE-g/uf9DCC_HBKM.jpg?size=390x487&quality=95&sign=5eab615c629335f79f09e3ed5cee1c71&c_uniq_tag=EWFjsUdhVYYirtVWFANJhv1vG3NUrJNI5f8hfOeven4&type=album", "photo_75": "https://sun9-9.userapi.com/impg/AjUYeJh5RmRgTuF_ezhnDcfQWGGhJsh9qbUE-g/uf9DCC_HBKM.jpg?size=60x75&quality=95&sign=6093362755373c72f15afae560ec0698&c_uniq_tag=WIPmcmiwHYzJXhia8jbuo_pC65Cokl2EtmmQw5lC7h8&type=album", "photo_807": "https://sun9-9.userapi.com/impg/AjUYeJh5RmRgTuF_ezhnDcfQWGGhJsh9qbUE-g/uf9DCC_HBKM.jpg?size=390x487&quality=95&sign=5eab615c629335f79f09e3ed5cee1c71&c_uniq_tag=EWFjsUdhVYYirtVWFANJhv1vG3NUrJNI5f8hfOeven4&type=album", "post_id": 2, "text": "", "web_view_token": "0de7dd0d935dc43b64", "width": 390 }, "style": "full", "type": "photo" } ], "author": { "author_url": "https://vk.com/id872559029", "id": 872559029, "platform": 4 }, "creation_time": 1723214106, "event_id": { "post_owner_id": 872559029, "post_id": 2 }, "event_type": "post", "event_url": "https://vk.com/wall872559029_2", "full_text": " ", "shared_post_creation_time": 0, "text": "" }, "socialgist_metadata": { "language": "unknown" } }



Comment

{ "code": 100, "event": { "access": "public", "action": "new", "action_time": 1723215011, "author": { "author_url": "https://vk.com/id447478359", "id": 447478359 }, "creation_time": 1723215011, "event_id": { "post_owner_id": -20089197, "post_id": 15179, "comment_id": 19494 }, "event_type": "comment", "event_url": "https://vk.com/wall-20089197_15179?reply=19494", "full_text": " И мне очень понравилось как в серии обманщики мужик морячок и медведь сделали при бабе вид что медведь их съел а на самом деле мужик и морячок прятались под столом они пили самогон а медведь ел мед", "text": "И мне очень понравилось как в серии обманщики мужик морячок и медведь сделали при бабе вид что медведь их съел а на самом деле мужик и морячок прятались под столом они пили самогон а медведь ел мед" }, "socialgist_metadata": { "language": "ru" } }



Like

{     "code": 100,     "event": {         "access": "private",         "action": "new",         "action_time": 1515705835,         "author": {},         "event_id": {             "post_owner_id": 84198769,             "post_id": 74237         },         "event_type": "like"     } }

 

 

Share

{ "code": 100, "event": { "access": "public", "action": "delete", "action_time": 1723215398, "author": { "author_url": "https://vk.com/id599539792", "id": 599539792, "platform": 4, "shared_post_author_id": -217603705, "shared_post_author_url": "https://vk.com/club217603705" }, "creation_time": 1716902563, "event_id": { "post_owner_id": 599539792, "post_id": 208, "shared_post_owner_id": -217603705, "shared_post_id": 6908 }, "event_shared_url": "https://vk.com/wall-217603705_6908", "event_type": "share", "event_url": "https://vk.com/wall599539792_208", "shared_post_creation_time": 1716800220, "shared_post_text": "#คลิปเย็ด #คลิปโป๊<br>กดติดตามเพจ 👉👉👉 Asian Pornstar 👈👈👈 แล้วจะดูคลิปได้ 🐵🐵🐵🐵 ไอโฟนไอแพดต้องใช้ซาฟารีเปิดวีเค กดไลค์เพจในซาฟารีก่อน", "text": "" }, "socialgist_metadata": { "language": "th" } }

 

Related content