Отчет URL

2.3.1. Ключевые фразы по URL (url_keywords)

url_keywords — метод возвращает ключевые фразы в топе поисковой системы по заданному URL.

Пагинация

Для пагинации используйте параметры:

• page_size : количество результатов на страницу (по умолчанию — 100, максимум — 1000);
• page :  номер страницы (по умолчанию — 1-я страница).

Для фильтрации результатов используйте следующие параметры:

Для сортировки результата используйте параметры:

• 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}}} field - поле, по которому нужно выполнить сортировку order - направление сортировки (asc — по возрастанию, desc — по убыванию)	array	да	[ ] пустой массив	"sort": {"cnt": "asc"}
page	Номер страницы в ответе	int	да	1	5
size	Количество результатов на страницу в ответе	int	да	100	"size": {{page_size}} min: 1, max: 1000

Сортировка результатов возможна по следующим поля:

Параметр

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}}} field - поле, по которому нужно выполнить сортировку order - направление сортировки (asc — по возрастанию, desc — по убыванию)	array	да	[ ] пустой массив	{"cnt": "asc"}
page	Номер страницы в ответе	int	да	1	5
size	Количество результатов на страницу в ответе	int	да	100	"size": {{page_size}} min: 1, max: 1000

Сортировка результатов возможна по следующим поля:

Параметр

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}}} field - поле, по которому нужно выполнить сортировку order - направление сортировки (asc — по возрастанию, desc — по убыванию)	array	да	[ ] пустой массив	{"weight": "asc"}
page	Номер страницы в ответе	int	да	1	5
size	Количество результатов на страницу в ответе	int	да	100	"size": {{page_size}} min: 1, max: 1000

Сортировка результатов возможна по следующим поля:

Параметр

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 запрос.