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 с результатами проверки.