PHPackages                             chipslays/vk-music - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. chipslays/vk-music

ActiveLibrary

chipslays/vk-music
==================

A simple wrapper for VK Music API.

1.0.1(4y ago)3542MITPHP

Since Jun 30Pushed 4y ago2 watchersCompare

[ Source](https://github.com/chipslays/vk-music)[ Packagist](https://packagist.org/packages/chipslays/vk-music)[ RSS](/packages/chipslays-vk-music/feed)WikiDiscussions master Synced yesterday

READMEChangelog (2)Dependencies (2)Versions (3)Used By (0)

🎵 VK Music API for PHP
======================

[](#-vk-music-api-for-php)

A simple wrapper for VK Music API.

> For use this library, first you need get a token and user-agent.
>
> See for more [`vodka2/vk-audio-token`](https://github.com/vodka2/vk-audio-token).

Installation
------------

[](#installation)

```
composer require chipslays/vk-music
```

Usage
-----

[](#usage)

```
use Chipslays\VkMusic\Client;

$client = new Client('YOUR_TOKEN', 'YOUR_USERAGENT');

$response = $client->search('Justin Bieber - Baby');

print_r($response->toArray());

// Array
// (
//     [count] => 3693
//     [items] => Array
//         (
//            [0] => ...
//            [1] => ...
//            [2] => ...
//         )
// )
```

You can get the value using dot notation by [`chipslays/collection`](https://github.com/chipslays/collection).

```
print_r($response->get('items.0.artist'));
```

Methods
-------

[](#methods)

> **NOTICE:** Optional parameter `$extra` is a array of parameters with `key => value`.

#### `search(string $q, int $count = 10, int $offset = 0, array $extra = []): Collection`

[](#searchstring-q-int-count--10-int-offset--0-array-extra---collection)

```
$client->search('Justin Bieber - Baby');
```

#### `getById(string|array $audios): Collection`

[](#getbyidstringarray-audios-collection)

```
$client->getById(['371745461_456289486', '-41489995_202246189']);
```

#### `get($owner_id, int $count = 10, int $offset = 0, $extra = []): Collection`

[](#getowner_id-int-count--10-int-offset--0-extra---collection)

```
$client->get('371745461');
```

#### `getPlaylists($owner_id, int $count = 10): Collection`

[](#getplaylistsowner_id-int-count--10-collection)

```
$client->getPlaylists('371745461');
```

#### `getRecommendations(int $count = 10): Collection`

[](#getrecommendationsint-count--10-collection)

```
$client->getRecommendations();
```

#### `getPopular(int $count = 10): Collection`

[](#getpopularint-count--10-collection)

```
$client->getPopular();
```

#### `method(string $method, array $params): Collection`

[](#methodstring-method-array-params-collection)

```
$client->method('audio.search', [
    'q' => 'Justin Bieber - Baby',
    'count' => '10',
]);
```

Helpers
-------

[](#helpers)

You can use `vk_music` helper instead `Client` class.

```
$client = vk_music('YOUR_TOKEN', 'YOUR_USERAGENT');
```

Todo
----

[](#todo)

- Write tests 😴💤

License
-------

[](#license)

MIT

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

1777d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/19103498?v=4)[chipslays](/maintainers/chipslays)[@chipslays](https://github.com/chipslays)

---

Top Contributors

[![chipslays](https://avatars.githubusercontent.com/u/19103498?v=4)](https://github.com/chipslays "chipslays (6 commits)")

---

Tags

audiolibrarymusicvkvk-audiovk-music

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/chipslays-vk-music/health.svg)

```
[![Health](https://phpackages.com/badges/chipslays-vk-music/health.svg)](https://phpackages.com/packages/chipslays-vk-music)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)