API для инструмента - Яндекс Вордстат

Для инструмента «Яндекс Вордстат» обязательные параметры.

Для инструмента «Сбор частотности Яндекс Вордстат» обязательные параметры:

• Общая информация по API находится на странице.
• tools_name=wordstat - название инструмента
• type=1 - тип проверки (1 - проверка частотности, 2 - парсинг запросов, 3 - проверка сезонности).
• queries=JSON - фразы для проверки, массив в формате JSON, пример: queries=["\u043a\u0443\u043f\u0438\u0442\u044c \u0444\u043b\u0430\u0433"]
• lr=213 - основной регион поиска по Яндексу
• lr2=12 - второй дополнительный регион поиска по Яндексу.
• lr3=47 - третий дополнительный регион поиска по Яндексу.
• base=true/false - получение основной частоты (WS) по запросам.
• quoted=true/false - получение частоты "WS" по запросам.
• overal=true/false - получение частоты "!WS" по запросам.
• exact=true/false - получение частоты "[!WS]" по запросам.
• device=desktop/mobile/phone/tablet - уточнение устройства для сбора частоты.

---

Для инструмента «Парсинг ключевых фраз» параметры API для сбора данных:

• tools_name=wordstat - название инструмента
• type=2 - тип проверки (1 - проверка частотности, 2 - парсинг запросов, 3 - проверка сезонности).
• queries=JSON - фразы для проверки, массив в формате JSON, пример: queries=["\u043a\u0443\u043f\u0438\u0442\u044c \u0444\u043b\u0430\u0433"]
• lr=213 - основной регион поиска по Яндексу
• depth - количество страниц для парсинга. Значения от 1 до 41.
• device=desktop/mobile/phone/tablet - уточнение устройства для сбора частоты.
• minus_words= - минус слова. Пример: minus_words=[%22дилер%22]
• is_clear_minus=1/0 - Удалять из CSV результата фразы с минус-словами
• is_right=1/0 - Сбор правой колонки
• is_clear=1/0 - Удалить "+" из ключевых фраз
• is_suggest=1/0 - Собрать поисковые подсказки (+1 лимит)
• is_suggest_ws=1/0 - Собрать общую частоту для поисковых подсказок (+20 лимитов)

---

Для инструмента «Проверка сезонности запросов» параметры API для сбора данных:

• tools_name=wordstat - название инструмента
• type=3 - тип проверки (1 - проверка частотности, 2 - парсинг запросов, 3 - проверка сезонности).
• queries=JSON - фразы для проверки, массив в формате JSON, пример: queries=["\u043a\u0443\u043f\u0438\u0442\u044c \u0444\u043b\u0430\u0433"]
• lr=213 - регион по Яндексу
• device=desktop/mobile/phone/tablet - уточнение устройства для сбора сезонности.

---

---

Пример постановки задачи для сбора частотности. В ответ возвращает JSON с ID задачи, пример ответа: {"task_id":3944}

Пример: https://arsenkin.ru/tools/api/task/set?token=ВАШ_ТОКЕН&tools_name=wordstat&type=1&lr=213&base=1"ed=1&device=desktop&queries=["\u0447\u0442\u043e \u0442\u0430\u043a\u043e\u0435 seo"]

Проверка статуса задачи: осуществляется посредством 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 с результатами проверки, пример ответа сбора частотности по региону Москва:

{
  "device": "desktop",
  "task_id": "21444674",
  "cb": {
    "base": true,
    "overall": false,
    "exact": false,
    "exact_": false
  },
  "cb_count": 1,
  "queries": [
    "что такое seo"
  ],
  "regions": {
    "213": "Москва"
  },
  "result": {
    "что такое seo": {
      "213": {
        "base": 20357
      }
    }
  }
}

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

[
  {
    "query": "что такое seo",
    "data": {
      "2021-04-30": {
        "frequency": "97756"
      },
      "2021-05-31": {
        "frequency": "96610"
      },
      "2021-06-30": {
        "frequency": "217970"
      },
      "2021-07-31": {
        "frequency": "248455"
      },
      "2021-08-31": {
        "frequency": "176350"
      },
      "2021-09-30": {
        "frequency": "155126"
      },
      "2021-10-31": {
        "frequency": "98790"
      },
      "2021-11-30": {
        "frequency": "106757"
      },
      "2021-12-31": {
        "frequency": "104676"
      },
      "2022-01-31": {
        "frequency": "64271"
      },
      "2022-02-28": {
        "frequency": "98958"
      },
      "2022-03-31": {
        "frequency": "94888"
      },
      "2022-04-30": {
        "frequency": "63457"
      },
      "2022-05-31": {
        "frequency": "58369"
      },
      "2022-06-30": {
        "frequency": "52181"
      },
      "2022-07-31": {
        "frequency": "47551"
      },
      "2022-08-31": {
        "frequency": "54678"
      },
      "2022-09-30": {
        "frequency": "52737"
      },
      "2022-10-31": {
        "frequency": "30900"
      },
      "2022-11-30": {
        "frequency": "33974"
      },
      "2022-12-31": {
        "frequency": "34558"
      },
      "2023-01-31": {
        "frequency": "34936"
      },
      "2023-02-28": {
        "frequency": "137507"
      },
      "2023-03-31": {
        "frequency": "44781"
      }
    }
  }
]

Пример ответа для парсинга ключевых фраз:

