Download the PHP package shanginn/yandex-wordstat without Composer
On this page you can find all versions of the php package shanginn/yandex-wordstat. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Table of contents
Download shanginn/yandex-wordstat
More information about shanginn/yandex-wordstat
Files in shanginn/yandex-wordstat
Download shanginn/yandex-wordstat
More information about shanginn/yandex-wordstat
Files in shanginn/yandex-wordstat
Vendor shanginn
Package yandex-wordstat
Short Description A strongly-typed, modern PHP SDK for the Yandex Wordstat API
License MIT
Package yandex-wordstat
Short Description A strongly-typed, modern PHP SDK for the Yandex Wordstat API
License MIT
Please rate this library. Is it a good library?
Informations about the package yandex-wordstat
Yandex Wordstat PHP SDK
Строго типизированный, современный PHP SDK для нового REST API Яндекс Wordstat. Построен на amphp/http-client для высокой производительности и crell/serde для надёжной сериализации объектов.
Возможности
- Полное покрытие API: поддерживает эндпоинты
/getRegionsTree,/topRequests,/dynamics,/regionsи/userInfo. - Строгая типизация: типизированные объекты ответов и enum-параметры.
- Гибкая фильтрация: фильтрация по регионам, устройствам и временным периодам через удобные enum-классы.
- Пакетные запросы: поддержка нескольких фраз в одном запросе к
/topRequests. - Пользовательские исключения: чистая обработка ошибок с маппингом на структуры ошибок Yandex API, включая автоматическое определение Rate Limit.
Документация
📚 Смотреть полную документацию в Wiki
Быстрые ссылки
- Начало работы и обзор REST API
- /topRequests — Популярные запросы
- /dynamics — Динамика запросов
- /regions — Региональная статистика
- /userInfo — Информация о пользователе
- /getRegionsTree — Дерево регионов
Установка
Начало работы
Инициализация
1. Информация о пользователе и квоте
2. Популярные запросы
3. Пакетный запрос для нескольких фраз
4. Динамика запросов
5. Региональная статистика
6. Дерево регионов
Аутентификация
Для работы с SDK необходим OAuth-токен Яндекса с доступом к Wordstat API.
Подробная инструкция по получению токена →
Краткий порядок действий:
- Создайте приложение на https://oauth.yandex.ru/client/new, выбрав доступ Использование API Вордстата.
- Подайте заявку на доступ к API в поддержку Яндекс Директа, указав логин и Client ID приложения.
- Авторизуйтесь по ссылке
https://oauth.yandex.ru/authorize?response_type=token&client_id=<client_id>и сохраните выданный токен.
Установите переменную окружения:
Проверить токен можно прямым curl-запросом:
Доступные enum-классы
DeviceType — тип устройства
| Значение | Описание |
|---|---|
DeviceType::ALL |
Все устройства |
DeviceType::DESKTOP |
Компьютеры |
DeviceType::MOBILE |
Мобильные устройства |
DeviceType::PHONE |
Телефоны |
DeviceType::TABLET |
Планшеты |
DynamicsPeriod — период динамики
| Значение | Описание |
|---|---|
DynamicsPeriod::DAILY |
По дням |
DynamicsPeriod::WEEKLY |
По неделям |
DynamicsPeriod::MONTHLY |
По месяцам |
RegionType — тип региона
| Значение | Описание |
|---|---|
RegionType::ANY |
Любые регионы |
RegionType::CITIES |
Города |
RegionType::REGIONS |
Регионы |
RegionType::EVERYWHERE |
Везде |
Обработка ошибок
Запуск тестов
Лицензия
MIT
All versions of yandex-wordstat with dependencies
PHP Build Version
Package Version
Requires
php Version
>=8.2
symfony/serializer Version ^7
symfony/property-access Version ^7
crell/serde Version ^1.3
amphp/http-client Version ^5.3
symfony/serializer Version ^7
symfony/property-access Version ^7
crell/serde Version ^1.3
amphp/http-client Version ^5.3
The package shanginn/yandex-wordstat contains the following files
Loading the files please wait ...