Топ по ключевой фразе
Метод 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
}
{
"id": 1,
"method": "SerpstatKeywordProcedure.getKeywordFullTop",
"params": {
"keyword": "pizza",
"se": "g_us",
"sort": {
"domain": "asc"
},
"size": 10
}
}
{
"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"
}
}
}