{
  "0": {
    "freq": 40114,
    "left": {
      "seo": 40114,
      "seo продвижение": 10115,
      "seo сайта": 6761,
      "seo продвижение сайтов": 4427,
      "seo ru": 1974,
      "seo москва": 1949,
      "seo специалист": 1732,
      "seo продвижение москва": 1335,
      "заказать seo": 1238,
      "seo prodvizhenie": 1058,
      "seo prodvizhenie ru": 1055,
      "seo продвижение seo prodvizhenie moskva ru": 1012,
      "seo текст": 875,
      "seo продвижение заказать": 780,
      "seo продвижение сайта москва": 774,
      "seo оптимизация сайтов": 757,
      "курсы seo": 716,
      "yoast seo": 664,
      "поисковое seo": 645,
      "сео seo": 632,
      "seo яндекс": 626,
      "заказать seo сайта": 620,
      "seo ru продвижение сайтов": 605,
      "seo цена": 602,
      "seo frog": 565,
      "сео продвижение seo": 509,
      "seo карточки": 492,
      "seo слова": 484,
      "seo screaming": 482,
      "seo анализ": 476,
      "seo spider": 475,
      "seo услуги": 468,
      "screaming frog seo": 464,
      "seo продвижение цена": 461,
      "seo товаров": 452,
      "seo сайта +в москве": 451,
      "seo fast": 450,
      "интернет seo": 448,
      "seo frog spider": 438,
      "поисковое продвижение seo": 434,
      "screaming seo spider": 433,
      "wordpress seo": 428,
      "screaming frog seo spider": 418,
      "seo продвижение сайта заказать": 416,
      "seo раскрутка": 411,
      "seo аудит": 397,
      "seo страницы": 397,
      "seo оптимизация +это": 385,
      "seo онлайн": 385,
      "заказать seo москва": 383
    },
    "keyword": "что такое seo"
  },
  "1": {
    "freq": 33049,
    "left": {
      "купить чемодан": 33049,
      "купить чемодан +в москве": 8950,
      "купить чемодан +на колесах": 4886,
      "купить чемодан недорого": 2949,
      "чемодан купить москва недорого": 2071,
      "ручной чемодан купить": 2016,
      "купить чемодан +на колесах недорого": 1576,
      "купить чемодан +на колесах недорого +в москве": 1190,
      "чемодан +для ручной клади купить": 1175,
      "купить чемодан samsonite": 1122,
      "купить набор чемоданов": 1097,
      "купить чемодан +на колесиках": 873,
      "купить чемодан дешево": 841,
      "купить чемодан самсонайт": 797,
      "купить хороший чемодан": 744,
      "чемоданы купить распродажа": 707,
      "чехол +на чемодан купить": 706,
      "где купить чемодан": 683,
      "купить детский чемодан": 653,
      "купить легкий чемодан": 634,
      "какой купить чемодан": 629,
      "чемодан купить магазин": 603,
      "купить тканевый чемодан": 590,
      "купить чемодан размер": 583,
      "купить чемодан +на авито": 564,
      "чемодан купить +в москве распродажа": 557,
      "купить набор инструментов +в чемодане": 545,
      "купить чемодан москва дешево": 537,
      "купить чемодан american": 524,
      "купить большой чемодан": 511,
      "чемодан american tourister купить": 510,
      "купить пластиковый чемодан": 508,
      "купить чемодан американ": 502,
      "колеса +для чемоданов купить +в москве": 484,
      "чемодан ручная кладь купить +в москве": 471,
      "чемодан американ туристер купить": 449,
      "купить чемодан +на колесах +на распродаж": 440,
      "купить сумку чемодан": 437,
      "легкие чемоданы +на колесах купить": 429,
      "москва купить чемодан +на колесах распродажи": 425,
      "купить чемодан интернет": 418,
      "купить чемодан недорого распродажа": 407,
      "какой чемодан лучше купить": 404,
      "чемодан samsonite купить +в москве": 403,
      "купить набор чемоданов москва": 396,
      "чемодан прочный купить": 392,
      "чемодан l купить": 389,
      "распродажи чемоданов купить москва недорого": 389,
      "чемоданы s купить": 387,
      "купить чемодан +на колесах недорого распродажа": 386
    },
    "keyword": "как купить чемодан"
  },
  "2": {
    "freq": 181298,
    "left": {
      "слон": 181395,
      "слоне +в": 28691,
      "купи слона": 11453,
      "фильм слон": 10762,
      "сколько слонов": 6098,
      "три слона": 5919,
      "слон какой": 5167,
      "доктор слон": 4894,
      "про слона": 4730,
      "магазин слон": 4588,
      "дом слон": 4528,
      "со слоном": 4477,
      "костя слонов": 4077,
      "играющие слоны": 4070,
      "зонт слон": 4049,
      "розовый слон": 3754,
      "розов слон": 3754,
      "зонт три слона": 3639,
      "слон футбол": 3613,
      "слоны играющие +в футбол": 3580,
      "белый слон": 3505,
      "слоны +могут играть +в": 3467,
      "смотреть слон": 3443,
      "3 слонов": 3417,
      "слоны +могут играть +в футбол": 3325,
      "3 слона": 3099,
      "слон животное": 3056,
      "где слон": 2936,
      "слоны футбол фильм": 2927,
      "1 слон": 2837,
      "индийский слон": 2820,
      "фильм слоны +могут играть": 2819,
      "текст слон": 2798,
      "слоны +могут играть +в футбол фильм": 2773,
      "слон +в москве": 2640,
      "слон отзывы": 2579,
      "2 слона": 2561,
      "большой слон": 2453,
      "слон 2022": 2408,
      "слон онлайн": 2378,
      "слон интернет": 2368,
      "африканский слон": 2362,
      "человек слон": 2265,
      "слон интернет магазин": 2244,
      "воды слонам": 2208,
      "ответ слон": 2187,
      "слон весит": 2095,
      "слон сайт": 2063,
      "хобот слона": 2052,
      "слон фото": 2051
    },
    "keyword": "слоны"
  }
}

---

---

---