Деякі функції обмежені.
Вхід Реєстрація

Ми використовуємо файли cookie для забезпечення працездатності сервісу, поліпшення навігації і маркетингових активностей Serpstat. Натискаючи "Прийняти та продовжити", ви погоджуєтеся з нашою Політики конфіденційності

Отримання результатів парсинга частотності V4 (SerpstatTaskProcedure.getTaskResultFreq)

SerpstatTaskProcedure.getTaskResultFreq - метод дозволяє отримати результати парсинга частотності за ідентифікатором запиту "task_id", який був отриманий у відповіді методу SerpstatTaskProcedure.addKeywordListFreq.

Параметри запиту:

Назва

Опис

Тип даних

Опціональність

Значення за замовчуванням

Варіанти значень

keywords

Ключові слова. Максимальна кількість - 50 000

array

ні

seId

Пошукова база

string

ні

1

1 - google

2 - yandex

typeId

Ідентифікатор типу пристрою

int

так

1

1 - desktop

2 - mobile

regionId

Ідентифікатор регіону або міста для Google і Yandex. Відповідність регіону зазначено в документі.

int

ні

 

 

 

Метрики ответа:

Назва Опис Тип даних Опціональний Значенння за замовчуванням Варіанти значень
taskId Ідентифікатор запиту з відповіді методу SerpstatTaskProcedure.addKeywordListFreq string ні   352ab0be-b8a4-4966-8d16-f9137cb93c23
page Номер сторінки int так 1  5
pageSize Кількість результатів на сторінку int так 100

Метрики ответа:

Назва Опис Тип даних
id Ідентифікатор запиту. Служить для обробки асинхронних запитів. int
result Об'єкт з результатами. json object
total Сумарна кількість ключових фраз в задачі без урахування blocked і дублів. int
page Порядковий номер сторінки результатів. int
pageSize Кількість результатів на сторінці. int
task_meta Ідентифікатори налаштувань парсинга. json object
keywords Масив ключових фраз з інформацією по кожному ключовому слову. json array of objects
keyword Ключова фраза, по якій були отримані параметри частотності і вартості за клік з урахуванням всіх фільтрів. string
keyword.raw Ключова фраза, яка прийшла на пробивання частотності від користувача. Частотність пробивається для ключових фраз без спецсимволів (*, +, -, @, ~, !, &, |, (, ), :, ,, ., ;). string
status Статус пробивки ключової фрази. Статуси можуть бути наступні:
0 - фраза записана в сховище. Готовий до відправлення на парсинг
1 - відправлено на пробивання частотності (в роботі)
2 - пробивання частотності успішно завершено. Дані в keyword_data присутні.
3 - помилка відправки в чергу.
4 - помилка пробивки. Фраза не пройшла перевірку на рівні пошукової системи. Детальніше тематики ключових слів, які не пройдуть перевірку описані тут https://support.google.com/adspolicy/answer/6008942?hl=ru
string
searchVolume Частотність по обраному регіону і типу відповідності int
searchVolumeHistory Історія частотності за ключовою фразою за останні 12 місяців. Кожен об'єкт складається з полів date (дата першого дня місяця в форматі YYYY-MM-DDTHH: MM: SS) і value (місячна частотність). int
cost Середня вартість за клік в Google Ads за останній рік в USD (Мінімальна вартість розміщення в преміум блоці для Яндекс) int
competition Конкуренція за ключовою фразою в Google Ads для Google (від 1 до 100), яка показує який відсоток слотів для реклами по цій фразі зайнято в даному регіоні. int
taskMeta Об'єкт з налаштуванням парсинга, передані в методі SerpstatTaskProcedure.addKeywordListFreq json object
seId Ідентифікатор пошукової системи:
seId = 1 - Google
seId = 2 - Yandex
int
typeId Ідентифікатор типу пристрою:
typeId = 1 - Desktop
typeId = 2 - Mobile
typeId = 2 - працює тільки для Яндекса. Для Google пробивання буде йти по typeId = 1, незалежно від зазначеного параметра
int
regionId Ідентифікатор регіону або міста для Google і Yandex. Відповідність регіону зазначено в документі. Обережно, документ важкий - може тимчасово покласти браузер. https://docs.google.com/spreadsheets/d/1LUDtm-L1qWMVpmWuN-nvDyYFfQtfiXUh5LIHE8sjs0k/edit#gid\u003d1732572784 int
matchId

Ідентифікатор типу відповідності.
Цей параметр працює тільки для Яндекса. Для Google завжди пробивання йде з типом відповідності "extra".

"Extra" враховує і словоформу, і розташування.
Приклад: "[!купити !слона !в !розстрочку]"

"Exact": не враховує порядок слів, але враховує словоформу.
Приклад: "!купити !слона !в !розстрочку"

"Phrase": враховує все, що містить ці слова в різному розташуванні і різні словоформи.
Приклад: "купити слона в розстрочку"

"Wide": загальна відповідність.
Приклад: купити слона в розстрочку

"Wide-fixed": загальна відповідність з фіксованою словоформой.
Приклад:!купити !слона!в !розстрочку

string

Example PHP Python
Request data:
{
    "id": {{any_num_or_string}},
    "method": "SerpstatTaskProcedure.getTaskResultFreq",
    "params": {
         "taskId": "665f297a-94c6-401c-9971-bed3025c1055",
         "page":1,
         "pageSize" : "10"
     }
}

Response data:
{
  "id": {{any_num_or_string}},
  "result": {
    "total": 6,
    "page": 1,
    "pageSize": 10,
    "keywords": [
      {
        "keyword": "iphone 10",
        "keyword.raw": "iphone 10",
        "status": 0,
        "cost": null,
        "searchVolume": null,
        "competition" : 1 // для google
      },
    ],
    "taskMeta": {
      "typeId": 1,
      "seId": 2,
      "regionId": 213,
      "match": "exact"
    }
  }
}

Поділіться статтею з вашими друзями

Вхід Реєстрація

Ви вичерпали ліміт запитів.

Або email
Забыли пароль?
Або email
Optional
Повернутися до авторизації

Не хвилюйтеся! Лише заповніть поле з вашою email адресою і ми вишлемо вам листа для відновлення паролю.

Ви впевнені?

Awesome!

To complete your registration you need to enter your phone number

Назад

Ми надіслали код підтвердження на ваш номер телефону

Your phone Resend code Залишилося запитів

Щось пішло не так.

Зв'яжіться з нашою службою підтримки
Або підтвердіть регістарціі за допомогою Телеграм бота Перейдіть за цим посиланням
Виберіть проект, по якому хочете отримувати дані

Знайомство з сервісом

Serpstat економить час, як і ми готові заощадити ваш, на знайомстві з ключовими можливостями сервісу.

Наш фахівець зв'яжеться з вами і за підсумком запропонує відповідний варіант, який може включати персональну демонстрацію, пробний період, навчальні статті та записи вебінарів, консультацію фахівця, а також комфортні умови для старту використання Serpstat.

Ім’я

Email

Телефон

Будемо раді вашому коментарю

Покращити план

Експорт недоступний для вашого тарифного плану. Вам необхідно поліпшити свій тариф до Lite або вище, щоб отримати доступ до інструменту. Детальніше

Sign Up Free

Спасибо, мы с вами свяжемся в ближайшее время

Запрошення
Просмотр Редактирование

E-mail
Повідомлення
Необов'язково
E-mail
Повідомлення
Необов'язково

У вас закінчилися ліміти

Ви досягли ліміту на кількість створених проектів і більше не можете створювати нові проекти. Збільште ліміти або видаліть існуючі проекти.

Я хочу більше лімітів