Отчет 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 лимит:
{
"region_queries_count": 40,
"geo_names": [
],
"types": [
"refine_by_brand",
"also_asks",
"related_search",
"a_box_fsnippet",
"pic"
],
"cost": 13.23,
"region_queries_count_wide": 0,
"keyword": "example domain name",
"concurrency": 67,
"weight": 7
}
2.3.4. Ключевые фразы по URL V4 (SerpstatUrlProcedure.getUrlKeywords)
SerpstatUrlProcedure.getUrlKeywords — метод возвращает ключевые фразы в топе поисковой системы по заданному URL.
Параметры запроса:
Название параметра | Описание | Тип данных | Опциональный | Значение по умолчанию | Варианты значений |
---|---|---|---|---|---|
url | URL страницы | string | нет | https://allo.ua/ | |
se | Идентификатор поисковой базы, по которой будет проходить поиск | string | нет | g_ua, g_ru, ... | |
filters | Условия фильтрации | array | да |
{ "cost_from": "0.1", "cost_to": "3" }
|
|
sort |
Порядок сортировки результатов в формате: {{{field}}: {{order}}} order - направление сортировки (asc — по возрастанию, desc — по убыванию)
|
array | да | [ ] пустой массив |
"sort": {"cnt": "asc"} |
page | Номер страницы в ответе | int | да | 1 | 5 |
size | Количество результатов на страницу в ответе | int | да | 100 |
"size": {{page_size}} |
Сортировка результатов возможна по следующим поля:
Параметр |
region_queries_count |
cost |
keyword_length |
concurrency |
difficulty |
traff |
region_queries_count_wide |
dynamic |
position |
found_results |
Для фильтрации результатов используйте следующие параметры:
Параметр | Описание | Возможные значения |
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 | Минимальное значение конкуренции | 0-100 |
concurrency_to | Максимальное значение конкуренции | 0-100 |
Метрики ответа:
Метрики | Описание |
result | Инкапсулирует в себе ответ |
total | Количество найденных ключевых фраз, по которым ранжируется страница в топ-100 |
region_queries_count | Частотность ключевой фразы в выбранном регионе |
region_queries_count_wide | Частотность ключевой фразы в широком соответствии |
domain | Домен |
keyword_length | Количество слов, разделенных пробелом в ключевой фразе |
keyword | Ключевая фраза |
url | URL, который отображается в поисковой выдаче по данному запросу |
dynamic | Показывает, как изменилась позиция заданной ключевой фразы |
traff | Индекс, который показывает ориентировочный трафик на сайт (количество посетителей) |
types | Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое ). |
found_results | Количество найденных результатов по ключевой фразе ""keywords"" |
cost | Цена за клик, $ |
concurrency | Конкуренция ключевой фразы в PPC (0-100) |
position | Позиция ключевой фразы в поисковой выдаче |
subdomain | Поддомен сайта, который отображается в поисковой выдаче по заданной фразе |
types | Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое ) |
geo_names | Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой. |
date | Дата пробивки |
left_lines | Количество оставшихся API строк |
Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу. За один запрос можно получить не более 60000 результатов. Часть ответа API, за которую снимается 1 лимит:
{
"domain": "allo.ua",
"subdomain": null,
"keyword": "алло",
"keyword_length": 1,
"url": "https://allo.ua/",
"position": 1,
"date": "2019-04-06",
"types": [
"pic",
"local_pack",
"ads_top",
"a_box_some",
"kn_graph_card",
"kn_graph_brand",
"related_search",
"snip_sitelinks",
"snip_https",
"snip_search_box"
],
"found_results": 13100000,
"cost": 0.00769553,
"concurrency": 61,
"region_queries_count": 550000,
"region_queries_count_wide": 0,
"geo_names": [
],
"traff": 550000,
"dynamic": 0,
}
2.3.5. Список URL-адресов, конкурирующих с указанной страницей V4 (SerpstatUrlProcedure.getUrlCompetitors)
SerpstatUrlProcedure.getUrlCompetitors — метод возвращает cписок URL-адресов, конкурирующих с заданной страницей.
Параметры запроса:
Название параметра | Описание | Тип данных | Опциональный | Значение по умолчанию | Варианты значений |
---|---|---|---|---|---|
url | URL страницы для поиска конкурирующих url-адресов | string | нет | http://allo.ua/ | |
se | Идентификатор поисковой базы, по которой будет проходить поиск | string | нет | g_ua, g_ru, ... | |
sort |
Порядок сортировки результатов в формате: {{{field}}: {{order}}} order - направление сортировки (asc — по возрастанию, desc — по убыванию)
|
array | да | [ ] пустой массив |
{"cnt": "asc"} |
page | Номер страницы в ответе | int | да | 1 | 5 |
size | Количество результатов на страницу в ответе | int | да | 100 |
"size": {{page_size}} |
Сортировка результатов возможна по следующим поля:
Параметр |
cnt
|
Метрики ответа:
Метрика | Описание |
result | Инкапсулирует в себе ответ |
total | Количество ключевых фраз в топ-100 |
cnt | Количество одинаковых ключевых фраз у анализируемой страницы и страниц конкурентов |
domain | Домен конкурента |
url | Страница конкурента |
left_lines | Количество оставшихся API строк |
Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу. За один запрос можно получить не более 60000 результатов. Часть ответа API, за которую снимается 1 лимит:
{
"domain": "allo.ua",
"url": "https://allo.ua/ru/mobilnye-telefony-i-sredstva-svyazi/",
"cnt": 149
}
2.3.6. Ключевые слова конкурента, отсутствующие на указанной странице V4 (SerpstatUrlProcedure.getUrlMissingKeywords)
SerpstatUrlProcedure.getUrlMissingKeywords - метод возвращает ключевые фразы, по которым ранжируются конкуренты, но не ранжируется заданный URL.
Параметры запроса:
Название параметра | Описание | Тип данных | Опциональный | Значение по умолчанию | Варианты значений |
---|---|---|---|---|---|
url | Ссылка страницы для которой искать отсутствующие фразы | string | нет | https://rozetka.com.ua/computers-notebooks/c80253/ | |
se | Идентификатор поисковой базы, по которой будет проходить поиск | string | нет | g_ua, g_ru, ... | |
sort |
Порядок сортировки результатов в формате: {{{field}}: {{order}}} order - направление сортировки (asc — по возрастанию, desc — по убыванию)
|
array | да | [ ] пустой массив |
{"weight": "asc"} |
page | Номер страницы в ответе | int | да | 1 | 5 |
size | Количество результатов на страницу в ответе | int | да | 100 |
"size": {{page_size}} |
Сортировка результатов возможна по следующим поля:
Параметр |
weight
|
Метрики ответа:
Метрики | Описание |
result | Инкапсулирует в себе ответ |
region_queries_count | Частотность ключевой фразы в выбраном регионе |
region_queries_count_wide | Частотность ключевой фразы в широком соответствии |
geo_names | Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой. |
types | Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое ) |
cost | Цена за клик, $ |
keyword | Ключевая фраза по которой ранжируется страница конкурента, но не ранжируется заданная страница |
concurrency | Конкуренция ключевой фразы в PPC (0-100) |
weight | Сила связи — на сколько много других конкурентов ранжируются по заданной ключевой фразе |
left_lines | Количество оставшихся API строк |
Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу. За один запрос можно получить не более 60000 результатов.
Часть ответа API, за которую снимается 1 лимит:
{
"region_queries_count": 1,
"geo_names": [],
"types": [
"pic",
"video",
"local_pack",
"related_search",
"snip_reviews_stars"
],
"cost": 0,
"region_queries_count_wide": 0,
"keyword": "магазин алло г харьков",
"concurrency": 0,
"weight": 9
}
2.3.7. Трафик по маске URL V4 (SerpstatUrlProcedure.getSummaryTraffic)
SerpstatUrlProcedure.getSummaryTraffic - метод возвращает отчет по трафику по маске URL.
Параметры запроса:
Название параметра | Описание | Тип данных | Опциональный | Варианты значений |
domain | Домен, по которому нужно получить данные. | string | нет | allo.ua |
se |
Идентификатор базы данных, из которой нужно получить данные.
|
string
|
нет
|
g_ua, y_213, ... |
urlContains |
Искомая часть, входящая в URL страницы.
|
string
|
нет
|
/products/mobile/ |
Метрики ответа:
Название параметра | Описание |
totalTraff |
Суммарный органический трафик на найденные по маске URL страницы.
|
urls |
Количество URL, которые попали под условие поиска.
|
left_lines |
Количество оставшихся лимитов.
|
Лимиты
При подсчете использованных лимитов учитываются любые запросы по API в соответствие с вашим тарифным планом. В данном методе снимается 1000 API лимитов за 1 запрос.