🏠 Главная API TOOLS Разовая проверка позиций

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

Для инструмента «Проверка позиций в поисковых системах Яндекс и Google » обязательные параметры:

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

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

Пример кода на PHP.

БОЛЬШОЙ СПИСОК фраз требуется ставить через 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 с результатами проверки.