🏠 Главная API TOOLS Коммерциализация

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, в %