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

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

• Общая информация по 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.
• position= сбор позиций для указанного сайта. РАБОТАЕТ только для Google. Возможные значения: 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 - в этом параметре будет выводиться топоним (город), если в запросе встречается топоним.
• position - позиция сайта, который вы указали в параметре &url=.
• found_url - релевантной URL адрес по ключевой фразе сайта, указанного в параметре &url=.
• comm - показатель коммерциализации.
• loc - показатель локализации.
• geo - геозависимость запроса.

---

---

---