API для инструмента проверки ГЕОзависимости, локализации и коммерциализации
Для инструмента «Проверка коммерциализации» обязательные параметры:
Па раметр |
Значение | Описание |
tools_name= | commerce | Название инструмента. Пример заполнения: tools_name=commerce |
queries= | массив в формате JSON | Фразы для проверки, массив в формате JSON, пример: queries=["\u043a\u0443\u043f\u0438\u0442\u044c \u0444\u043b\u0430\u0433"] |
ss= | 1 или 2 | Выбор поисковой системы: Яндекс - 1, Google - 2. |
lr= | id региона |
Регион поиска для Яндекса или Google. Для Google указываем id региона из файла. Например, Москва в Google имеет id 1011969, а в Яндексе - 213. lr=ID - регион для первой ПС. |
Пример запроса:
https://arsenkin.ru/tools/api/task/set?token=ВАШ_ТОКЕН&tools_name=commerce&ss=1&lr=213&queries=[%22%5Cu0447%5Cu0435%5Cu043c%5Cu043e%5Cu0434%5Cu0430%5Cu043d%22,%22%5Cu043a%5Cu0443%5Cu043f%5Cu0438%5Cu0442%5Cu044c%20%5Cu0447%5Cu0435%5Cu043c%5Cu043e%5Cu0434%5Cu0430%5Cu043d%22]
Пример PHP кода - по ссылке.
Возвращает JSON с ID задачи, пример ответа: {"task_id":3944}.
Проверка статуса задачи
Осуществляется посредством 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":
{
"\u0447\u0435\u043c\u043e\u0434\u0430\u043d":
{
"yandex_comm":97,"loc":55,"geo":1},
"\u043a\u0443\u043f\u0438\u0442\u044c \u0447\u0435\u043c\u043e\u0434\u0430\u043d":
{
"yandex_comm":97,"loc":55,"geo":1}
}
}
Массив 'result': Ключевая фраза - проверяемая фраза, значение - массив, в нем:
- yandex_comm и google_comm - результат проверки коммерциализации, loc - локализации и geo - геозависимости (1 - геозависимый, 0 - геонезависимый) в Яндекс или Google, в %