Документация на метод "wordstatapi"
API для получения частот запросов из wordstat:
URL: https://tools.pixelplus.ru/api/wordstatapi
Принимает параметры:
Постановка задачи:
GET
- key — ключ доступа к API;
POST:
- requests[] — список ключевых запросов (от 1 до 10 000 штук);
- lr — регион по Яндексу;
- overall — общая частота, передать 1 для сбора, используется по умолчанию, если не передано других частот;
- exact — точная частота, передать 1 для сбора;
- quoted — частота в кавычках, передать 1 для сбора;
- fixed — частота с фиксацией слов, передать 1 для сбора;
- mobile — снять частоты для мобильных устройств, передать 1 для сбора;
- delete_special_characters — убрать спецсимволы, передать 1 для активации;
- delete_zero_keywords — Удалить запросы с нулевой точной или общей частотой, передать 1 для активации;
- frequency_relations — Рассчитать соотношение частот, передать 1 для активации;
- cb_total_annual — Рассчитать общую годовую частоту, передать 1 для сбора;
- cb_total_annual_by_month — Рассчитать общую годовую частоту по месяцам, передать 1 для сбора;
- cb_total_annual_by_month_type — Рассчитать общую годовую частоту по месяцам за 12 либо 24 месяца, передать 12 либо 24 для сбора. По умолчанию - 12;
Получение задачи:
GET:
- report_id: ID задачи полученный при постановке
Возвращает JSON с массивом:
{
"Запрос 1": {
"213": {
"from": "Исходная фраза",
"overall": 156533,
"exact": 1233,
"quoted": 4214,
"mobile": 123,
"exact_fixed": 12423,
"frequency_relations": -1
}
},
"Запрос 2": {
"213": {
"from": "Исходная фраза",
"overall": 73022,
"exact": 1234,
"quoted": 4123,
"mobile": 12412,
"exact_fixed": 2412,
"frequency_relations": -1
}
}
}
В случае неудачи:
- {"error":"In progress","code":-32} — если задача с указанныи ID еще не выполнена;
- {"error": {
"requests": "Необходимо передать ключевые слова для анализа",
"lr": "Необходимо выбрать регион для анализа"
"limits": "Не достаточно лимитов для запуска"
},
"code": -50} - {"error":"access denided","code":-1} — если не задан ключ доступа;
- {"error":"access denided","code":-2} — если неверно задан ключ доступа;
- {"error":"unknown method","code":-3} — если неверно задано название метода;
- {"error":"Not enough monthly limits","code":-82} — недостаточно месячных лимитов;
- {"error":"Not enough yearly limits","code":-83} — недостаточно годовых лимитов.
- {"error":"To many tasks from one user. Try again later.","code":-60} — Не больше 5 активных задач от одного пользователя.