Отчет URL
2.3.1. Ключевые фразы по URL (url_keywords)
url_keywords — метод возвращает ключевые фразы в топе поисковой системы по заданному URL.
Пагинация
Для пагинации используйте параметры:
page_size : количество результатов на страницу (по умолчанию — 100, максимум — 1000).
page : номер страницы (по умолчанию — 1-я страница).
Для фильтрации результатов используйте следующие параметры:
| Параметр | Описание | Возможные значения |
| position_from | Минимальная позиция ключевого слова | 1-100 |
| position_to | Максимальная позиция ключевого слова | 1-100 |
| queries_from | Минимальное количество запросов в месяц | 0-100000000 |
| queries_to | Максимальное количество запросов в месяц | 0-100000000 |
| cost_from | Минимальная стоимость за клик | 0-200 |
| cost_to | Максимальная стоимость за клик | 0-200 |
| concurrency_from | Минимальное значение конкуренции | 1-100 |
| concurrency_to | Максимальное значение конкуренции | 1-100 |
| right_spelling | Фильтрация по фразам с неправильным написанием | not_contains - содержит фразы с неправильным написанием; contains - не содержит фразы с неправильным написанием |
Для сортировки результата используйте параметры:
sort : поле, по которому нужно выполнить сортировку.
order : направление сортировки (asc — по возрастанию, desc — по убыванию).
| Метрики | Описание |
| result | Инкапсулирует в себе ответ |
| total | Количество найденных ключевых фраз, по которым ранжируется страница в топ-100 |
| region_queries_count | Частотность ключевой фразы в выбранном регионе |
| region_queries_count_wide | Частотность ключевой фразы в широком соответствии |
| domain | Домен |
| keyword_length | Количество слов, разделенных пробелом в ключевой фразе |
| keyword | Ключевая фраза, по которой отображается объявление |
| url | URL, который отображается в поисковой выдаче по данному запросу |
| dynamic | Показывает, как изменилась позиция заданной ключевой фразы |
| traff | Индекс, который показывает ориентировочный трафик на сайт (количество посетителей) |
| keyword_crc | Контрольная сумма для быстрого поиска |
| types | Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое ). |
| found_results | Количество найденных результатов по ключевой фразе ""keywords"" |
| url_crc | crc код от переменной ""url"" |
| cost | Цена за клик, $ |
| concurrency | Конкуренция ключевой фразы в PPC (0-100) |
| position | Позиция ключевой фразы в поисковой выдаче |
| keyword_id | ID ключевой фразы в нашей базе |
| subdomain | Поддомен сайта, который отображается в поисковой выдаче по заданной фразе |
| types | Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое ) |
| geo_names | Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой. |
| status_msg | Ответ: "OK" или "Error" сообщает об удачном или неудачном запросе |
| status_code | Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта) |
| left_lines | Количество оставшихся API строк |
Часть ответа API, за которую снимается 1 лимит:
{
"region_queries_count": 10,
"domain": "example.com",
"keyword_length": 2,
"keyword": "site example.com",
"url": "https://example.com/",
"dynamic": null,
"traff": 1,
"found_results": "36500000",
"cost": 0,
"concurrency": 0,
"position": 2,
"subdomain": null,
"region_queries_count_wide": 0,
"types": [
],
"geo_names": [
],
"_id": "239122007-2"
}
2.3.2. Список URL-адресов, конкурирующих с запрашиваемой страницей (url_competitors)
url_competitors — метод возвращает url конкурентов для заданного url.
| Метрика | Описание |
| result | Инкапсулирует в себе ответ |
| total | Количество ключевых фраз в топ-10 |
| cnt | Количество одинаковых ключевых фраз у анализируемой страницы и страниц конкурентов |
| domain | Домен конкурента |
| url | Страница конкурента |
| status_msg | Ответ: "OK" или "Error" сообщает об удачном или неудачном запросе |
| status_code | Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта) |
| left_lines | Количество оставшихся API строк |
Часть ответа API, за которую снимается 1 лимит:
{
"cnt": 27,
"domain": "wikipedia.org",
"url": "https://en.wikipedia.org/wiki/Example.com"
}
2.3.3. Ключевые слова конкурента, отсутствующие на запрашиваемой странице (url_missing_keywords)
url_missing_keywords — метод возвращает ключевые фразы, по которым ранжируются конкуренты, но которые отсутствуют в заданном URL.
Пагинация
Для пагинации используйте параметры:
page_size : количество результатов на страницу (по умолчанию — 100, максимум — 1000).
page : номер страницы (по умолчанию — 1-я страница).
| Метрики | Описание |
| result | Инкапсулирует в себе ответ |
| total | Количество найденных результатов |
| region_queries_count | Частотность ключевой фразы в выбраном регионе |
| region_queries_count_wide | Частотность ключевой фразы в широком соответствии |
| geo_names | Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой. |
| types | Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое ) |
| cost | Цена за клик, $ |
| keyword_id | ID ключевой фразы в нашей базе |
| keyword | Ключевая фраза по которой ранжируется страница конкурента, но не ранжируется заданная страница |
| concurrency | Конкуренция ключевой фразы в PPC (0-100) |
| weight | Сила связи — на сколько много других конкурентов ранжируются по заданной ключевой фразе |
| status_msg | Ответ: "OK" или "Error" сообщает об удачном или неудачном запросе |
| status_code | Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта) |
| left_lines | Количество оставшихся API строк |
Часть ответа API, за которую снимается 1 лимит: