🏠 Главная API TOOLS Кластеризация

API для инструмента - Кластеризация и группировка запросов

Для инструмента «Кластеризация и группировка запросов» обязательные параметры:

tools_name=clustering - название инструмента
queries= список ключевых фраз в JSON формате. Например: &queries=["купить чемодан","купить чемодан в москве"]
ss= выбор поисковой системы: Яндекс = 1, Google = 2.
lr= регион поиска для Яндекса или Google. Для Google указываем id региона из файла.
group= метод группировки запросов. Возможные значения: hard или soft.
count= степень группировки. Возможные значения: от 2 до 10.
depth= глубина сбора, необязательный параметр, по умолчанию = 10. Возможные значения: 10, 20 и 30.
stoplist= стоп лист доменов в формате JSON. Пример: stoplist=["yandex.ru","auto.ru"]
ws= сбор частоты формата - ключевая фраза. Возможные значения: 1/0. ВАЖНО - для метода SOFT частотность включается автоматически и списывается 0.5 лимитов.
ws2= сбор частоты формата - "ключевая фраза". Возможные значения: 1/0.
ws3= сбор частоты формата - "!ключевая !фраза". Возможные значения: 1/0.
ws4= сбор частоты формата - "[!ключевая !фраза]". Возможные значения: 1/0.
main= исключение главных страниц. Возможные значения: 1/0.
url= URL адрес домена для сбора позиций. Параметр не работает, если position=0.

Возвращает JSON с ID задачи, пример ответа: {"task_id":3944}

Пример: https://arsenkin.ru/tools/api/task/set?token=ВАШ_ТОКЕН&tools_name=clustering&ss=1&lr=213&group=hard&count=3&depth=10&stoplist=["yandex.ru"]&ws2=1&main=1&comm=1&position=1&url=http://site.ru&queries=["\u0447\u0442\u043e \u0442\u0430\u043a\u043e\u0435 seo"]

Проверка статуса задачи: осуществляется посредством GET запроса на url https://arsenkin.ru/tools/api/task/check

Пример: https://arsenkin.ru/tools/api/task/check?token=ВАШ_ТОКЕН&task_id=ID_ЗАДАЧИ

Обязательные параметры:

task_id=12345 - ID задачи

Получение результата:

Осуществляется посредством GET запроса на url https://arsenkin.ru/tools/api/task/result

Пример: https://arsenkin.ru/tools/api/task/result?token=ВАШ_ТОКЕН&task_id=ID_ЗАДАЧИ

Обязательные параметры:

task_id=12345 - ID задачи

Возвращает JSON с результатами проверки, пример ответа:

{
  "result": {
    "clustered": {
      "купить чемодан": {
        "words": {
          "купить чемодан": {
            "main": 0,
            "ws": 28292,
            "ws_strict": 2244,
            "agregators": 0,
            "toponim": "-",
            "position": 4,
            "found_url": "https://sbermegamarket.ru/catalog/chemodany/",
            "comm": 100,
            "loc": 33,
            "geo": 1
          },
          "купить чемодан в москве": {
            "main": 0,
            "ws": 8568,
            "ws_strict": 541,
            "agregators": 0,
            "toponim": "москва",
            "position": 4,
            "found_url": "https://sbermegamarket.ru/catalog/chemodany/",
            "comm": 100,
            "loc": 44,
            "geo": 0
          }
        },
        "wssumm": 36860,
        "topurl": "https://boxvoyage.ru/chemodany-po-razmeram/"
      }
    }
  }
}

Расшифровка результатов

clustered - название кластера;
words - ключевые слова кластера;
wssumm - сумма частотности по всем фразам в группе. Считается обычная частота без операторов;
topurl - URL лидер группы по количеству встречаемости в ТОП.
main - количество найденных главных страниц.
ws - общая частота ключевой фразы.
ws_strict - частота "!WS".
agregators - процент агрегаторов в топ-10 по ключевой фразе. Считается в процентах от 0 до 100.
toponim - в этом параметре будет выводиться топоним (город), если в запросе встречается топоним.
geo - геозависимость запроса.

API для инструмента - Кластеризация и группировка запросов

Расшифровка результатов

Оглавление