PHPackages                             tigusigalpa/yandex-search-php - 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. tigusigalpa/yandex-search-php

ActiveLibrary[API Development](/categories/api)

tigusigalpa/yandex-search-php
=============================

PHP/Laravel SDK for Yandex Search API integration. Supports web search, generative search, image search, and keyword statistics (Wordstat).

v1.0.0(3mo ago)6121MITPHPPHP ^8.0

Since Mar 6Pushed 3mo ago1 watchersCompare

[ Source](https://github.com/tigusigalpa/yandex-search-php)[ Packagist](https://packagist.org/packages/tigusigalpa/yandex-search-php)[ Docs](https://github.com/tigusigalpa/yandex-search-php)[ RSS](/packages/tigusigalpa-yandex-search-php/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (1)Dependencies (7)Versions (2)Used By (0)

Yandex Search PHP SDK
=====================

[](#yandex-search-php-sdk)

[![Yandex Search PHP SDK](https://private-user-images.githubusercontent.com/2721390/559028072-863bba30-6a15-4eb6-bcf5-f3ed9c19139a.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODIzNzg5OTUsIm5iZiI6MTc4MjM3ODY5NSwicGF0aCI6Ii8yNzIxMzkwLzU1OTAyODA3Mi04NjNiYmEzMC02YTE1LTRlYjYtYmNmNS1mM2VkOWMxOTEzOWEucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDYyNSUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA2MjVUMDkxMTM1WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MWE2ZjA3YmRmNDZkNTc5N2FhNmIwMzhiYWE2N2IzODM5YzJhYTY5M2I5YjM2NDM1ZWFiZjg4ZDE3ZjFkODA2MSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmcmVzcG9uc2UtY29udGVudC10eXBlPWltYWdlJTJGcG5nIn0.kOwXZ6XDGxCUF-oL3GIXbyck8jhSQLoZhJ7MS1X8Z-g)](https://private-user-images.githubusercontent.com/2721390/559028072-863bba30-6a15-4eb6-bcf5-f3ed9c19139a.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODIzNzg5OTUsIm5iZiI6MTc4MjM3ODY5NSwicGF0aCI6Ii8yNzIxMzkwLzU1OTAyODA3Mi04NjNiYmEzMC02YTE1LTRlYjYtYmNmNS1mM2VkOWMxOTEzOWEucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDYyNSUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA2MjVUMDkxMTM1WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MWE2ZjA3YmRmNDZkNTc5N2FhNmIwMzhiYWE2N2IzODM5YzJhYTY5M2I5YjM2NDM1ZWFiZjg4ZDE3ZjFkODA2MSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmcmVzcG9uc2UtY29udGVudC10eXBlPWltYWdlJTJGcG5nIn0.kOwXZ6XDGxCUF-oL3GIXbyck8jhSQLoZhJ7MS1X8Z-g)

[![Latest Version](https://camo.githubusercontent.com/0bffe4fa2a607e70baafda5738b0f4ddc786088ceefd892882bcc57f884c73e6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f74696775736967616c70612f79616e6465782d7365617263682d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/tigusigalpa/yandex-search-php)[![PHP Version](https://camo.githubusercontent.com/dd1c82f7bd4c75a3f2415a6c3609ef1ffb709c0c5598b540282e1dd6a64d773e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f74696775736967616c70612f79616e6465782d7365617263682d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/tigusigalpa/yandex-search-php)[![License](https://camo.githubusercontent.com/6ef687897db48be0cfe4af42faaaeff2c8bd12c8f25f35fb69fbfe9f92cd3435/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f74696775736967616c70612f79616e6465782d7365617263682d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/tigusigalpa/yandex-search-php)

PHP 8.0+ SDK, который даёт доступ ко всем возможностям [Yandex Search API](https://aistudio.yandex.ru/docs/ru/search-api/concepts/index.html) прямо из вашего PHP- или Laravel-приложения. Классический веб-поиск, генеративные ответы от ИИ, поиск картинок, аналитика ключевых слов — всё в одном пакете.

> Часть экосистемы Яндекса для PHP:
> [yandex-cloud-client-php](https://github.com/tigusigalpa/yandex-cloud-client-php) · [yandexgpt-php](https://github.com/tigusigalpa/yandexgpt-php)

[🇬🇧 English version](README-en.md)

> 📖 **[Полная документация доступна на Wiki](https://github.com/tigusigalpa/yandex-search-php/wiki)**

Что внутри
----------

[](#что-внутри)

- **Веб-поиск** — текстовый поиск с сортировкой, группировкой, регионами и семейным фильтром
- **Генеративный поиск** — задайте вопрос, получите ответ от ИИ с реальными источниками (на базе YandexGPT)
- **Поиск изображений** — ищите по описанию или загружайте картинку для обратного поиска
- **Wordstat** — популярность ключевых слов, динамика, распределение по регионам (как Яндекс Вордстат, только через API)
- **Асинхронность** — запускайте поиск и забирайте результат позже
- **Типобезопасные DTO** — каждый ответ API приходит в виде объекта, а не сырого массива
- **Готовность к Laravel** — service provider, фасад, публикация конфига, DI — всё из коробки
- **Тестируемость** — подставьте мок HTTP-клиента и тестируйте без обращений к реальному API

Требования
----------

[](#требования)

- PHP 8.0+
- Аккаунт [Yandex Cloud](https://cloud.yandex.ru/) с подключённым Search API
- OAuth-токен (как получить — см. [oauth.yandex.ru](https://oauth.yandex.ru/))

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

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

```
composer require tigusigalpa/yandex-search-php
```

Пакет зависит от [`tigusigalpa/yandex-cloud-client-php`](https://github.com/tigusigalpa/yandex-cloud-client-php) для аутентификации

Быстрый старт
-------------

[](#быстрый-старт)

### Обычный PHP

[](#обычный-php)

Три строки до первого поиска:

```