Top.Mail.Ru

Изменения в API (Changelog)

v1.0.27 (12.10.2026)
  • Пакетный анализ по ссылкам, добавлен режим анализа URL: параметр data.mode — domains (по умолчанию, как раньше) или url. В режиме url метрики считаются по странице, а не по домену: домен без пути анализируется как главная страница, http и https, а также варианты со слешем на конце и без считаются одной страницей; не более 1000 URL в запросе. В ответе name и новое поле url — адрес страницы, dr — рейтинг её домена.
v1.0.26 (08.10.2026)
  • Контекстная реклама - объявления по фразе за месяц (архив), добавлен новый метод /report/simple/context/keyword/ads/archive — объявления всех доменов, показывавшиеся по фразе за месяц помесячного архива, сразу по всем регионам Яндекса (параметр keyword обязателен; month в формате ГГГГ-ММ, без указания — текущий месяц; сортировка по полям keyscnt и serp; выгрузка type=csv).
  • Контекстная реклама - месяцы архива объявлений по фразе, добавлен новый метод /report/simple/context/keyword/ads/archive/months — список месяцев помесячного архива, в которых по фразе были объявления, с числом строк отчёта за месяц.
v1.0.25 (01.10.2026)
  • Контекстная реклама - ключевые слова за месяц (архив), добавлен новый метод /report/simple/context/keywords/archive — ключевые фразы домена за месяц помесячного архива (доступен только для баз Яндекса); параметр month в формате ГГГГ-ММ, без указания — текущий месяц.
  • Контекстная реклама - ключевые слова, сортировка по полям header, txt и url больше не поддерживается — такой запрос возвращает ошибку 400. Фильтрация по этим полям работает как раньше.
  • Контекстная реклама - ключевые слова по объявлению, сортировка по полям header, txt и url больше не поддерживается — такой запрос возвращает ошибку 400. Фильтрация по этим полям работает как раньше.
v1.0.24 (28.09.2026)
  • Контекстная реклама - объявления за месяц (архив), добавлен новый метод /report/simple/context/ads/archive — помесячный архив объявлений домена (доступен только для баз Яндекса); параметр month в формате ГГГГ-ММ, без указания — текущий месяц.
  • Контекстная реклама - месяцы архива объявлений, добавлен новый метод /report/simple/context/ads/archive/months — список месяцев помесячного архива, в которых у домена была реклама, с числом объявлений за месяц.
  • Контекстная реклама - ключевые слова по объявлению за месяц (архив), добавлен новый метод /report/simple/context/keywords/byads/archive — ключевые фразы объявления за месяц помесячного архива (доступен только для баз Яндекса).
v1.0.23 (23.09.2026)
  • Мониторинг позиций - отчёт по словам, поля ws, wsk, superwsk теперь могут быть null, если частотность ещё не собрана (раньше в этом случае возвращался 0, неотличимый от реального нулевого значения).
  • Мониторинг позиций - сравнение, поля avg_vis, avg_traffic, avg_delta_vis, avg_delta_traffic теперь могут быть null, если данных для расчёта нет вообще (раньше возвращался 0).
v1.0.22 (22.09.2026)
  • Кластеризация, добавлен новый метод /clustering/<uid>/update-frequency — обновление частотности всех фраз проекта без пересборки дерева кластеризации.
v1.0.21 (10.09.2026)
  • Запросы сервиса, изменена логика параметра strict: теперь strict=true — точный поиск одной фразы (словоформы и порядок слов как введены), strict=false — нечёткий поиск (склонения, порядок слов, список фраз и минус-фразы). Раньше значения были обратными. Проверьте интеграции, которые передают strict.
  • Запросы сервиса, точный поиск (strict=true) ищет фразу целиком с границами слов: «купить дом» находит «недорогой купить дом», но не «купить домен» и не «дом купить». Сортировка по полю word снова доступна; сортировка по id, gamn, gctr, avbid недоступна и отвечает 400.
