Страницы-лидеры домена V4 (SerpstatDomainProcedure.getTopUrls)

SerpstatDomainProcedure.getTopUrls — метод возвращает лучшие страницы анализируемого домена по количеству ключевых фраз в региональной выдаче поисковой системы. Также он показывает потенциальный трафик, количество шейров в Facebook.

Данный метод может работать продолжительное время, из-за специфики сбора данных. По умолчанию результаты отсортированы по количеству фраз, по убыванию.

Параметры запроса:

Название	Описание	Тип	Опциональный	Значение по умолчанию	Варианты значений
domain	Имя домена	string	нет		allo.ua
se	Идентификатор поисковой базы, по которой будет проходить поиск	string	нет		g_ua, g_ru, ...
sort	Порядок сортировки результатов в формате: {{{field}}: {{order}}} field - поле, по которому нужно выполнить сортировку 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
}

Example

Request data:


{
 "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}}
 }
}

Response data:


{
    "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
        }
    }
}