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

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

Топ за ключовою фразою V4 (SerpstatKeywordProcedure.getKeywordTop)

Метод SerpstatKeywordProcedure.getKeywordTop повертає останній топ-100 Google або топ-50 Яндекс по ключовій фразі. Аналогічний до звіту Топ по фразі в Аналізі ключових слів.

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

Параметри запиту
Параметр Опис Тип даних Опціональний Значення за замовчуванням Варіанти значень
id Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення int/string ні 1, test
method Назва методу API string ні SerpstatKeywordProcedure.getKeywordTop
params Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...] array ні
keyword Фраза, для якої буде відбуватися пошук string ні   iphone
se Ідентифікатор пошукової бази, по якій буде проходити пошук string ні   g_us
filters Умови фильтраціі int так {"top_size": 100}

{"top_size": 100}

top_size цифрове значення від 1 до 100

Параметри відповіді
Параметр Опис
id Ідентифікатор відповіді: відповідає id в запиті
result Містить в собі відповідь
data Масив з даними
top Містить в собі відповідь
position Позиція домену за ключовою фразою в пошуковій видачі
url Сторінка, яка знаходиться на вказаній позиції
domain Домен, який ранжується за ключовою фразою
subdomain Піддомен сайту, який відображається в пошуковій видачі за заданною фразою
types Список додаткових елементів які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше)
ads Містить результати контекстної реклами (якщо вона є)
results Кількість результатів
summary_info Об'єкт з даними відповіді
page Номер сторінки
left_lines Кількість API рядків, що залишилися

Ліміти: кількість списаних лімітів відповідає кількості отриманих ключових фраз у відповіді. За один запит можна отримати не більше 60000 результатів. Частина відповіді API, за яку знімається 1 ліміт:

{
    "position": 1,
    "url": "https://www.apple.com/iphone/",
    "domain": "apple.com",
    "subdomain": "www.apple.com",
    "types": [
        "shopping_top",
        "kn_graph_carousel_list",
        "also_asks",
        "snip_breadcrumbs"
        ]
},

Example
Request data:
{
 "id": "1",
 "method": "SerpstatKeywordProcedure.getKeywordTop",
 "params": {
   "keyword": "iphone",
   "se": "g_us",
   "filters": {"top_size": "10"}
 }
}
Response data:
{
    "id": "1",
    "result": {
        "data": {
            "top": [
                {
                    "position": 1,
                    "url": "https://www.apple.com/iphone/",
                    "domain": "apple.com",
                    "subdomain": "www.apple.com",
                    "types": [
                        "shopping_top",
                        "kn_graph_carousel_list",
                        "also_asks",
                        "snip_breadcrumbs"
                    ]
                },
                {
                    "position": 2,
                    "url": "https://www.apple.com/",
                    "domain": "apple.com",
                    "subdomain": "www.apple.com",
                    "types": [
                        "shopping_top",
                        "kn_graph_carousel_list",
                        "also_asks",
                        "snip_breadcrumbs"
                    ]
                }
            ],
            "ads": [],
            "types": [
                "shopping_top",
                "kn_graph_carousel_list",
                "also_asks"
            ],
            "results": 79
        },
        "summary_info": {
            "page": 1,
            "left_lines": 998661
        }
    }
}

Поділіться статтею з вашими друзями

Вхід Реєстрація

Ви вичерпали ліміт запитів.

Або email
Забыли пароль?
Або email
Optional
Повернутися до авторизації

Не хвилюйтеся! Лише заповніть поле з вашою email адресою і ми вишлемо вам листа для відновлення паролю.

Ви впевнені?

Awesome!

To complete your registration you need to enter your phone number

Назад

Ми надіслали код підтвердження на ваш номер телефону

Your phone Resend code Залишилося запитів

Щось пішло не так.

Зв'яжіться з нашою службою підтримки
Або підтвердіть регістарціі за допомогою Телеграм бота Перейдіть за цим посиланням
Виберіть проєкт, по якому хочете отримувати дані

Знайомство з сервісом

Serpstat економить час, як і ми готові заощадити ваш, на знайомстві з ключовими можливостями сервісу.

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

Ім’я

Email

Телефон

Будемо раді вашому коментарю

Покращити план

Експорт недоступний для вашого тарифного плану. Вам необхідно поліпшити свій тариф до Lite або вище, щоб отримати доступ до інструменту. Детальніше

Sign Up Free

Дякуємо, ми зберегли ваші нові налаштування розсилок.

Запрошення
Просмотр Редактирование

E-mail
Повідомлення
Необов'язково
E-mail
Повідомлення
Необов'язково

У вас закінчилися ліміти

Ви досягли ліміту на кількість створених проєктів і більше не можете створювати нові проєкти. Збільште ліміти або видаліть існуючі проєкти.

Я хочу більше лімітів
Відкрити чат технічної підтримки