Отчеты о доменах
2.1.1. Суммарный отчет по домену (domain_info)
domain_info — метод возвращает суммарную информацию по домену.
Metrics | Description |
result | Инкапсулирует в себе ответ |
visible | Видимость сайта |
keywords | Количество найденных ключевых фраз в выбранной поисковой системе |
traff |
Индекс, который показывает ориентировочный трафик на сайт (количество посетителей)
|
visible_dynamic | Динамика изменения видимости по сравнению с последней датой обновления |
keywords_dynamic | Изменение количества ключевых фраз по сравнению с последней датой обновления |
traff_dynamic | Изменение трафика по сравнению с последней датой обновления |
date | Дата текущей проверки видимости, ключевых фраз и трафика |
prev_date | Предыдущая дата проверки |
new_keywords | Количество новых ключевых фраз, которые появились у домена по сравнению с последней датой обновления |
out_keywords | Количество ключевых фраз, которые потерял доменпо сравнению с последней датой обновления |
rised_keywords | Ключевые фразы, по которым выросли позиции по сравнению с последней датой обновления |
down_keywords | Ключевые фразы, по которым упали позиции по сравнению с последней датой обновления |
ad_keywords | Количество ключевых фраз в PPC |
ads | Количество объявлений в PPC |
ads_dynamic | История изменений в объявлениях PPC |
status_msg | Ответ: "OK" или "Error", сообщает об удачном или неудачном запросе |
status_code | Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта) |
left_lines | Количество оставшихся API строк |
Мы снимаем 1 лимит за запрос этого метода
2.1.2. История по домену (domain_history)
domain_history — метод возвращает историю изменения видимости и количества фраз по домену.
Metrics | Description |
result | Инкапсулирует в себе ответ |
visible_static | Видимость |
visible | Видимость сайта |
domain | Домен |
keywords | Количество найденных ключевых фраз в выбранной поисковой системе |
ads | Количество объявлений {date} |
ad_keywords | Количество ключевых фраз в PPC |
new_keywords | Количество новых ключевых фраз которые появились у домена за последние N дней |
out_keywords | Количество ключевых фраз которые потерял домен за последние N дней |
rised_keywords | Ключевые фразы у которых выросли позиции за последние N-дней |
down_keywords | Ключевые фразы у которых упали позиции за последние N-дней |
date | Дата проверки определенного элемента массива |
traff | Индекс, который показывает ориентировочный трафик на сайт (количество посетителей) |
status_msg | Ответ: "OK" или "Error", сообщает об удачном или неудачном запросе |
status_code | Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта) |
left_lines | Количество оставшихся API строк |
Часть ответа API, за которую снимается 1 лимит:
{
"visible_static": 0.0087,
"domain": "serpstat.com",
"ads": 191,
"visible": 0.0087,
"rised_keywords": 32,
"keywords": 430,
"down_keywords": 28,
"new_keywords": 101,
"ad_keywords": 293,
"traff": 2575,
"out_keywords": 37,
"date": "2016-11-13"
},
"visible_static": 0.0087,
"domain": "serpstat.com",
"ads": 191,
"visible": 0.0087,
"rised_keywords": 32,
"keywords": 430,
"down_keywords": 28,
"new_keywords": 101,
"ad_keywords": 293,
"traff": 2575,
"out_keywords": 37,
"date": "2016-11-13"
},
2.1.3. Ключевые слова в топе поисковой системы по домену (domain_keywords)
domain_keywords — метод возвращает ключевые слова в топе поисковой системы по домену. Вы можете выгрузить до 60 000 результатов, используя данный метод.
Пагинация
Для пагинации используйте параметры:
page_size : количество результатов на страницу (по умолчанию — 100, максимум — 1000).
page : номер страницы (по умолчанию — 1-я страница).
Для фильтрации результатов используйте следующие параметры:
Параметр | Описание | Возможные значения |
position_from | Минимальная позиция ключевого слова | 1-100 |
position_to | Максимальная позиция ключевого слова | 1-100 |
queries_from | Минимальное количество запросов в месяц | 0-100000000 |
queries_to | Максимальное количество запросов в месяц | 0-100000000 |
cost_from | Минимальная стоимость за клик | 0-200 |
cost_to | Максимальная стоимость за клик | 0-200 |
concurrency_from | Минимальное значение конкуренции | 1-100 |
concurrency_to | Максимальное значение конкуренции | 1-100 |
url | Фильтрация по url | string |
keywords | Фильтрация по словам (список слов через запятую) | string |
minus_keywords | Фильтрация по минус словам (список слов через запятую) | string |
exact_url | Искать только точное вхождение url | 1 - активен |
pm_url | Искать только частичное вхождение url | 1 - активен |
Для сортировки результата используйте параметры:
sort : поле, по которому нужно выполнить сортировку.
order : направление сортировки (asc — по возрастанию, desc — по убыванию).
Метрики | Описание |
result | Инкапсулирует в себе ответ |
total |
Количество найденных ключевых фраз, по которым ранжируется данный домен в топ-100 |
region_queries_count | Частотность ключевой фразы в выбранном регионе |
domain | Домен, который ранжируется по ключевой фразе |
keyword | Ключевая фраза по которой ранжируется заданный сайт |
keyword_length | Количество слов, разделенных пробелом в ключевой фразе |
url | URL, который отображается в поисковой выдаче по данному запросу |
right_spelling | Рекомендация к исправлению для ключевой фразы с орфографической ошибкой |
dynamic | Показывает, как изменилась позиция заданной ключевой фразы |
found_results |
Количество найденных результатов по ключевой фразе ""keywords"" |
keyword_crc | Контрольная сумма для быстрого поиска |
url_crc | crc код от переменной ""url"" |
cost | Цена за клик, $ |
concurrency | Конкуренция ключевой фразы в PPC (0-100) |
position | Позиция ключевой фразы в поисковой выдаче |
keyword_id | ID ключевой фразы в нашей базе |
subdomain | Поддомен сайта, который отображается в поисковой выдаче по заданной фразе |
types | Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое ). |
geo_names |
Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой.
|
status_msg | Ответ: "OK" или "Error" сообщает об удачном или неудачном запросе |
status_code | Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта) |
left_lines | Количество оставшихся API строк |
Часть ответа API, за которую снимается 1 лимит:
{
"domain": "example.com",
"subdomain": "www.example.com",
"keyword": "gmail и мой домен",
"keyword_length": 4,
"url": "https://www.example.com/",
"position": 43,
"types": [
"related_search",
"video"
],
"found_results": 60,
"cost": 0,
"concurrency": 0,
"region_queries_count": 1,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 0,
"dynamic": null,
"_id": "66411178-43"
},
2.1.4. Список URL-адресов домена (domain_urls)
domain_urls — метод возвращает URL-ы домена и количество ключевых слов для URL-а.
Пагинация
Для пагинации используйте параметры:
page_size : количество результатов на страницу (по умолчанию — 100, максимум — 1000).
page : номер страницы (по умолчанию — 1-я страница).
Metrics | Description |
result | Инкапсулирует в себе ответ |
total | Количество найденных ключевых фраз, по которым ранжируется данный домен в топ-100 |
url | Страница |
keyword | Ключевая фраза по которой ранжируется заданный сайт |
status_msg | Ответ: "OK" или "Error" сообщает об удачном или неудачном запросе |
status_code | Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта) |
left_lines | Количество оставшихся API строк |
Часть ответа API, за которую снимается 1 лимит:
{
"url": "http://example.com/",
"keywords": 182
}
2.1.5. Сравнение доменов (domains_intersection)
domains_intersection — метод возвращает общие ключевые слова для доменов.
Пагинация
Для пагинации используйте параметры:
page_size : количество результатов на страницу (по умолчанию — 100, максимум — 1000).
page : номер страницы (по умолчанию — 1-я страница).
Метрики | Описание |
result | Инкапсулирует в себе ответ |
total | Количество найденных ключевых фраз, по которым ранжируется данный домен в топ-100 |
region_queries_count | Частотность ключевой фразы в выбранном регионе |
keyword | Ключевая фраза по которой ранжируется заданный сайт |
keyword_length | Количество слов, разделенных пробелом в ключевой фразе |
keyword_id | ID ключевой фразы в нашей базе |
keyword_crc | Контрольная сумма для быстрого поиска |
types | Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое) |
found_results | Количество найденных результатов по ключевой фразе ""keywords"" |
cost | Цена за клик, $ |
concurrency | Конкуренция ключевой фразы в PPC (0-100) |
region_queries_count_wide | Частотность ключевой фразы в широком соответствии |
url_crc | crc код от переменной ""url"" |
domain 1,2,3 | Позиции сравниваемых доменов для данного ключевого слова |
geo_names | Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой. |
status_msg | Ответ: "OK" или "Error" сообщает об удачном или неудачном запросе |
status_code | Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта) |
left_lines | Количество оставшихся API строк |
Часть ответа API, за которую снимается 1 лимит:
{
"keyword": "regnm домен",
"keyword_length": 2,
"types": [
"related_search",
"pic",
"ads_top",
"ads_bot",
"snip_reviews_stars",
"snip_breadcrumbs"
],
"found_results": 6260000,
"cost": 0,
"concurrency": 0,
"region_queries_count": 1,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 0,
"domain1": "example.com",
"subdomain1": null,
"url1": "http://example.com/",
"position1": 86,
"dynamic1": null,
"domain3": "google.com",
"subdomain3": "support.google.com",
"url3": "https://support.google.com/domains/answer/4491208?hl=ru",
"position3": 40,
"dynamic3": null,
"domain2": "serpstat.com",
"subdomain2": null,
"url2": "https://serpstat.com/ru/blog/poisk-drop-domenov-kak-najti-istekshie-domeni-i-viyavit-potentcialnie-dropi/",
"position2": 59,
"dynamic2": null
}
2.1.6. Общие и уникальные ключевые слова (domains_uniq_keywords)
domains_uniq_keywords — метод возвращает ключевые слова домена без учета ключевых слов второго (третьего) домена.
Пагинация
Для пагинации необходимо использовать параметры:
- page_size : количество результатов на страницу (по умолчанию 100, максимум 1000)
- page : номер страницы (по умолчанию 1-я страница)
Для фильтрации результатов можно использовать следующие параметры:
Параметр | Описание | Возможные значения |
queries_from | Минимальное количество запросов в месяц | 0-100000000 |
queries_to | Максимальное количество запросов в месяц | 0-100000000 |
cost_from | Минимальная стоимость за клик | 0-200 |
cost_to | Максимальная стоимость за клик | 0-200 |
concurrency_from | Минимальное значение конкуренции | 1-100 |
concurrency_to | Максимальное значение конкуренции | 1-100 |
Метрики | Описание |
result | Инкапсулирует в себе ответ |
total | Количество найденных ключевых фраз, по которым ранжируется данный домен в топ-100 |
region_queries_count | Частотность ключевой фразы в выбранном регионе |
domain | Домен |
keyword_length | Количество слов, разделенных пробелом в ключевой фразе |
keyword | Ключевая фраза по которой ранжируется заданный сайт |
url | URL страницы, которая отображается в SERP по заданной ключевой фразы |
dynamic | Показывает, как изменилась позиция заданной ключевой фразы |
traff | Индекс, который показывает ориентировочный трафик на сайт (количество посетителей) |
keyword_crc | Контрольная сумма для быстрого поиска |
found_results | Количество найденных результатов по ключевой фразе ""keywords"" |
url_crc | CRC код от переменной ""url"" |
cost | Цена за клик, $ |
concurrency | Конкуренция ключевой фразы в PPC (0-100) |
position | Позиция ключевой фразы в поисковой выдаче |
keyword_id | ID ключевой фразы в нашей базе |
subdomain | Поддомен сайта, который отображается в поисковой выдаче по заданной фразе |
region_queries_count_wide | Частотность ключевой фразы в широком соответствии |
types | Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое ). |
geo_names | Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой. |
status_msg | Ответ: "OK" или "Error" сообщает об удачном или неудачном запросе |
status_code | Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта) |
left_lines | Количество оставшихся API строк |
Часть ответа API, за которую снимается 1 лимит:
{
"domain": "example.com",
"subdomain": null,
"keyword": "use somebody",
"keyword_length": 2,
"url": "https://example.com/",
"position": 16,
"types": [
"related_search",
"video",
"pic",
"refine_by_brand"
],
"found_results": 90,
"cost": 0,
"concurrency": 0,
"region_queries_count": 10,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 0,
"dynamic": null,
"_id": "92473146-76",
"google.com": 30,
"example.com": 56
}
2.1.7. Домены-конкуренты в поисковой выдаче (competitors)
competitors — метод возвращает список доменов-конкурентов из топ-20 поисковой выдачи Google.
Этот метод работает для ключей и для доменов.
Метрики | Описание |
result | Инкапсулирует в себе ответ |
domain | Домен |
visible | Видимость сайта |
keywords | Количество найденных ключевых фраз в выбранной поисковой системе |
traff | Индекс, который показывает ориентировочный трафик на сайт (количество посетителей) |
visible_dynamic | Динамика изменения видимости по сравнению с последней датой обновления |
keywords_dynamic | Изменение количества ключевых фраз за период времени N |
traff_dynamic | Изменение трафика за последний период времени N |
ads_dynamic | Изменение количества ключевых фраз в контекстной рекламе |
new_keywords | Количество новых ключевых фраз которые появились у домена за последние N-дней |
out_keywords | Количество ключевых фраз которые потерял домен за последние N-дней |
rised_keywords | Ключевые фразы, по которым выросли позиции за последние N-дней |
down_keywords | Ключевые фразы,. по которым упали позиции за последние N-дней |
ad_keywords | Количество ключевых фраз в PPC |
ads | Количество объявлений |
intersected | Количество фраз у домена, которые содержат искомую фразу |
relevance | Общая релевантность домена к искомой фразе |
status_msg | Ответ: "OK" или "Error" сообщает об удачном или неудачном запросе |
status_code | Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта) |
left_lines | Количество оставшихся API строк |
Часть ответа API, за которую снимается 1 лимит:
{
"domain": "kicksusa.com",
"visible": 10.99955,
"keywords": 300529,
"traff": 4565959,
"visible_dynamic": -1.14701,
"keywords_dynamic": -256,
"traff_dynamic": -1043552,
"ads_dynamic": 0,
"new_keywords": 3644,
"out_keywords": 3900,
"rised_keywords": 3914,
"down_keywords": 5986,
"ad_keywords": 1,
"ads": 1,
"intersected": 209719,
"not_intersected": 90810,
"relevance": 69.78,
"new_relevance": 8.99,
"our_relevance": 9.36
}
2.1.8. Отчет по рекламе с указанным именем домена (ad_keywords)
ad_keywords — метод выполняет поиск рекламных объявлений по домену или ключу.
Пагинация
Для пагинации используйте параметры:
page_size : количество результатов на страницу (по умолчанию — 100, максимум — 1000).
page : номер страницы (по умолчанию 1-я страница).
Для фильтрации результатов используйте следующие параметры:
Параметр | Описание | Возможные значения |
position_from | Минимальная позиция ключевого слова | 1-100 |
position_to | Максимальная позиция ключевого слова | 1-100 |
queries_from | Минимальное количество запросов в месяц | 0-100000000 |
queries_to | Максимальное количество запросов в месяц | 0-100000000 |
cost_from | Минимальная стоимость за клик | 0-200 |
cost_to | Максимальная стоимость за клик | 0-200 |
concurrency_from | Минимальное значение конкуренции | 1-100 |
concurrency_to | Максимальное значение конкуренции | 1-100 |
right_spelling | Фильтрация по фразам с неправильным написанием | not_contains - содержит фразы с неправильным написанием; contains - не содержит фразы с неправильным написанием |
Для сортировки результата используйте параметры:
sort : поле, по которому нужно выполнить сортировку.
order : направление сортировки (asc — по возрастанию, desc — по убыванию).
Метрики | Описание |
result | Инкапсулирует в себе ответ |
total | Количество найденных объявлений, которые отображаются по запросам, содержащие искомую фразу |
hits | Инкапсулирует в себе ответ |
region_queries_count | Частотность ключевой фразы в выбранном регионе |
region_queries_count_wide | Частотность ключевой фразы в широком соответствии |
region_queries_count_last | Частотность ключевой фразы за последний месяц |
domain | Домен |
keyword_length | Количество слов, разделенных пробелом в ключевой фразе |
keyword | Ключевая фраза, по которой отображается объявление |
title | Заголовок объявления |
url | Url объявления |
text | Текст объявления |
found_results | Количество найденных результатов по ключевой фразе ""keyword" |
url_crc | CRC код от переменной ""url"" |
CRC | Контрольная сумма для быстрого поиска |
cost | Цена за клик, $ |
concurrency | Конкурентность в контекстной рекламе (0-100) |
position | Позиции объявлений в контекстной рекламе |
date | Дата актуализации объявления |
keywords_id | ID ключевой фразы в нашей базе |
subdomain | Поддомен |
type | Место размещения объявления в SERP (1. Над; 2. Под; 3. Справа) |
types | Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое ) |
geo_names | Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой. |
status_msg | Ответ: "OK" или "Error" сообщает об удачном или неудачном запросе |
status_code | Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта) |
left_lines | Количество оставшихся API строк |
Часть ответа API, за которую снимается 1 лимит:
{
"keyword": "nike air force 1",
"keyword_length": 4,
"domain": "nike.com",
"subdomain": "www.nike.com",
"url": "https://www.nike.com/w/air-force-1-shoes-5sj3yzy7ok?cp=15839883195_search_%7Cnike+air+force+1%7CGOOGLE%7C71700000042134106%7CAll_X_X_X_X-Device_X_AF1-General_Exact%7Ce%7Cc&gclid=EAIaIQobChMIj6f9r4Sx5QIVR3ZgCh360Qx6EAAYASAAEgL9FPD_BwE&gclsrc=aw.ds",
"title": "Nike Air Force 1 | Nike Official Site",
"text": "Shop The Official Nike Store For The Latest Nike Shoes, Apparel & Gear.",
"position": 1,
"type": 1,
"cost": 0.71,
"concurrency": 100,
"found_results": 69,
"region_queries_count": 90500,
"region_queries_count_wide": 0,
"region_queries_count_last": 0,
"types": [
"related_search",
"also_asks",
"ads_top",
"shopping_top"
],
"geo_names": [
],
"_id": "24829288_1"
}
2.1.9. Страницы-лидеры домена (get_top_urls)
В этом отчете вы найдете все страницы анализируемого домена в иерархическом порядке. Кроме того, он показывает количество ключевых фраз, по которым страница ранжируется в топе, потенциальный трафик, количество шейров в социальных сетях Facebook, LinkedIn.
Метод get_top_urls может работать продолжительное время, из-за специфики сбора данных.
По умолчанию результаты отсортированы по количеству фраз, по убыванию: order=desc&sort=organic_keywords.
Пагинация
Для пагинации используйте параметры:
- page_size: количество результатов на страницу (по умолчанию — 100, максимум —1000).
- page: номер страницы (по умолчанию — 1-я страница) — каждое изменение параметра считается новым запросом и влияет на лимиты.
Сортировка
Для сортировки используйте параметры:
- sort: поле, по которому нужно выполнить сортировку (organic_keyword, facebook_shares, linkedin_shares, potencial_traff). Например, sort=organic_keywords&page_size=100 .
- order: сортировка по убыванию "desc" или по возрастанию "asc" ( default: desc ). Например, order=desc .
Metrics | Description |
result | Инкапсулирует в себе ответ |
total | Всего найдено страниц у домен |
top_urls | Инкапсулирует с в себе ответ |
url |
URL домена |
organic_keywords | Общее количество ключевых фраз, по которым ранжируется страница в Google топ-100 или Яндекс топ-50 |
facebook_shares | Количестве шейров в социальной сети Facebook, которое получила страница анализируемого домена |
potencial_traff | Количество посетителей в месяц, которые страница получит в том случае, если займет по всем фразам из топ-20 первую позицию в поисковой выдаче Google или Yandex. Данный показатель рассчитывается исходя из соотношения реального и максимально возможного трафика |
status_msg | Ответ: "OK" или "Error" сообщает об удачном или неудачном запросе |
status_code | Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта) |
left_lines | Количество оставшихся API строк |
2.1.10. Суммарный отчет по домену V4 (SerpstatDomainProcedure.getDomainsInfo)
SerpstatDomainProcedure.getDomainsInfo — метод возвращает суммарную информацию по массиву доменов.
Параметры запроса:
Название | Описание | Опциональный | Варианты значений |
domains | Массив доменов | нет | ["allo.ua", "citrus.ua" ] |
se | Идентификатор поисковой базы, по которой будет проходить поиск | нет | g_ua, y_213 |
Параметры ответа:
Параметры | Описание |
result | Инкапсулирует в себе ответ |
visible | Видимость сайта |
keywords | Количество найденных ключевых фраз в выбранной поисковой системе |
traff |
Индекс, который показывает ориентировочный трафик на сайт (количество посетителей)
|
visible_dynamic | Динамика изменения видимости по сравнению с последней датой обновления |
keywords_dynamic | Изменение количества ключевых фраз за последние 2 недели |
traff_dynamic | Изменение трафика за последние 2 недели |
date | Дата текущей проверки видимости, ключевых фраз и трафика |
prev_date | Предыдущая дата проверки |
new_keywords | Количество новых ключевых фраз, которые появились у домена за последние 2 недели |
out_keywords | Количество ключевых фраз, которые потерял домен за последние 2 недели |
rised_keywords | Ключевые фразы, по которым выросли позиции за последние 2 недели |
down_keywords | Ключевые фразы, по которым упали позиции за последние 2 недели |
ad_keywords | Количество ключевых фраз в PPC |
ads | Количество объявлений в PPC |
ads_dynamic | История изменений в объявлениях PPC |
left_lines | Количество оставшихся API строк |
Лимиты: за каждый домен, по которому получена информация снимается 1 лимит. Часть ответа API, за которую снимается 1 лимит:
{
"domain": "allo.ua",
"visible": 1427.64772,
"keywords": 21834506,
"traff": 137705752,
"visible_dynamic": -51.550359999999955,
"keywords_dynamic": -76425,
"traff_dynamic": 17517324,
"ads_dynamic": 18237,
"new_keywords": 17040,
"out_keywords": 17179,
"rised_keywords": 21708,
"down_keywords": 44294,
"ad_keywords": 161823,
"ads": 122695,
"visible_mysql": 0,
"prev_date": "2020-01-27"
}
2.1.11. История по домену V4 (SerpstatDomainProcedure.getDomainsHistory)
SerpstatDomainProcedure.getDomainsHistory — метод возвращает историю изменения видимости и количества фраз по домену.
Параметры запроса:
Метрика |
Описание |
Опциональный |
Значение по умолчанию |
Варианты значений |
domain |
Имя домена |
нет |
- |
|
se |
Идентификатор поисковой базы, по которой будет проходить поиск |
нет |
- |
g_ua |
sort |
Порядок сортировки результатов в формате: {{{field}}: {{order}}} order - направление сортировки (asc — по возрастанию, desc — по убыванию)
|
да |
- |
{"ads":"desc"} |
page |
Номер страницы в ответе |
да |
1 |
5 |
size |
Количество результатов на страницу в ответе |
да |
100 |
100-1000 |
Сортировка результатов возможна по следующим полям:
Параметр |
date
|
down_keywords
|
visible
|
rised_keywords
|
keywords
|
traff |
visible_static |
new_keywords |
out_keywords |
down_keywords |
ad_keywords |
Метрики ответа:
Метрики |
Описание |
result |
Инкапсулирует в себе ответ |
visible |
Видимость сайта |
domain |
Домен |
keywords |
Количество найденных ключевых фраз в выбранной поисковой системе |
traff |
Индекс, который показывает ориентировочный органический трафик на сайт (количество посетителей) |
date |
Дата текущей проверки видимости, ключевых фраз и трафика |
new_keywords |
Количество новых ключевых фраз, которые появились у домена за последние 2 недели |
out_keywords |
Количество ключевых фраз, которые потерял домен за последние 2 недели |
rised_keywords |
Ключевые фразы, по которым выросли позиции за последние 2 недели |
down_keywords |
Ключевые фразы, по которым упали позиции за последние 2 недели |
ad_keywords |
Количество ключевых фраз в PPC |
ads |
Количество объявлений в PPC |
left_lines |
Количество оставшихся API строк |
Лимиты: количество списанных лимитов соответствует количеству полученных результатов. Часть ответа API, за которую снимается 1 лимит:
{
"domain": "google.com",
"rised_keywords": 176915,
"visible": 5995.61211,
"traff": 120802965,
"keywords": 3964146,
"visible_static": 5995.61211,
"date": "2018-07-05",
"ads": 1662,
"new_keywords": 184914,
"down_keywords": 232468,
"ad_keywords": 7638,
"out_keywords": 146804
}
2.1.12. Ключевые слова в топе поисковой системы по домену V4 (SerpstatDomainProcedure.getDomainKeywords)
SerpstatDomainProcedure.getDomainKeywords — метод возвращает ключевые слова в топе поисковой системы по домену. Вы можете выгрузить до 60000 результатов, используя данный метод.
Параметры запроса:
Название |
Описание |
Опциональный |
Значение по умолчанию |
Варианты значений |
domain |
Имя домена |
нет |
allo.ua |
|
se |
Идентификатор поисковой базы, по которой будет проходить поиск |
нет |
g_ua, y_213 |
|
url |
Ссылка уточнения поиска |
да |
null |
https://allo.ua |
keywords |
Массив ключевых фраз, для которых будет происходить поиск |
да |
[] |
["купить"] |
minusKeywords |
Массив минус-слов при поиске |
да |
[] |
["алло", "ало"] |
filters |
Условия фильтрации |
да |
|
{ "concurrency_from": "0", "concurrency_to": "1" }
|
sort |
Порядок сортировки результатов в формате: {{{field}}: {{order}}} order - направление сортировки (asc — по возрастанию, desc — по убыванию)
|
да |
{"position": "asc", "region_queries_count":"desc"} |
{"cost": "asc"} |
page |
Номер страницы в ответе |
да |
1 |
5 |
size |
Количество результатов на страницу в ответе |
да |
100 |
"size": {{page_size}} |
Сортировка результатов возможна по следующим полям:
Параметр |
region_queries_count
|
types |
cost |
keyword_length |
concurrency |
geo_names |
traff |
region_queries_count_wide |
dynamic |
position |
found_results |
Для фильтрации результатов используйте следующие параметры:
Параметр | Описание | Возможные значения |
position_from | Минимальная позиция ключевого слова | 1-100 |
position_to | Максимальная позиция ключевого слова | 1-100 |
queries_from | Минимальное количество запросов в месяц | 0-100000000 |
queries_to | Максимальное количество запросов в месяц | 0-100000000 |
cost_from | Минимальная стоимость за клик | 0-200 |
cost_to | Максимальная стоимость за клик | 0-200 |
concurrency_from | Минимальное значение конкуренции | 0-100 |
concurrency_to | Максимальное значение конкуренции | 0-100 |
Параметры ответа:
Параметр |
Описание |
result |
Инкапсулирует в себе ответ |
total |
Количество найденных ключевых фраз, по которым ранжируется данный домен в топ-100 |
region_queries_count |
Частотность ключевой фразы в выбранном регионе |
domain |
Домен, который ранжируется по ключевой фразе |
keyword |
Ключевая фраза по которой ранжируется заданный сайт |
keyword_length |
Количество слов, разделенных пробелом в ключевой фразе |
url |
URL, который отображается в поисковой выдаче по данному запросу |
right_spelling |
Рекомендация к исправлению для ключевой фразы с орфографической ошибкой |
dynamic |
Показывает, как изменилась позиция заданной ключевой фразы |
found_results |
Количество найденных результатов по ключевой фразе ""keywords"" |
cost |
Цена за клик, $ |
concurrency |
Конкуренция ключевой фразы в PPC (0-100) |
position |
Позиция ключевой фразы в поисковой выдаче |
subdomain |
Поддомен сайта, который отображается в поисковой выдаче по заданной фразе |
types |
Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое ). |
geo_names |
Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой. |
left_lines |
Количество оставшихся API строк |
Часть ответа API, за которую снимается 1 лимит:
{
"domain": "google.com",
"subdomain": "translate.google.com",
"keyword": "переводчик",
"keyword_length": 1,
"url": "https://translate.google.com/?hl=ru",
"position": 1,
"types": [
"pic",
"a_box_translation",
"related_search"
],
"found_results": 39600000,
"cost": 0.2,
"concurrency": 0,
"region_queries_count": 9140000,
"region_queries_count_wide": 6120000,
"geo_names": [
],
"traff": 9140000,
"dynamic": 0
}
2.1.13. Список URL-адресов домена V4 (SerpstatDomainProcedure.getDomainUrls)
SerpstatDomainProcedure.getDomainUrls — метод возвращает URL домена и количество ключевых слов для URL.
Параметры запроса:
Название |
Описание |
Опциональный |
Значение по умолчанию |
Варианты значений |
domain |
Имя домена |
нет |
- |
allo.ua |
se |
Идентификатор поисковой базы, по которой будет проходить поиск |
нет |
- |
g_ua, g_ru, ... |
sort |
Порядок сортировки результатов в формате: {{{field}}: {{order}}} order - направление сортировки (asc — по возрастанию, desc — по убыванию)
|
да |
{"keywords":"desc"} |
{"keywords":"asc"} |
page |
Номер страницы в ответе |
да |
1 |
5 |
size |
Количество результатов на страницу в ответе |
да |
100 |
"size": {{page_size}} |
Сортировка результатов возможна по следующим поля:
Параметр |
keywords
|
Параметры ответа:
Параметр |
Описание |
result |
Инкапсулирует в себе ответ |
total |
Количество найденных URL |
url |
Страница |
keyword |
Количество ключевых фраз по которой ранжируется данная страница |
left_lines |
Количество оставшихся API строк |
Лимиты: Количество списанных лимитов соответствует количеству полученных результатов по запросу. Часть ответа API, за которую снимается 1 лимит:
{
"url": "https://play.google.com/store?hl=ru",
"keywords": 4938
}
2.1.14. Сравнение доменов V4 (SerpstatDomainProcedure.getDomainsIntersection)
SerpstatDomainProcedure.getDomainsIntersection — метод возвращает общие ключевые слова для доменов.
Параметры запроса:
Название |
Описание |
Опциональный |
Значение по умолчанию |
Варианты значений |
domains |
массив доменов min2, max3 |
нет |
["allo.ua", "citrus.ua"] |
|
se |
Идентификатор поисковой базы, по которой будет проходить поиск |
нет |
g_ua, g_ru, ... |
|
page |
Номер страницы в ответе |
да |
1 |
5 |
size |
Количество результатов на страницу в ответе |
да |
100 |
"size": {{page_size}} |
Метрики ответа:
Метрики | Описание |
result | Инкапсулирует в себе ответ |
total | Количество найденных ключевых фраз, по которым ранжируется данный домен в топ-100 |
region_queries_count | Частотность ключевой фразы в выбранном регионе |
keyword | Ключевая фраза по которой ранжируется заданный сайт |
keyword_length | Количество слов, разделенных пробелом в ключевой фразе |
keyword_id | ID ключевой фразы в нашей базе |
keyword_crc | Контрольная сумма для быстрого поиска |
types | Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое) |
found_results | Количество найденных результатов по ключевой фразе ""keywords"" |
cost | Цена за клик, $ |
concurrency | Конкуренция ключевой фразы в PPC (0-100) |
region_queries_count_wide | Частотность ключевой фразы в широком соответствии |
url_crc | crc код от переменной ""url"" |
domain 1,2,3 | Позиции сравниваемых доменов для данного ключевого слова |
geo_names | Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой. |
traff | Индекс, который показывает ориентировочный трафик на сайт (количество посетителей) |
subdomain 1,2,3 | Поддомен сайта, который отображается в поисковой выдаче по заданной фразе |
url 1,2,3 | URL страницы, которая отображается в SERP по заданной ключевой фразы |
position 1,2,3 | Позиция ключевой фразы в поисковой выдаче |
dynamic 1,2,3 | Показывает, как изменилась позиция заданной ключевой фразы |
left_lines | Количество оставшихся API-строк |
Лимиты: Количество списанных лимитов соответствует количеству полученных результатов по запросу. Часть ответа API, за которую снимается 1 лимит:
{
"keyword": "знімок екрану леново",
"keyword_length": 3,
"types": [
"pic",
"related_search",
"also_asks"
],
"found_results": 100,
"cost": 0,
"concurrency": 0,
"region_queries_count": 1,
"region_queries_count_wide": 0,
"geo_names": [
],
"traff": 0,
"domain3": "rozetka.ua",
"subdomain3": "i1.rozetka.ua",
"url3": "https://i1.rozetka.ua/goods/documents/1079791/lenovo_vibe_k5_note_pro_silver_documents_1079791792.pdf",
"position3": 19,
"dynamic3": null,
"domain2": "citrus.ua",
"subdomain2": "www.citrus.ua",
"url2": "https://www.citrus.ua/planshety/lenovo-yoga3-x50f-16gbl-za0h0060ua-608291.html",
"position2": 42,
"dynamic2": null,
"domain1": "allo.ua",
"subdomain1": "blog.allo.ua",
"url1": "https://blog.allo.ua/obzor-smartfona-lenovo-vibe-x2_2014-11-13/",
"position1": 30,
"dynamic1": null
}
2.1.15. Общие и уникальные ключевые слова V4 (SerpstatDomainProcedure.getDomainsUniqKeywords)
SerpstatDomainProcedure.getDomainsUniqKeyword — метод возвращает ключевые фразы домена без учета ключевых фраз минус-домена.
Параметры запроса:
Название |
Описание |
Тип данных |
Опциональный |
Значение по умолчанию |
Варианты значений |
domains |
массив имен доменов min 1, max 2 |
array |
нет |
["allo.ua", "citrus.ua"] |
|
minusDomain |
имя домена, ключевые фразы которого, не должны пересекаться с доменами параметра domains |
string |
нет |
--- |
|
se |
Идентификатор поисковой базы, по которой будет проходить поиск |
string |
нет |
g_ua, g_ru, ... |
|
filters |
Условия фильтраци |
array |
да |
--- |
{"queries_from": 10} |
page |
Номер страницы в ответе |
int |
да |
1 |
5 |
size |
Количество результатов на страницу в ответе |
int |
да |
100 |
"size": {{page_size}} |
Для фильтрации результатов используйте следующие параметры:
Параметр | Описание | Возможные значения |
queries_from | Минимальная частотность в месяц | 0-100000000 |
queries_to | Максимальная частотность в месяц | 0-100000000 |
cost_from | Минимальная стоимость за клик | 0-200 |
cost_to | Максимальная стоимость за клик | 0-200 |
concurrency_from | Минимальное значение конкуренции ключевой фразы в PPC | 0-100 |
concurrency_to | Максимальное значение конкуренции ключевой фразы в PPC | 0-100 |
Метрики ответа:
Метрики |
Описание |
result |
Инкапсулирует в себе ответ |
total |
Количество найденных ключевых фраз, по которым ранжируется данный домен в топ-100 |
region_queries_count |
Частотность ключевой фразы в выбранном регионе |
domain |
Домен |
keyword_length |
Количество слов, разделенных пробелом в ключевой фразе |
keyword |
Ключевая фраза по которой ранжируется заданный сайт |
url |
URL страницы, которая отображается в SERP по заданной ключевой фразы |
date |
Дата проверки поисковой выдачи |
dynamic |
Показывает, как изменилась позиция заданной ключевой фразы |
traff |
Индекс, который показывает ориентировочный трафик на сайт (количество посетителей) |
found_results |
Количество найденных результатов по ключевой фразе ""keywords"" |
cost |
Цена за клик, $ |
concurrency |
Конкуренция ключевой фразы в PPC (0-100) |
position |
Позиция ключевой фразы в поисковой выдаче |
subdomain |
Поддомен сайта, который отображается в поисковой выдаче по заданной фразе |
region_queries_count_wide |
Частотность ключевой фразы в широком соответствии |
types |
Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое ). |
geo_names |
Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой. |
left_lines |
Количество оставшихся API строк |
Лимиты: Количество списанных лимитов соответствует количеству полученных результатов по запросу. Часть ответа API, за которую снимается 1 лимит:
{
"domain": "allo.ua",
"subdomain": null,
"keyword": "купить дом в чернигове бу",
"keyword_length": 5,
"url": "https://allo.ua/ru/mobilnye-telefony-i-sredstva-svyazi/",
"position": 42,
"date": "2019-04-08",
"types": [
"pic",
"related_search"
],
"found_results": 62,
"cost": 0,
"concurrency": 0,
"region_queries_count": 1,
"region_queries_count_wide": 0,
"geo_names": [
"чернигове"
],
"traff": 0,
"dynamic": 15,
"citrus.ua": 40,
"allo.ua": 42
}
2.1.16. Домены-конкуренты в поисковой выдаче V4 (SerpstatDomainProcedure.getCompetitors)
SerpstatDomainProcedure.getCompetitors — метод возвращает список доменов-конкурентов из топ-20 поисковой выдачи Google
Параметры запроса:
Название |
Описание |
Опциональный |
Значение по умолчанию |
Варианты значений |
domain |
Имя домена |
нет |
||
se |
Идентификатор поисковой базы, по которой будет проходить поиск |
нет |
g_ua |
|
sort |
Порядок сортировки результатов в формате: {{{field}}: {{order}}} order - направление сортировки (asc — по возрастанию, desc — по убыванию)
|
да |
{"relevance":"desc"} |
{"ads":"desc"} |
page |
Номер страницы в ответе |
да |
1 |
5 |
size |
Количество результатов на страницу в ответа |
да |
100 |
50-1000 |
Сортировка результатов возможна по следующим поля:
Параметр |
visible |
keywords |
traff |
visible_dynamic |
keywords_dynamic |
traff_dynamic |
ads_dynamic |
new_keywords |
out_keywords |
rised_keywords |
down_keywords |
ad_keywords |
ads |
intersected |
relevance |
new_relevance |
our_relevance |
Метрики ответа:
Метрики | Описание |
result | Инкапсулирует в себе ответ |
domain | Домен |
visible | Видимость сайта |
keywords | Количество найденных ключевых фраз в выбранной поисковой системе |
traff | Индекс, который показывает ориентировочный трафик на сайт (количество посетителей) |
visible_dynamic | Динамика изменения видимости по сравнению с последней датой обновления |
keywords_dynamic | Изменение количества ключевых фраз за период времени N |
traff_dynamic | Изменение трафика за последний период времени N |
ads_dynamic | Изменение количества ключевых фраз в контекстной рекламе |
new_keywords | Количество новых ключевых фраз которые появились у домена за последние N-дней |
out_keywords | Количество ключевых фраз которые потерял домен за последние N-дней |
rised_keywords | Ключевые фразы, по которым выросли позиции за последние N-дней |
down_keywords | Ключевые фразы,. по которым упали позиции за последние N-дней |
ad_keywords | Количество ключевых фраз в PPC |
ads | Количество объявлений |
intersected | Количество фраз у домена, которые содержат искомую фразу |
relevance | Общая релевантность домена к искомой фразе |
left_lines | Количество оставшихся API строк |
Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу. Часть ответа API, за которую снимается 1 лимит:
{
"domain": "google.com",
"visible": 6292.39888,
"keywords": 514454762,
"traff": 2795219750,
"visible_dynamic": -132.55671,
"keywords_dynamic": 48860651,
"traff_dynamic": 927779,
"ads_dynamic": 554,
"new_keywords": 54740992,
"out_keywords": 5880341,
"rised_keywords": 1010039,
"down_keywords": 985120,
"ad_keywords": 62679,
"ads": 41551,
"intersected": 514454762,
"relevance": 100,
"new_relevance": 100,
"our_relevance": 100
}
2.1.17. Рекламные объявления по домену V4 (SerpstatDomainProcedure.getAdKeywords)
SerpstatDomainProcedure.getAdKeywords — метод выполняет поиск рекламных объявлений по домену.
Параметры запроса:
Описание |
Тип |
Опциональный |
Значение по умолчанию |
Варианты значений |
domain |
Имя домена |
нет |
||
se |
Идентификатор поисковой базы, по которой будет проходить поиск |
нет |
g_ua, g_ru, ... |
|
url |
Ссылка уточнения поиска |
да |
null |
|
keywords |
Массив ключевых фраз, для которого будет происходить поиск |
да |
[] |
["купить"] |
minusKeywords |
Массив минус-слов при поиске |
да |
[] |
["алло", "ало"] |
filters |
Условия фильтрации |
да |
|
{ "concurrency_from": "0", "concurrency_to": "1" }
|
sort |
Порядок сортировки результатов в формате: {{{field}}: {{order}}} order - направление сортировки (asc — по возрастанию, desc — по убыванию)
|
да |
{"position": "asc", "region_queries_count":"desc"} |
{"cost": "asc"} |
page |
Номер страницы в ответе |
да |
1 |
5 |
size |
Количество результатов на страницу в ответе |
да |
100 |
"size": {{page_size}} |
Сортировка результатов возможна по следующим полям:
Параметр |
keyword_length
|
position
|
type
|
cost
|
concurrency
|
found_results
|
region_queries_count
|
region_queries_count_wide
|
types
|
difficulty
|
geo_names
|
Для фильтрации результатов используйте следующие параметры:
Параметр | Описание | Возможные значения |
position_from | Минимальная позиция ключевого слова | 1-100 |
position_to | Максимальная позиция ключевого слова | 1-100 |
queries_from | Минимальное количество запросов в месяц | 0-100000000 |
queries_to | Максимальное количество запросов в месяц | 0-100000000 |
cost_from | Минимальная стоимость за клик | 0-200 |
cost_to | Максимальная стоимость за клик | 0-200 |
concurrency_from | Минимальное значение конкуренции | 0-100 |
concurrency_to | Максимальное значение конкуренции | 0-100 |
Метрики ответа:
Метрики |
Описание |
result |
Инкапсулирует в себе ответ |
total |
Количество найденных объявлений, которые отображаются по запросам, содержащим искомую фразу |
hits |
Инкапсулирует в себе ответ |
region_queries_count |
Частотность ключевой фразы в выбранном регионе |
region_queries_count_wide |
Частотность ключевой фразы в широком соответствии |
region_queries_count_last |
Частотность ключевой фразы за последний месяц |
domain |
Домен объявления |
keyword_length |
Количество слов, разделенных пробелом в ключевой фразе |
keyword |
Ключевая фраза, по которой отображается объявление |
title |
Заголовок объявления |
url |
Url объявления, который отображается в поисковой выдаче по данному запросу |
text |
Текст объявления, который отображается в поисковой выдаче по данному запросу |
found_results |
Количество найденных результатов по ключевой фразе ""keyword" |
url_crc |
CRC код от переменной ""url"" |
CRC |
Контрольная сумма для быстрого поиска |
cost |
Цена за клик, $ |
concurrency |
Конкурентность в контекстной рекламе (0-100) |
position |
Позиции объявлений в контекстной рекламе |
date |
Дата когда был пробит SERP |
keywords_id |
ID ключевой фразы в нашей базе |
subdomain |
Поддомен |
type |
Место размещения объявления в SERP (1. Над; 2. Под; 3. Справа) |
types |
Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое ) |
geo_names |
Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой. |
left_lines |
Количество оставшихся API строк |
Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу. Часть ответа API, за которую снимается 1 лимит:
{
"keyword": "gmail.coṃ",
"keyword_length": 1,
"domain": "google.com",
"subdomain": "gsuite.google.com",
"url": "https://gsuite.google.com/intl/ru/products/gmail/",
"title": "Рабочая почта Gmail от Google | Работайте там, где вам удобно",
"text": "Надежная почта, онлайн хранение, календарь, видеочат.",
"position": 1,
"type": 1,
"cost": 0.05,
"concurrency": 7,
"found_results": 13,
"region_queries_count": 74000,
"region_queries_count_wide": 0,
"types": [
"pic",
"ads_top"
],
"geo_names": [
]
}
2.1.18. Страницы-лидеры домена V4 (SerpstatDomainProcedure.getTopUrls)
SerpstatDomainProcedure.getTopUrls — метод возвращает лучшие страницы анализируемого домена по количеству ключевых фраз в региональной выдаче поисковой системы. Также он показывает потенциальный трафик, количество шейров в Facebook.
Данный метод может работать продолжительное время, из-за специфики сбора данных. По умолчанию результаты отсортированы по количеству фраз, по убыванию.
Параметры запроса:
Название | Описание | Тип | Опциональный | Значение по умолчанию | Варианты значений |
---|---|---|---|---|---|
domain | Имя домена | string | нет | allo.ua | |
se | Идентификатор поисковой базы, по которой будет проходить поиск | string | нет | g_ua, g_ru, ... | |
sort |
Порядок сортировки результатов в формате: {{{field}}: {{order}}} order - направление сортировки (asc — по возрастанию, desc — по убыванию)
|
json object | да | {"organic_keywords":"desc"} | {"organic_keywords":"desc"} |
filters | Условия фильтрации | json object | да | --- |
{"url_prefix": "https://allo.ua/ru/products/"} {"url_contain": "style"} {"url_not_contain": "style"} |
page | Номер страницы в ответе | int | да | 1 | 5 |
size | Количество результатов на страницу в ответе | int | да | 100 | 50-1000 |
Сортировка результатов возможна по следующим поля:
Параметр |
organic_keywords |
facebook_shares |
potencial_traff |
Метрики ответа:
Метрика | Описание |
result | Инкапсулирует в себе ответ |
total | Всего найдено страниц у домена |
url |
URL страницы |
organic_keywords | Общее количество ключевых фраз, по которым ранжируется страница в Google топ-100 или Яндекс топ-50 |
facebook_shares | Количестве шейров страницы в Facebook |
potencial_traff | Количество посетителей в месяц, которые страница получит в том случае, если займет по всем фразам из топ-20 первую позицию в поисковой выдаче Google или Yandex. Данный показатель рассчитывается исходя из соотношения реального и максимально возможного трафика. |
left_lines | Количество оставшихся API строк |
Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу.
{
"url": "https://photos.google.com/",
"organic_keywords": 20425,
"facebook_shares": 228162,
"potencial_traff": 11342451
}
2.1.19. Домены-конкуренты PPC V4 (SerpstatDomainProcedure.getAdsCompetitors)
SerpstatDomainProcedure.getAdsCompetitors — метод возвращает список доменов-конкурентов PPC
Параметры запроса:
Название |
Описание |
Опциональный |
Значение по умолчанию |
Варианты значений |
domain |
Имя домена |
нет |
||
se |
Идентификатор поисковой базы, по которой будет проходить поиск |
нет |
g_ua |
|
sort |
Порядок сортировки результатов в формате: {{{field}}: {{order}}} order - направление сортировки (asc — по возрастанию, desc — по убыванию)
|
да |
{"relevance":"desc"} |
{"ads":"desc"} |
page |
Номер страницы в ответе |
да |
1 |
5 |
size |
Количество результатов на страницу в ответа |
да |
100 |
50-1000 |
Сортировка результатов возможна по следующим поля:
Параметр |
ads |
keywords |
intersected |
missing_keywords |
Метрики ответа:
Метрики | Описание |
result | Инкапсулирует в себе ответ |
ads | Количество объявлений |
domain | Домен |
keywords | Количество найденных ключевых фраз в выбранной поисковой системе |
intersected | Количество фраз у домена, которые содержат искомую фразу |
left_lines | Количество оставшихся API строк |
Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу. Часть ответа API, за которую снимается 1 лимит:
{
"domain": "eldorado.ua",
"keywords": 1155,
"ads": 1319,
"intersected": 207,
"missing_keywords": 948
},
2.1.20. Получение статистики по лимитам V4 (SerpstatLimitsProcedure.getStats)
SerpstatLimitsProcedure.getStats — метод для проверки количества доступных и использованных дневных лимитов для API и расширения для браузеров Serpstat Website SEO Checker.
Лимиты за использование этого метода не снимаются.
Метрики ответа:
Название | Описание | Тип |
---|---|---|
max_lines |
Максимальное доступное в день количество API лимитов | int |
used_lines |
Количество использованных API лимитов за текущий день | int |
left_lines |
Количество доступных API лимитов на текущий день | int |
user_info | Информация пользователя API | json object |
user_id |
Идентификатор пользователя в Serpstat | int |
plugin_limits |
Информация по API-лимитам расширения для браузеров Serpstat | json object |
delayBetweenRequests |
Количество запросов к API расширения для браузеров Serpstat в секунду | int |
hasApiPlugin |
Наличие доступа к API расширения для браузеров Serpstat: |
bool |
total | Количество лимитов в день к API расширения для браузеров Serpstat | int |
used | Количество использованных лимитов за текущий день к API расширения | int |
left | Количество оставшихся лимитов на текущий день к API расширения | int |
2.1.20. Получение статистики по лимитам V4 (SerpstatLimitsProcedure.getStats)
SerpstatLimitsProcedure.getStats — метод для проверки количества доступных и использованных дневных лимитов для API и расширения для браузеров Serpstat Website SEO Checker.
Лимиты за использование этого метода не снимаются.
Метрики ответа:
Название | Описание | Тип |
---|---|---|
max_lines |
Максимальное доступное в день количество API лимитов | int |
used_lines |
Количество использованных API лимитов за текущий день | int |
left_lines |
Количество доступных API лимитов на текущий день | int |
user_info | Информация пользователя API | json object |
user_id |
Идентификатор пользователя в Serpstat | int |
plugin_limits |
Информация по API-лимитам расширения для браузеров Serpstat | json object |
delayBetweenRequests |
Количество запросов к API расширения для браузеров Serpstat в секунду | int |
hasApiPlugin |
Наличие доступа к API расширения для браузеров Serpstat: |
bool |
total | Количество лимитов в день к API расширения для браузеров Serpstat | int |
used | Количество использованных лимитов за текущий день к API расширения | int |
left | Количество оставшихся лимитов на текущий день к API расширения | int |