Инструменты · key

analiztopv2 Сравнение страницы с ТОПом выдачи по ключевым показателям

Скачивает страницы ТОПа Яндекса или Google по запросу и сравнивает с ними вашу страницу: объём текста, вхождения запроса и его слов в текст, Title и анкоры, переколдовки, популярные у конкурентов слова, HTTPS, номер 8-800. Метод асинхронный: ответ на постановку — report_id. То же в интерфейсе — Анализ ТОП по ключевым показателям.

Режим
асинхронный: report_id
Стоимость
от 6 лимитов: зависит от глубины и опций
Одновременно
до 5 задач

Постановка задачи

GET /api/analiztopv2

Параметры передаются в query. Свой список конкурентов вместо ТОПа — в теле POST (custom_urls); тогда запрос делается методом POST, а остальные параметры остаются в query.

Параметры query

  • key string обязательный
  • query string обязательный
    Поисковый запрос.
  • lr int обязательный
    Регион: ID региона Яндекса, для Google — тот же справочник.
  • url string
    Ваша страница. Без неё считаются только средние по ТОПу, блок user_data будет пустым.
  • search_system string
    Поисковая система: ID или слаг. Прочие значения трактуются как Яндекс.
    1
    Яндекс (или yandex)
    2
    Google (или google)
    По умолчанию 1
  • deep int
    Сколько сайтов ТОПа анализировать, от 1 до 20. Каждый — +1 лимит; больше 20 сайтов выдача не даст, а лимиты за превышение спишутся.
    По умолчанию 5
  • rel_url string
    Найти в выдаче релевантную страницу вашего сайта и анализировать её вместо url. +1 лимит.
    on
    определить релевантную
  • check_iks string
    Добавить в ответ ИКС вашего сайта и средний по ТОПу. Только для Яндекса.
    on
    добавить ИКС
  • mobile int
    Брать мобильную выдачу.
    0
    десктоп
    1
    мобильная
    По умолчанию 0
  • custom_urls array
    Свои URL конкурентов вместо ТОПа выдачи. Массив или строка, по одному на строке. Лимит за deep тогда не берётся, зато +1 за каждый URL.

Ответ

  • report_id int
    ID задачи для получения результата.

Получение результата

GET /api/analiztopv2

Пока задача выполняется, приходит {"error":"In progress","code":50} — повторите запрос через 30–60 секунд. Анализ ТОП-10 обычно занимает несколько минут.

Параметры query

  • key string обязательный
  • report_id int обязательный
    ID задачи из ответа на постановку.

Ответ

В request — параметры задачи, как они сохранены. Данные лежат на два уровня глубже: response.response. В user_data — показатели вашей страницы, в top_data — средние по ТОПу в том же формате.

  • response.response.user_data / top_data object
    Показатели страницы и средние по ТОПу.
    Вложенные поля
    • text_volume object
      words и symbols — объём текста.
    • query_in_text_exact number
      Точных вхождений запроса в текст.
    • query_words_in_text_percent array
      [{word, percent}] — доля каждого слова запроса в тексте.
    • query_words_in_title array
      [{words, count}] — вхождения слов запроса в Title.
    • query_words_in_anchors array
      [{word, count}] — вхождения в анкоры исходящих ссылок.
    • hlwords_in_text array
      [{word, percent}] — переколдовки (слова из подсветки выдачи) в тексте.
    • rel_docs_by_title number
      Число релевантных документов по Title.
    • title_volume object
      words и symbols — длина Title.
    • https bool|number
      У страницы — есть ли HTTPS; у ТОПа — доля сайтов на HTTPS, %.
    • 8800 bool|number
      У страницы — есть ли номер 8-800; у ТОПа — доля сайтов с ним, %.
    • iks number
      Только при check_iks=on в Яндексе: ИКС сайта / средний ИКС ТОПа.
    • popular_words array
      Только в user_data: слова, частые у конкурентов, которых нет в вашем тексте.
  • response.response.advanced_data object
    Позиция вашего сайта: query, rel_url (релевантная страница), rel_url_current_position, rel_url_age, reoptimization; если анализировалась другая страница — analized_url и analized_url_age. Неизвестное — false.
  • response.response.analized_urls array
    Сайты ТОПа, участвовавшие в расчёте средних.
  • response.response.user_query_error string
    Есть, если по запросу ничего не нашлось; остальные поля тогда пустые.

Ошибки

КодСообщениеКогда
50 In progress Задача ещё выполняется.
-50 Not set Не передан query или lr: {"query":"Not set","code":-50}.
-60 To many tasks from one user. Try again later. Уже идут 5 задач этого метода.
-4 Access denied report_id чужой или от другого инструмента.
-104…-107, -125 Processing error и др. Задача завершилась без результата: ошибка обработки (-104), кончились лимиты (-105), отменена (-106), шла дольше 6 часов (-107), прочее (-125).
-1, -2 Access denied Ключ не передан (HTTP 404) или не найден (HTTP 403).
-68, -80…-83 Not enough … limits Не хватает дневных, часовых, недельных, месячных или годовых лимитов.

Сколько стоит задача

Лимиты списываются при постановке: (1 за запрос + 1 за url + 1 за rel_url=on) × множитель поисковой системы + deep. Множитель для Яндекса — 1. С custom_urls вместо deep к первым слагаемым прибавляется число переданных URL. Пример: Яндекс, url задан, deep=10 — 12 лимитов.

Для rel_url передавайте именно on: другое непустое значение тоже подменит страницу релевантной, но не войдёт в стоимость и не включит поиск позиции сайта в Google.

Обратная связь и помощь
Если у вас есть идеи, как улучшить данный инструмент или остались вопросы по работе с ним, напишите в нашу службу поддержки, мы обязательно вам поможем.