Деякі функції обмежені.
Вхід Реєстрація

Ми використовуємо файли cookie для забезпечення працездатності сервісу, поліпшення навігації і маркетингових активностей Serpstat. Натискаючи "Прийняти та продовжити", ви погоджуєтеся з нашою Політики конфіденційності

Сторінки-лідери домену (get_top_urls)

З 31.12.2021 методи API v3 будуть недоступні. Скористайтеся аналогічним методом API v4.

Метод get_top_url виводить сторінки аналізованого домена в ієрархічному порядку. Крім того, він показує кількість ключових фраз, по яким сторінка ранжується в топі (топ-100 Google або топ-50 Яндекс), орієнтовний трафік сторінки та кількість шейрів в соціальній мережі Facebook. Аналогічний звіту «Сторінки-лідери» в Аналізі домену.

Загальні параметри запиту та інструкція щодо використання Serpstat API

Для пагінації необхідно використовувати параметри:
page_size: кількість результатів на сторінку (за замовчуванням 100, максимум 1000)
page: номер сторінки (за замовчуванням 1-а сторінка)

Для сортування результату можно використовувати параметри:
sort: поле по якому потрібно виконати сортування
order: напрямок сортування (asc — за зростанням, desc — за спаданням)

Параметри відповіді
Параметр Опис
result Містить в собі відповідь
total Кількість знайдених сторінок у домена
hits
Містить в собі відповідь
url Сторінка домену
organic_keywords Кількість знайдених ключових фраз, за якими ранжується дана сторінка в топ-100 Google або Яндекс топ-50
facebook_shares Кількість шейрів в соціальній мережі Facebook
potencial_traff Орієнтовний трафік строрінки за ключовими фразами в залежності від частотності запиту і позиції домену
status_msg Відповідь: «OK» або «Error», повідомляє про вдалий або невдалий запит
status_code Код відповіді «200» — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта)
left_lines Кількість API рядків, що залишилися

Частина відповіді API, за яку знімається 1 ліміт:

{
    "url": "https://www.nike.com/",
    "organic_keywords": 65134,
    "facebook_shares": 701305,
    "potencial_traff": 39481276
},

Example
Request data:

api.serpstat.com/v3/get_top_urls?query=nike.com&se=g_us&token=XXX&order=desc&sort=organic_keywords&page_size=100&page=1

Response data:
{
    "result": {
        "total": 147181,
        "hits": [
            {
                "url": "https://www.nike.com/",
                "organic_keywords": 65134,
                "facebook_shares": 701305,
                "potencial_traff": 39481276
            },
            {
                "url": "https://jobs.nike.com/",
                "organic_keywords": 20392,
                "facebook_shares": 614,
                "potencial_traff": 121679
            }
        ]
    },
    "status_msg": "OK",
    "status_code": 200,
    "left_lines": 997717
}