Страницы-лидеры домена V4 (SerpstatDomainProcedure.getTopUrls)
SerpstatDomainProcedure.getTopUrls — метод возвращает лучшие страницы анализируемого домена по количеству ключевых фраз в региональной выдаче поисковой системы. Также он показывает потенциальный трафик, количество шейров в Facebook.
Данный метод может работать продолжительное время, из-за специфики сбора данных. По умолчанию результаты отсортированы по количеству фраз, по убыванию.
Параметры запроса:
Название | Описание | Тип | Опциональный | Значение по умолчанию | Варианты значений |
---|---|---|---|---|---|
domain | Имя домена | string | нет | allo.ua | |
se | Идентификатор поисковой базы, по которой будет проходить поиск | string | нет | g_ua, g_ru, ... | |
sort |
Порядок сортировки результатов в формате: {{{field}}: {{order}}} order - направление сортировки (asc — по возрастанию, desc — по убыванию)
|
json object | да | {"organic_keywords":"desc"} | {"organic_keywords":"desc"} |
filters | Условия фильтрации | json object | да | --- |
{"url_prefix": "https://allo.ua/ru/products/"} {"url_contain": "style"} {"url_not_contain": "style"} |
page | Номер страницы в ответе | int | да | 1 | 5 |
size | Количество результатов на страницу в ответе | int | да | 100 | 50-1000 |
Сортировка результатов возможна по следующим поля:
Параметр |
organic_keywords |
facebook_shares |
potencial_traff |
Метрики ответа:
Метрика | Описание |
result | Инкапсулирует в себе ответ |
total | Всего найдено страниц у домена |
url |
URL страницы |
organic_keywords | Общее количество ключевых фраз, по которым ранжируется страница в Google топ-100 или Яндекс топ-50 |
facebook_shares | Количестве шейров страницы в Facebook |
potencial_traff | Количество посетителей в месяц, которые страница получит в том случае, если займет по всем фразам из топ-20 первую позицию в поисковой выдаче Google или Yandex. Данный показатель рассчитывается исходя из соотношения реального и максимально возможного трафика. |
left_lines | Количество оставшихся API строк |
Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу.
{
"url": "https://photos.google.com/",
"organic_keywords": 20425,
"facebook_shares": 228162,
"potencial_traff": 11342451
}
{
"id": {{any_num_or_string}},
"method": "SerpstatDomainProcedure.getTopUrls",
"params": {
"domain": {{domain}},
"se": {{search_engine}},
(optional) "sort": { {{field}}: {{"asc"|"desc"}}}, // only 1 sort field per request. This sorting will sort only data on current page!
(optional) "filters": { {{field}}: {{value}}},
(optional) "page": {{page}},
(optional) "size": {{page_size}}
}
}
{
"id": {{your_num_or_string}},
"result": {
"data": [
{
"url": "https://photos.google.com/",
"organic_keywords": 20425,
"facebook_shares": 228162,
"potencial_traff": 11342451
},
{
"url": "https://photos.google.com/apps",
"organic_keywords": 13691,
"facebook_shares": 1872,
"potencial_traff": 596825
},
{
"url": "https://photos.google.com/u/0/albums",
"organic_keywords": 7888,
"facebook_shares": 0,
"potencial_traff": 541311
},
........................
........................
],
"summary_info": {
"page": 1,
"left_lines": 99268,
"total": 3809
}
}
}