Деякі функції обмежені. Зареєструйтесь безкоштовно
Switch to english interface?

Ключові слова

Метод SerpstatUrlProcedure.getUrlKeywords повертає ключові фрази в топі пошукової системи за заданим URL. Аналогічний до звіту Аналіз домену — SEO-аналіз — Ключові слова.

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

Доступні пошукові бази

Параметри запиту

Параметр

Опис

Тип даних

Опціональний

Значення за замовчуванням

Варіанти значень

id

Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення.

int/string

ні

1, test

method

Назва методу API

string

ні

SerpstatUrlProcedure.getUrlKeywords

params

Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]

array

ні

url

URL сторінки

string

ні

https://www.nike.com/men

se

Ідентифікатор пошукової бази, по якій буде проходити пошук (доступні бази Google і Yandex на вибір, наприклад: g_us, y_157)

string

ні

g_us

filters

Умови фільтраціі

array

так

"keyword": ["iphone", "iphone x"]

"cost": "10";
"cost_to": "10";
"cost_from": 1

"position": 1
"position_from": 2
"position_to": 10

"concurrency": "7";
"concurrency_to": "7";
"concurrency_from": 1

"keyword_length": 1;
"dkeyword_length": 1;
"keyword_length": 3

"difficulty": 3;
"difficulty_from": 5;
"difficulty_to": 10

"traff": 3;
"traff": 5;
"traff": 10

"region_queries_count": "1000";
"region_queries_count_to": "2000";
"region_queries_count_from": 300

"region_queries_count_wide": "1000";
"region_queries_count_wide_to": "1500";
"region_queries_count_wide_from": 100

"url": https://serpstat.com/api/

"url_contains": https://serpstat.com/

"right_spelling": true; "right_spelling": false

sort

Порядок сортування результатів в форматі: 
{{{Field}}: {{order}}}

field — поле, за яким потрібно виконати сортування:
* region_queries_count
* cost
* keyword_length
* concurrency
* difficulty
* traff
* region_queries_count_wide
* dynamic
* position
* found_results

order — напрямок сортування (asc — за зростанням, desc — за спаданням)

так

[ ] порожній масив

"sort": {"cnt": "asc"}

page

Номер сторінки у відповіді

int

так

1

"page": "5"

size

Кількість результатів на сторінку у відповіді

int

так

100

"size": "10"

min: 1, max: 1000

Параметри відповіді

Параметр

Опис

id

Ідентифікатор відповіді: відповідає id в запиті

result

Містить в собі відповідь

data Масив з даними

domain

Домен

subdomain

Піддомен сайту, який відображається в пошуковій видачі за даним запитом

keyword

Ключова фраза, за якою ранжується задана сторінка

keyword_length

Кількість слів, розділених пробілом в ключовою фразою

url

URL, який відображається в пошуковій видачі по даному запиту

position

Позиція сторінки за ключовою фразою в пошуковій видачі

types

Список додаткових елементів які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше)

found_results

Кількість знайдених результатів за ключовою фразою

cost

Ціна за клік, $

concurrency

Конкуренція ключової фрази в PPC (0-100%)

region_queries_count

Частотність ключової фрази в обраному регіоні

region_queries_count_wide

Частотність ключової фрази в широкій відповідності

geo_names

Список топонімів в масиві, якщо топонім присутній в ключовій фразі. Якщо немає - масив порожній.

traff Орієнтовний трафік за ключовим словом в залежності від частоти ключового слова та позиції
difficulty Оцінка рівня конкуренції за ключовою фразою для просування в топ-10 (від 0 до 100%)
dynamic Показує, як змінилася позиція заданої ключової фрази
summary_info Об'єкт з даними відповіді
page Номер сторінки

total

Кількість знайдених ключових фраз, за ​​якими ранжується сторінка в топі

left_lines

Кількість API рядків, що залишилися

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

{
    "domain": "nike.com",
    "subdomain": "www.nike.com",
    "keyword": "man nike",
    "keyword_length": 2,
    "url": "https://www.nike.com/men",
    "position": 1,
    "types": [
        "snip_breadcrumbs"
        ],
    "found_results": 656000000,
    "cost": 0.38,
    "concurrency": 100,
    "region_queries_count": 40500,
    "region_queries_count_wide": 0,
    "geo_names": [],
    "traff": 6071,
    "difficulty": null,
    "dynamic": 0
},

Example
Request data:
{
    "id": "1",
    "method": "SerpstatUrlProcedure.getUrlKeywords",
    "params": {
        "se": "g_us",
        "url": "https://www.nike.com/men",
        "filters": {"cost_from": 1, "cost_to": 1000},
        "sort": {"position": "asc"},
        "page": "1",
        "size": "10"
    }
}
Response data:
{
    "id": "1",
    "result": {
        "data": [
            {
                "domain": "nike.com",
                "subdomain": "www.nike.com",
                "keyword": "man nike",
                "keyword_length": 2,
                "url": "https://www.nike.com/men",
                "position": 1,
                "types": [
                    "snip_breadcrumbs"
                ],
                "found_results": 656000000,
                "cost": 0.38,
                "concurrency": 100,
                "region_queries_count": 40500,
                "region_queries_count_wide": 0,
                "geo_names": [],
                "traff": 6071,
                "difficulty": null,
                "dynamic": 0
            },
            {
                "domain": "nike.com",
                "subdomain": "www.nike.com",
                "keyword": "buy nike men shoes",
                "keyword_length": 4,
                "url": "https://www.nike.com/men",
                "position": 1,
                "types": [
                    "kn_graph_carousel_list",
                    "a_box_card",
                    "snip_image_thumbnail",
                    "snip_breadcrumbs"
                ],
                "found_results": 91,
                "cost": 1.485899,
                "concurrency": 100,
                "region_queries_count": 50,
                "region_queries_count_wide": 0,
                "geo_names": [],
                "traff": 7,
                "difficulty": 80.52167499013474,
                "dynamic": 0
            }
        ],
        "summary_info": {
            "page": 1,
            "total": 61,
            "left_lines": 998269
        }
    }
}

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

Ви впевнені?

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

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

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

Ім’я

Email

Телефон

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

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

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

Відкрити чат технічної підтримки