PHPackages                             kozhemin/topvisor-client - 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. [API Development](/categories/api)
4. /
5. kozhemin/topvisor-client

ActiveLibrary[API Development](/categories/api)

kozhemin/topvisor-client
========================

A PHP TopVisor client library

01261PHP

Since May 29Pushed 8y ago1 watchersCompare

[ Source](https://github.com/kozhemin/topvisor-client)[ Packagist](https://packagist.org/packages/kozhemin/topvisor-client)[ RSS](/packages/kozhemin-topvisor-client/feed)WikiDiscussions master Synced 2w ago

READMEChangelogDependenciesVersions (1)Used By (0)

Api2 Клиент TopVisor
====================

[](#api2-клиент-topvisor)

A PHP TopVisor client library

Установка
---------

[](#установка)

Используйте [composer](http://getcomposer.org/download/) для установки.

Выполните

```
composer require --prefer-dist kozhemin/topvisor-client:@dev

```

либо добавтьте

```
"kozhemin/topvisor-client": "@dev"

```

в `composer.json` файл.

Пример использования
--------------------

[](#пример-использования)

Данная библиотека реализует взаимодействие с API версии 2 [TopVisor](https://topvisor.ru/api/)

Подключение
-----------

[](#подключение)

```
$topVisorToken = "000000000";   //Ваш Token
$topUserId = 00000;             //Ваш Id пользователя
$connection = new Connection($topVisorToken, $topUserId);
```

Работа с проектами
------------------

[](#работа-с-проектами)

[https://topvisor.ru/api/v2-services/projects\_2/](https://topvisor.ru/api/v2-services/projects_2/)

```
//Example: Получить список проектов
//@link https://topvisor.ru/api/v2/basic-params/
$params = [];
foreach ($connection->getProjects($params) as $currentProject) {
    /** @var Project $currentProject */
    echo '';
    print_r($currentProject->name);
    echo '';
}

//Example: Получить конкретный проект
$projectID = 00000;
$project = $connection->getProject($projectID, $params);

//Example: Добавить ключевую фразу в проект
$project->addKeyword("keyword", $groupId)

//Example: Получить ключевые фразы проекта
$project->getKeywords($params = []);

//Example: Получить папки проекта
$project->getFolders($params = []);

//Example: Добавить папрку в проект
$project->addFolder($name);

//Example: Получить группы проекта
$project->getGroups($params = []);

//Example: Добавить группу в проект
$project->addGroup($name, $params = []);

//Example: Получить ключевые фразы по проекту
$params = ['limit'=>5];
$project->getKeywords($params, $params);

```

Ключевые фразы
--------------

[](#ключевые-фразы)

[https://topvisor.ru/api/v2-services/keywords\_2/](https://topvisor.ru/api/v2-services/keywords_2/)

```
//Example: Получить конкретную ключевую фразу
$keyWord = $connection->getKeyword($projectID, $keywordID, $params);

//Example: Установить целевую страницу фразы
$keyWord->setTarget('url',  $params);

//Example: Установить тег
$keyWord->setTag($tagsId, $action = 'add', $params = []);

//Example: Переместить фразу в группу
$keyWord->move($groupId, $params = []);

//Example: Получить папку фразы
$keyWord->getFolder();

//Example: Изменить фразу
$keyWord->rename('New Name');

//Example: Удалить фразу
$keyWord->remove();

//Example: Восстановить фразу
$keyWord->unRemove();

//Example: Получить проект к которому принадлежит фраза
$keyWord->getProject($params = []);

//Example: Получить группу к которой принадлежит фраза
$keyWord->getGroup($params = []);

```

Папки
-----

[](#папки)

[https://topvisor.ru/api/v2-services/keywords\_2/folders/](https://topvisor.ru/api/v2-services/keywords_2/folders/)

```
//Example: Добавить новую папку
$connection->addFolder($projectID, 'New Folder');

//Example: Получить все папки проекта
$connection->getFolders($projectId, $params = []);

//Example: Получить конкретную папку
$folder = $connection->getFolder($projectId, $folderId, $params = []);

//Example: Изменить папку
$folder->rename('Rename - Folder');

//Example: Переместить папку
$folder->move($params = []);

//Example: Удалить папку
$folder->remove();

//Example: Восстановить папку
$folder->unRemove();

//Example: Получить проект которому принадлежит папка
$folder->getProject($params = []);

```

Группы
------

[](#группы)

[https://topvisor.ru/api/v2-services/keywords\_2/groups/](https://topvisor.ru/api/v2-services/keywords_2/groups/)

```
//Example: Получить группы
$connection->getGroups($projectId, $params = []);

//Example: Получить конкретную группу
$group = $connection->getGroup($projectId, $groupId, $params = []);

//Example: Изменить группу
$group->rename($name);

//Example: Включить/Выключить группу
$group->on(1); //or 0

//Example: Переместить группу
$group->move($toGroupId, $params = []);

//Example: Удалить группу
$group->remove();

//Example: Восстановить группу
$group->unRemove();

//Example: Получить проект группы
$group->getProject();

//Example: Получить папку
$group->getFolder();

```

Позиции
-------

[](#позиции)

[https://topvisor.ru/api/v2-services/positions\_2/](https://topvisor.ru/api/v2-services/positions_2/)

```
//Example: Запуск проверки позиций
$connection->positionsCheck($projectId, $params = []);

//Example: Получить стоимость проверки позиций
$connection->positionsCheckPrice($projectId, $params = []);

//Example: Получить историю проверки позиций
$connection->positionsHistory($projectId, $regionsIndexes, $dateStart, $dateEnd, $params = []);

//Example: Получить данные сводки по выбранному проекту за две даты.
$connection->positionsSummary($projectId, $regionIndex, $dateStart, $dateEnd, $params = []);

```

###  Health Score

22

—

LowBetter than 21% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity41

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.

### Community

Maintainers

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

---

Top Contributors

[![kozhemin](https://avatars.githubusercontent.com/u/7480673?v=4)](https://github.com/kozhemin "kozhemin (2 commits)")

### Embed Badge

![Health badge](/badges/kozhemin-topvisor-client/health.svg)

```
[![Health](https://phpackages.com/badges/kozhemin-topvisor-client/health.svg)](https://phpackages.com/packages/kozhemin-topvisor-client)
```

###  Alternatives

[exsyst/swagger

A php library to manipulate Swagger specifications

35816.3M7](/packages/exsyst-swagger)[hubspot/api-client

Hubspot API client

24015.5M18](/packages/hubspot-api-client)[pocketmine/bedrock-protocol

An implementation of the Minecraft: Bedrock Edition protocol in PHP

172437.8k11](/packages/pocketmine-bedrock-protocol)[botman/driver-telegram

Telegram driver for BotMan

94452.6k6](/packages/botman-driver-telegram)

PHPackages © 2026

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