analiztopv2 Сравнение страницы с ТОПом выдачи по ключевым показателям
Скачивает страницы ТОПа Яндекса или Google по запросу и сравнивает с ними вашу страницу: объём текста, вхождения запроса и его слов в текст, Title и анкоры, переколдовки, популярные у конкурентов слова, HTTPS, номер 8-800. Метод асинхронный: ответ на постановку — report_id. То же в интерфейсе — Анализ ТОП по ключевым показателям.
- Режим
- асинхронный:
report_id - Стоимость
- от 6 лимитов: зависит от глубины и опций
- Одновременно
- до 5 задач
Постановка задачи
/api/analiztopv2
Параметры передаются в query. Свой список конкурентов вместо ТОПа — в теле POST (custom_urls); тогда запрос делается методом POST, а остальные параметры остаются в query.
Параметры query
-
keystring обязательныйКлюч API из настроек аккаунта. -
querystring обязательныйПоисковый запрос. -
lrint обязательныйРегион: ID региона Яндекса, для Google — тот же справочник. -
urlstringВаша страница. Без неё считаются только средние по ТОПу, блокuser_dataбудет пустым. -
search_systemstringПоисковая система: ID или слаг. Прочие значения трактуются как Яндекс. -
deepintСколько сайтов ТОПа анализировать, от 1 до 20. Каждый — +1 лимит; больше 20 сайтов выдача не даст, а лимиты за превышение спишутся. -
rel_urlstringНайти в выдаче релевантную страницу вашего сайта и анализировать её вместоurl. +1 лимит. -
check_iksstringДобавить в ответ ИКС вашего сайта и средний по ТОПу. Только для Яндекса. -
mobileintБрать мобильную выдачу. -
custom_urlsarrayСвои URL конкурентов вместо ТОПа выдачи. Массив или строка, по одному на строке. Лимит заdeepтогда не берётся, зато +1 за каждый URL.
Ответ
-
report_idintID задачи для получения результата.
Получение результата
/api/analiztopv2
Пока задача выполняется, приходит {"error":"In progress","code":50} — повторите запрос через 30–60 секунд. Анализ ТОП-10 обычно занимает несколько минут.
Параметры query
-
keystring обязательныйКлюч API из настроек аккаунта. -
report_idint обязательныйID задачи из ответа на постановку.
Ответ
В request — параметры задачи, как они сохранены. Данные лежат на два уровня глубже: response.response. В user_data — показатели вашей страницы, в top_data — средние по ТОПу в том же формате.
-
response.response.user_data / top_dataobjectПоказатели страницы и средние по ТОПу.Вложенные поля
-
text_volumeobjectwordsиsymbols— объём текста. -
query_in_text_exactnumberТочных вхождений запроса в текст. -
query_words_in_text_percentarray[{word, percent}]— доля каждого слова запроса в тексте. -
query_words_in_titlearray[{words, count}]— вхождения слов запроса в Title. -
query_words_in_anchorsarray[{word, count}]— вхождения в анкоры исходящих ссылок. -
hlwords_in_textarray[{word, percent}]— переколдовки (слова из подсветки выдачи) в тексте. -
rel_docs_by_titlenumberЧисло релевантных документов по Title. -
title_volumeobjectwordsиsymbols— длина Title. -
httpsbool|numberУ страницы — есть ли HTTPS; у ТОПа — доля сайтов на HTTPS, %. -
8800bool|numberУ страницы — есть ли номер 8-800; у ТОПа — доля сайтов с ним, %. -
iksnumberТолько приcheck_iks=onв Яндексе: ИКС сайта / средний ИКС ТОПа. -
popular_wordsarrayТолько вuser_data: слова, частые у конкурентов, которых нет в вашем тексте.
-
-
response.response.advanced_dataobjectПозиция вашего сайта:query,rel_url(релевантная страница),rel_url_current_position,rel_url_age,reoptimization; если анализировалась другая страница —analized_urlиanalized_url_age. Неизвестное —false. -
response.response.analized_urlsarrayСайты ТОПа, участвовавшие в расчёте средних. -
response.response.user_query_errorstringЕсть, если по запросу ничего не нашлось; остальные поля тогда пустые.
Ошибки
| Код | Сообщение | Когда |
|---|---|---|
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.