Топ по ключевой фразе

Метод SerpstatKeywordProcedure.getKeywordFullTop возвращает последний топ-100 Google по ключевой фразе. Аналогичен отчету «Топ по фразе» в Анализе ключевых слов.

Общие параметры запроса и инструкция по использованию Serpstat API
Перечень доступных баз и стран

Параметры запроса
Параметр	Описание	Тип данных	Обязательный	Значение по умолчанию	Варианты значений
id	Идентификатор запроса: ответ будет содержать этот же идентификатор. Ввод числового (number) или текстового (string) значения.	int/string	да		1, test
method	Название метода API	string	да		SerpstatKeywordProcedure.getKeywordFullTop
params	Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...]	array	да
keyword	Фраза, для которой будет происходить поиск	string	да		pizza
se	Идентификатор поисковой базы, по которой будет проходить поиск.	string	да		g_us
sort	Сортировка по данным (по возрастанию и убыванию)	array	нет	{"position": "asc"}	"position": "asc"/"desc" (asc — сортировка по возрастанию, desc — по убыванию) - Позиция в топ-100 "url": "asc"/"desc" - URL (asc - от A до Z; desc - от Z до A) "url_keywords_count": "asc"/"desc" - Количество ключей в URL "domain": "asc"/"desc" - Домен (asc - от A до Z; desc - от Z до A) "domain_visibility": "asc"/"desc" - Видимость "domain_keywords_organic": "asc"/"desc" - Количество ключей домена в органике "domain_keywords_ppc": "asc"/"desc" - Количество ключей домена в ррс "domain_top_10_keywords_count": "asc"/"desc" - Количество ключей домена в топ-10 "domain_sdr": "asc"/"desc" - Serpstat Domain Rank "domain_in_urls_count": "asc"/"desc" - Количество входящих ссылок домена "domain_in_domains_count": "asc"/"desc" - Количество ссылающихся доменов "domain_out_urls_count": "asc"/"desc" - Количество исходящих ссылок домена "domain_out_domains_count": "asc"/"desc" - Количество исходящих доменов
size	Количество результатов в ответе	int	нет	100	"size": "50" min: 10, max: 100

Параметры ответа
Параметр	Описание
id	Идентификатор запроса: соответствует id в запросе
result	Содержит в себе ответ
top	Массив с данными ответа
position	Позиция по ключевой фразе в поисковой выдаче
url	Страница, которая находится на указанной позиции
url_keywords_count	Количество ключевых слов в SEO, по которым URL-адрес попадает в топ-100 результатов Google.
domain	Домен, который ранжируется по ключевой фразе
domain_visibility	Видимость домена в топ-20 поисковых результатов. Показатель рассчитывается по соотношению количества и популярности ключевых фраз, по которым сайт ранжируется. Подробнее о показателе
domain_keywords_organic	Количество ключевых слов в SEO, по которым домен попадает в топ-100 результатов Google.
domain_keywords_ppc	Количество ключевых слов РРС, по которым домен попадает в топ-100 результатов Google.
domain_top_10_keywords_count	Количество ключевых слов в SEO, по которым домен попадает в топ-10 результатов Google.
domain_sdr	Serpstat Domain Rank (SDR) — показатель авторитетности домена
domain_in_urls_count	Количество входящих ссылок домена
domain_in_domains_count	Количество ссылающихся доменов
domain_out_urls_count	Количество исходящих ссылок домена
domain_out_domains_count	Количество исходящих доменов
summary_info	Объект с общими данными ответа
keywords	Количество ключевых слов в SEO (из отчета Подбор фраз)
frequency	Частотность ключевой фразы
cost	Цена за клик в $ США, которая ежемесячно обновляется
difficulty	Оценка уровня конкуренции по ключевой фразе для продвижения в топ-10 (от 1 до 100)
concurrency	Конкуренция ключевой фразы в PPC (0-100%)
types	Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое)
sorting	Сортировка запроса
left_limits	Количество оставшихся API строк
count_top_results	Количество результатов по запросу
keyword	Анализируемая фраза
se	Используемый регион базы данных

Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу. Часть ответа API, за которую снимается 1 лимит:

{
  "position": 27,
  "url": "https://www.zpizza.com/",
  "url_keywords_count": 3162,
  "domain": "zpizza.com",
  "domain_visibility": 0.07,
  "domain_keywords_organic": 9120,
  "domain_keywords_ppc": 0,
  "domain_top_10_keywords_count": 1101,
  "domain_sdr": 44,
  "domain_in_urls_count": 6265,
  "domain_in_domains_count": 716,
  "domain_out_urls_count": 452,
  "domain_out_domains_count": 129
  }

Example

Request data:

{
"id": 1,
"method": "SerpstatKeywordProcedure.getKeywordFullTop",
"params": {
"keyword": "pizza",
"se": "g_us",
"sort": {
   "domain": "asc"
        },
"size": 10
    }
}

Response data:

