API для инструмента - Определение релевантных страниц по ключевым фразам

Для инструмента «Определение релевантных страниц по ключевым фразам» обязательные параметры:

• Общая информация по API находится на странице.
• tools_name=relevant-url - название инструмента
• keys=JSON - фразы для проверки, массив в формате JSON, пример: ["[\"\u0440\u0435\u043c\u043e\u043d\u0442 \u043a\u0438\u0430\",\"\u0441\u0435\u0440\u0432\u0438\u0441 \u043a\u0438\u0430\"]"]
• ss=N - выбор поисковой системы: Яндекс = 1, Google Desktop = 11, Google Mobile = 12. Пример: ss=1 - Яндекс.
• region=id региона - регион поиска для Яндекса или Google. Для Google указываем id региона из файла. Например, Москва в Google имеет id 1011969, а в Яндексе - 213. region=ID - регион для первой ПС (по умолчанию).
• url= - домен проверяемого сайта. Пример: &url=altika.ru

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

Пример: https://arsenkin.ru/tools/api/task/set?token=ВАШ_ТОКЕН&tools_name=relevant-url&ss=1®ion=213&keys=["[\"\u0440\u0435\u043c\u043e\u043d\u0442 \u043a\u0438\u0430\",\"\u0441\u0435\u0440\u0432\u0438\u0441 \u043a\u0438\u0430\"]"]

БОЛЬШОЙ СПИСОК фраз требуется ставить через POST, не через GET, иначе у вас будет ошибка.

Проверка статуса задачи: осуществляется посредством 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 с результатами проверки, пример ответа:

{
  "summary": {
    "queries": [
      "ремонт киа",
      "сервис киа"
    ],
    "count": 2,
    "hosts": [
      "altika.ru"
    ],
    "regions": [
      {
        "ss": "Яндекс Desktop",
        "region": "Москва [213]"
      }
    ]
  },
  "result": [
    {
      "key": "ремонт киа",
      "url": "https://www.altika.ru/kia/"
    },
    {
      "key": "сервис киа",
      "url": "https://www.altika.ru/kia/"
    }
  ]
}

• queries - Список ключевых фраз;
• count - количество ключевых фрах;
• hosts - проверяемый домен;
• regions - проверяемая поисковая система и регион;
• result - блок результата с данными;
• key - ключевая фраза;
• url - релевантный URL адрес;

---

---

---