Поиск

Документация на метод "wordstatapi"

API для получения частот запросов из wordstat:
URL: https://tools.pixelplus.ru/api/wordstatapi

Принимает параметры:
Постановка задачи:

GET

  1. key — ключ доступа к API;

POST:

  1. requests[] — список ключевых запросов (от 1 до 10 000 штук);
  2. lr — регион по Яндексу;
  3. overall — общая частота, передать 1 для сбора, используется по умолчанию, если не передано других частот;
  4. exact — точная частота, передать 1 для сбора;
  5. quoted — частота в кавычках, передать 1 для сбора;
  6. fixed — частота с фиксацией слов, передать 1 для сбора;
  7. mobile — снять частоты для мобильных устройств, передать 1 для сбора;
  8. delete_special_characters — убрать спецсимволы, передать 1 для активации;
  9. delete_zero_keywords — Удалить запросы с нулевой точной или общей частотой, передать 1 для активации;
  10. frequency_relations — Рассчитать соотношение частот, передать 1 для активации;
  11. cb_total_annual — Рассчитать общую годовую частоту, передать 1 для сбора;
  12. cb_total_annual_by_month — Рассчитать общую годовую частоту по месяцам, передать 1 для сбора;
  13. 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
        }
    }
}

В случае неудачи:

  1. {"error":"In progress","code":-32} — если задача с указанныи ID еще не выполнена;
  2. {"error": {
        "requests": "Необходимо передать ключевые слова для анализа",
        "lr": "Необходимо выбрать регион для анализа"
        "limits": "Не достаточно лимитов для запуска"
    },
    "code": -50}
  3. {"error":"access denided","code":-1} — если не задан ключ доступа;
  4. {"error":"access denided","code":-2} — если неверно задан ключ доступа;
  5. {"error":"unknown method","code":-3} — если неверно задано название метода;
  6. {"error":"Not enough monthly limits","code":-82} — недостаточно месячных лимитов;
  7. {"error":"Not enough yearly limits","code":-83} — недостаточно годовых лимитов.
  8. {"error":"To many tasks from one user. Try again later.","code":-60} — Не больше 5 активных задач от одного пользователя.