Если у вас в проекте есть скрипт, который дёргает Google Custom Search JSON API с запросами site:, чтобы проверять индексацию ссылок, у него осталось меньше полутора лет: API отключают 1 января 2027 года. Ниже — план миграции, который занимает один рабочий день на средний проект.
Шаг 1. Найти все точки вызова
Ищите по коду строки customsearch/v1, googleapis.com/customsearch и переменные с cx=. Обычно это 1–3 функции: проверка одной ссылки, пакетная обёртка и ночной cron. Зафиксируйте, сколько URL в сутки они проверяют — это определит бюджет замены.
Шаг 2. Выбрать замену по трём критериям
- Пакетный вход: сотни и тысячи URL одним запросом.
- Вердикт по каждому URL, а не список результатов, который нужно парсить.
- Стабильная цена за URL без суточного потолка.
Под эти критерии подходит массовая проверка индексации в Google от SpeedyIndex: REST API принимает до 10 000 URL в одной задаче.
Шаг 3. Заменить вызовы
Вместо цикла «один URL — один запрос» появляется три вызова: POST /v2/task/google/checker/create с массивом ссылок, опрос /status и получение /fullreport с массивами проиндексированных и непроиндексированных URL. Авторизация — заголовок Authorization с API-ключом из личного кабинета. Обработка задачи асинхронная, поэтому ночной cron превращается в две задачи: вечером отправить, утром забрать отчёт.
Шаг 4. Контрольная сверка
Прогоните один и тот же список из 200–500 URL через старый и новый чекер и сравните расхождения вручную по 10–20 адресам через Search Console. Расхождения будут: результаты Custom Search никогда не совпадали с органикой один в один. Это нормальный повод пересмотреть, чему вы доверяли раньше.
Шаг 5. Отключить старый код до декабря
После 1 января скрипт не начнёт возвращать «пусто» — он начнёт возвращать ошибки, и мониторинг индексации остановится молча. Переключайтесь заранее и оставьте старую функцию в репозитории только как комментарий.
Полный разбор ситуации с закрытием API и таблица конечных точек — в статье о закрытии Custom Search JSON API; термин и параметры старого API — в Индекспедии.
