Skip to main content

​
Welcome to VK-IO

VK-IO is a powerful Node.js module that allows you to easily interact with the VK API. Built with TypeScript and designed for modern development, VK-IO provides a predictable abstraction over the VK API with complete feature coverage.

Quick Start

Get up and running with your first VK bot in minutes

Installation

Install VK-IO using npm, yarn, or pnpm

API Reference

Explore the complete API documentation

Examples

Learn from real-world bot implementations

​
Why VK-IO?

Complete Coverage

100% coverage of the VK API with 1:1 mapping of API methods

Simple & Intuitive

Predictable API design that mirrors VK’s official methods

Type-Safe

Written in TypeScript with full type definitions and test coverage

Modern & Reliable

Native ESM support with automatic request parallelization

​
Key Features

​
Intuitive API Design

VK-IO provides a clean, predictable interface that maps directly to VK API methods: 
// Simple and intuitive
vk.api.users.get({ user_ids: [1] });
vk.api.wall.post({ message: 'Hello, VK!' });
vk.api.messages.send({ peer_id: 123, message: 'Hi!' });

​
Powerful Bot Development

Build sophisticated bots with middleware support, keyboard builders, and rich message contexts: 
import { VK, Keyboard } from 'vk-io';

const vk = new VK({ token: process.env.TOKEN });

vk.updates.on('message_new', async (context) => {
  await context.send('Hello! 👋', {
    keyboard: Keyboard.builder()
      .textButton({ label: 'Click me' })
      .inline()
  });
});

vk.updates.start();

​
Advanced Capabilities

Proxy Support

Use custom agents for proxy configuration

Request Parallelization

Automatic optimization for massive API requests

User Authorization

Support for OAuth and Direct Authorization

Rich Ecosystem

Modular packages for sessions, scenes, and more

​
What You Can Build

VK-IO is perfect for building:
  • Chat Bots - Interactive conversational bots with keyboards and commands
  • Community Managers - Automated posting and community interaction tools
  • Analytics Tools - Data collection and analysis applications
  • Integration Services - Connect VK with other platforms and services
  • Custom Clients - Build your own VK client applications

​
Ecosystem Packages

VK-IO comes with a rich ecosystem of official packages:
VK-IO assumes intermediate knowledge of JavaScript. If you’re new to Node.js development, learn the basics first, then return to build amazing VK applications.

​
Ready to Get Started?

Jump into the Installation Guide to set up VK-IO, or skip ahead to the Quick Start to build your first bot right away.

Installation Guide

Install VK-IO and set up your development environment

Quick Start

Build your first working VK bot in under 5 minutes

Build docs developers (and LLMs) love

Get started for freeTalk to us