v1.0.20 (14.08.2026)
  • Трекер ИИ - создание проекта, добавлены необязательные поля website (сайт проекта) и includeSubdomains (учитывать поддомены); эти же поля добавлены в ответ метода.
  • Трекер ИИ - обновление данных проекта, добавлены необязательные поля website и includeSubdomains.
  • Трекер ИИ, добавлен новый метод /ai_tracker/<id>/citation — цитируемость сайта проекта в источниках ответов ИИ (последний съём против предыдущего) с графиком за 7 дней.
  • Трекер ИИ - источники, график, при view=domain без явного выбора domains, если у проекта указан сайт, его домен всегда добавляется в выборку.
v1.0.19 (30.07.2026)
  • Органическая выдача - ключевые слова, в ответ и CSV-выгрузку добавлено поле avbid (средняя цена клика / CPC).
v1.0.18 (23.07.2026)
  • Органическая выдача - ключевые слова, из ответа и CSV-выгрузки удалено поле avbid (средняя цена клика / CPC).
  • Органическая выдача - страницы, из ответа удалено поле found_date (дата обнаружения); фильтрация и сортировка по полю также недоступны.
v1.0.17 (22.07.2026)
  • Онлайн парсер выдачи - выгрузка результата в CSV, метод /serp/<id>/csv стал асинхронным: вместо данных отчёта возвращает status (queued), job_id и message. Добавлены параметры ai_answer и encoding (utf8/cp1251).
  • Онлайн парсер выдачи - статус выгрузки CSV, добавлен новый метод /serp/<id>/csv/export-status (параметр job_id); ответ — status (queued/processing/done/error/not_found), при done доступны downloadUrl, rows, object_key.
v1.0.16 (16.07.2026)
  • Онлайн парсер выдачи - статус парсинга, полностью изменена структура ответа: поля batches, batches_total удалены, добавлены status (pending/parsing/completed/failed), error_msg, progress (0-100).
  • Онлайн парсер выдачи - список заданий на парсинг, в ответ добавлены новые поля status, error_msg, progress (0-100). Поля batches, batches_total удалены, для сортировки и фильтрации они также недоступны.
v1.0.15 (06.07.2026)
  • Трекер ИИ - список проектов, в ответ добавлено новое поле last_updated_at (дата последнего обновления данных).
  • Трекер ИИ - ответы ИИ по промпту за дату, в ответ добавлены новые поля ai_reference (тональность упоминания), brand_pos (позиция упоминания в ИИ) и total_pos (всего позиций).
v1.0.14 (11.06.2026)
  • Трекер ИИ - справочные данные по брендам, добавлен новый метод /ai_tracker/<id>/reference (параметры: systems, groups); ответ — массив объектов по брендам.
  • Трекер ИИ - сущность проекта
    • поле referenceData удалено из ответа; данные доступны в методе /ai_tracker/<id>/reference
    • поле prompts заменено на promptGroups — массив уникальных названий групп промптов
    • добавлен параметр withSettings — при true в ответ включаются schedulerSetting и alertSetting
  • Трекер ИИ - создание проекта, в ответе поле prompts заменено на promptGroups (массив уникальных групп промптов), поле referenceData удалено.
v1.0.13 (09.06.2026)
  • Онлайн парсер выдачи - создание задания, добавлен новый параметр scrape_ai_answers (сбор AI-ответов).
  • Онлайн парсер выдачи - обновление данных проекта, добавлен новый параметр scrape_ai_answers (сбор AI-ответов).
  • Мониторинг - создание проекта, добавлен новый параметр scrape_ai_answers (сбор AI-ответов в выдаче).
  • Мониторинг - обновление проекта, добавлен новый параметр scrape_ai_answers (сбор AI-ответов в выдаче).
  • Мониторинг - ручной запуск заданий, добавлен новый параметр scrape_ai_answers (сбор AI-ответов в выдаче).
v1.0.12 (04.06.2026)
  • Мои проекты - список проектов, в ответ добавлено новое поле owner_email (email владельца проекта).
  • Мониторинг позиций - список проектов, в ответ добавлено новое поле owner_email (email владельца проекта).
  • Онлайн парсер Wordstat - список заданий на парсинг, в ответ добавлено новое поле owner_email (email владельца проекта).
  • Онлайн парсер выдачи - список заданий на парсинг, в ответ добавлено новое поле owner_email (email владельца проекта).
  • Трекер ИИ - список проектов, в ответ добавлено новое поле owner_email (email владельца проекта).
