Top.Mail.Ru

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

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