{
    "id": "1",
    "result": {
        "top": [
            {
                "position": 27,
                "url": "https://www.zpizza.com/",
                "url_keywords_count": 3162,
                "domain": "zpizza.com",
                "domain_visibility": 0.07,
                "domain_keywords_organic": 9120,
                "domain_keywords_ppc": 0,
                "domain_top_10_keywords_count": 1101,
                "domain_sdr": 44,
                "domain_in_urls_count": 6265,
                "domain_in_domains_count": 716,
                "domain_out_urls_count": 452,
                "domain_out_domains_count": 129
            },
            {
                "position": 29,
                "url": "https://www.youtube.com/watch?v=0w8YpBjsW6Y",
                "url_keywords_count": 99,
                "domain": "youtube.com",
                "domain_visibility": 22059.88,
                "domain_keywords_organic": 480765206,
                "domain_keywords_ppc": 4,
                "domain_top_10_keywords_count": 106713777,
                "domain_sdr": 99,
                "domain_in_urls_count": 8774661393,
                "domain_in_domains_count": 22344395,
                "domain_out_urls_count": 94697,
                "domain_out_domains_count": 163
            },
            {
                "position": 65,
                "url": "https://www.youtube.com/watch?v=263uoOoWf9c",
                "url_keywords_count": 68,
                "domain": "youtube.com",
                "domain_visibility": 22059.88,
                "domain_keywords_organic": 480765206,
                "domain_keywords_ppc": 4,
                "domain_top_10_keywords_count": 106713777,
                "domain_sdr": 99,
                "domain_in_urls_count": 8774661393,
                "domain_in_domains_count": 22344395,
                "domain_out_urls_count": 94697,
                "domain_out_domains_count": 163
            },
            {
                "position": 56,
                "url": "https://www.yelp.com/search?cflt=pizza&find_loc=Mentone%2C+AL",
                "url_keywords_count": 20,
                "domain": "yelp.com",
                "domain_visibility": 3155.87,
                "domain_keywords_organic": 82668431,
                "domain_keywords_ppc": 15,
                "domain_top_10_keywords_count": 36075286,
                "domain_sdr": 82,
                "domain_in_urls_count": 71352727,
                "domain_in_domains_count": 634321,
                "domain_out_urls_count": 13029,
                "domain_out_domains_count": 466
            },
            {
                "position": 67,
                "url": "https://www.yelp.com/search?cflt=pizza&find_loc=Hopewell%2C+VA",
                "url_keywords_count": 15,
                "domain": "yelp.com",
                "domain_visibility": 3155.87,
                "domain_keywords_organic": 82668431,
                "domain_keywords_ppc": 15,
                "domain_top_10_keywords_count": 36075286,
                "domain_sdr": 82,
                "domain_in_urls_count": 71352727,
                "domain_in_domains_count": 634321,
                "domain_out_urls_count": 13029,
                "domain_out_domains_count": 466
            },
            {
                "position": 3,
                "url": "https://en.wikipedia.org/wiki/Pizza",
                "url_keywords_count": 8737,
                "domain": "wikipedia.org",
                "domain_visibility": 37845.97,
                "domain_keywords_organic": 241512021,
                "domain_keywords_ppc": 0,
                "domain_top_10_keywords_count": 76138842,
                "domain_sdr": 94,
                "domain_in_urls_count": 1419295195,
                "domain_in_domains_count": 6636517,
                "domain_out_urls_count": 194046257,
                "domain_out_domains_count": 607822
            },
            {
                "position": 61,
                "url": "https://www.wfaa.com/article/life/food/donatos-pizza-expansion-dallas-fort-worth/287-a7099672-b807-45e2-b978-904d21be8398",
                "url_keywords_count": 41,
                "domain": "wfaa.com",
                "domain_visibility": 28.87,
                "domain_keywords_organic": 975269,
                "domain_keywords_ppc": 0,
                "domain_top_10_keywords_count": 50721,
                "domain_sdr": 66,
                "domain_in_urls_count": 558794,
                "domain_in_domains_count": 19665,
                "domain_out_urls_count": 2,
                "domain_out_domains_count": 2
            },
            {
                "position": 34,
                "url": "https://www.vpizza.com/",
                "url_keywords_count": 4363,
                "domain": "vpizza.com",
                "domain_visibility": 0.01,
                "domain_keywords_organic": 8162,
                "domain_keywords_ppc": 0,
                "domain_top_10_keywords_count": 422,
                "domain_sdr": 38,
                "domain_in_urls_count": 599,
                "domain_in_domains_count": 236,
                "domain_out_urls_count": 526,
                "domain_out_domains_count": 26
            },
            {
                "position": 38,
                "url": "https://unapizza.com/",
                "url_keywords_count": 1530,
                "domain": "unapizza.com",
                "domain_visibility": 0.08,
                "domain_keywords_organic": 2098,
                "domain_keywords_ppc": 0,
                "domain_top_10_keywords_count": 196,
                "domain_sdr": 42,
                "domain_in_urls_count": 4744,
                "domain_in_domains_count": 408,
                "domain_out_urls_count": 206,
                "domain_out_domains_count": 40
            },
            {
                "position": 73,
                "url": "https://www.tributepizza.com/",
                "url_keywords_count": 836,
                "domain": "tributepizza.com",
                "domain_visibility": 0.01,
                "domain_keywords_organic": 1064,
                "domain_keywords_ppc": 0,
                "domain_top_10_keywords_count": 44,
                "domain_sdr": 35,
                "domain_in_urls_count": 467,
                "domain_in_domains_count": 111,
                "domain_out_urls_count": 120,
                "domain_out_domains_count": 13
            }
        ],
        "summary_info": {
            "keywords": 3123661,
            "frequency": 6120000,
            "cost": 2,
            "difficulty": 93,
            "concurrency": 10,
            "types": [
                "related_search",
                "kn_graph_card"
            ],
            "sorting": {
                "domain": "desc"
            },
            "left_limits": 999360,
            "count_top_results": 100,
            "keyword": "pizza",
            "se": "g_us"
        }
    }
}