v1.0.11 (03.06.2026)
  • Трекер ИИ - данные для таблицы проекта, в ответ добавлены новые поля percent (видимость), total (количество ответов) и total_with_vis (ответов с упоминанием).
  • Трекер ИИ - ответы ИИ по промпту за дату, добавлен новый метод /ai_tracker/<id>/prompt (параметры: prompt_id, date).
v1.0.10 (21.05.2026)
  • Трекер ИИ - данные для таблицы проекта, в ответ добавлены новые поля brand_pos (позиция упоминания в ИИ) и total_pos (всего позиций).
v1.0.9 (14.05.2026)
  • Онлайн парсер Wordstat - создание задания, добавлен новый параметр parse_budget_cpc (сбор бюджета, CPC).
  • Онлайн парсер Wordstat - обновление данных проекта, добавлен новый параметр parse_budget_cpc (сбор бюджета, CPC).
  • Онлайн парсер Wordstat - добавление/обновление слов, добавлен новый параметр parse_budget_cpc (сбор бюджета, CPC).
v1.0.8 (24.04.2026)
  • Трекер ИИ - все упоминания, в ответ добавлено новое поле ai_response_sources (массив URL источников упоминания).
v1.0.7 (21.04.2026)
  • Трекер ИИ - источники упоминаний, добавлен новый метод.
  • Трекер ИИ - график источников упоминаний, добавлен новый метод.
v1.0.6 (14.04.2026)
  • Кластеризация - добавление фраз в папку, добавлено описание метода.
  • Кластеризация - удаление/перемещение фраз, добавлено описание метода.
v1.0.5 (07.04.2026)
  • Трекер ИИ - создание проекта, изменен формат параметра description: ранее передавался массив строк, теперь строка.
  • Трекер ИИ - обновление данных проекта, изменен формат параметра description: ранее передавался массив строк, теперь строка.
  • Трекер ИИ - сущность проекта
    • изменен формат поля systems в ответе: ранее передавался массив ID систем, теперь объект-маппинг, где ключ — ID системы, значение — название
    • изменен параметр brandDescription » description в ответе: ранее передавался массив строк, теперь строка
  • Трекер ИИ - все упоминания, добавлены новые параметры systems и groups
  • Трекер ИИ - видимость по конкурентам, добавлены новые параметры systems и groups
v1.0.4 (26.03.2026)
  • Трекер ИИ - видимость по конкурентам, полностью изменена структура ответа от /ai_tracker/{id}/competitors, добавлена возможность выбора дат съёма для сравнения.
v1.0.3 (20.03.2026)
  • Мониторинг позиций - создание проекта, добавлен новый параметр competitors.
  • Мониторинг позиций - обновление данных проекта, добавлен новый параметр competitors.
  • Мониторинг позиций - сущность проекта, добавлен новый параметр competitors.
  • Мониторинг позиций - данные для таблицы проекта, полностью изменена структура ответа от /monitoring/{id}/report.
v1.0.2 (18.08.2025)
  • Фильтрация данных, операторы IN, NOT IN, IN ARRAY, NOT IN ARRAY считаются устаревшими (deprecated). Добавлены аналоги с другим разделителем DELIM.

    Рекомендации по замене:
    IN, разделители \n, , » ONE OF, разделители \n, DELIM
    NOT IN, разделитель \n, , » NOT ONE OF, разделители \n, DELIM
    IN ARRAY, разделитель \n, , » ARRAY CONTAINS, разделители \n, DELIM
    NOT IN ARRAY, разделитель \n, , » NOT ARRAY CONTAINS, разделители \n, DELIM

v1.0.1 (14.05.2025)
  • Онлайн парсер Wordstat - обновление данных проекта, ID проекта передается в URL. Ранее передавался в теле запроса. https://api.keys.so/wordstat/update-project » https://api.keys.so/wordstat/<id>/update-project
  • Онлайн парсер Wordstat - добавление/обновление слов, ID проекта передается в URL. Ранее передавался в теле запроса. https://api.keys.so/wordstat/update-words » https://api.keys.so/wordstat/<id>/update-words