Документация на метод "wordstatapikeywords"
API для сбора запросов из wordstat:
URL: https://tools.pixelplus.ru/api/wordstatapikeywords
Принимает параметры:
Постановка задачи:
GET
- key — ключ доступа к API;
POST:
- requests — список ключевых запросов;
- lr — регион по Яндексу;
- overall — общая частота, передать 1 для сбора, используется по умолчанию, если не передано других частот;
- exact — точная частота, передать 1 для сбора;
- quoted — частота в кавычках, передать 1 для сбора;
- fixed — частота с фиксацией слов, передать 1 для сбора;
- mobile — снять частоты для мобильных устройств, передать 1 для сбора;
- delete_special_characters — убрать спецсимволы, передать 1 для активации;
- delete_zero_keywords — Удалить запросы с нулевой точной или общей частотой, передать 1 для активации;
- frequency_relations — Рассчитать соотношение частот, передать 1 для активации
- stop_list - список стоп-слов для исключения запросов
- min_count_words - удалить запросы, состоящие менее чем из указанного кл-ва слов
- max_count_words - удалить запросы, состоящие более чем из указанного кл-ва слов
- min_overall_frequency - не собирать запросы с общей частотой меньше указанного кл-ва показов в месяц
- count_pages - число страниц для парсинга (от 1 до 41)
Получение задачи:
GET:
- report_id: ID задачи полученный при постановке
Возвращает JSON с массивом:
{
"Запрос 1": {
"213": {
"from": "Исходная фраза",
"overall": 14967,
"exact": 13,
"quoted": 13,
"mobile": 763,
"exact_fixed": 12,
"frequency_relations": -1
}
},
"Запрос 2": {
"213": {
"from": "Исходная фраза",
"overall": 14690,
"exact": 9,
"quoted": 10,
"mobile": 6784,
"exact_fixed": 6,
"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 активных задач от одного пользователя.