Switch to english interface?

Получить результат парсинга

Метод SerpstatTaskProcedure.getTaskResult метод позволяет получить результаты Парсинга Частотности по идентификатору запроса "task_id", который был получен в ответе метода SerpstatTaskProcedure.addKeywordListFreq.

Общие параметры запроса и инструкция по использованию Serpstat API по Парсингу частотности

Параметры запроса
Параметр Описание Тип данных Обязательный Значение по умолчанию Варианты значений
id Идентификатор текущего запроса string да 1, test
method Имя метода string да SerpstatTaskProcedure.getTaskResult
params Объект с параметрами object да
taskId Идентификатор запроса из ответа метода SerpstatTaskProcedure.addKeywordListFreq string да   352ab0be-b8a4-4966-8d16-f9137cb93c23
page Номер страницы int нет 1 5
pageSize Количество результатов на страницу int нет 100 10

Параметры ответа
Параметр Описание Тип данных
id Идентификатор запроса: соответствует id в запросе. int
result Объект с результатами. json object
total Суммарное количество ключевых фраз в задаче без учета blocked и дублей. int
page Порядковый номер страницы результатов. int
pageSize Количество результатов на странице. int
taskMeta
Объект с настройками парсинга, переданными в методе SerpstatTaskProcedure.addKeywordListFreq json object
typeId Идентификатор типа устройства:
typeId=1 - Desktop
int
seId Идентификатор поисковой системы:
seId=1 - Google
int
regionId Идентификатор региона или города для Google. Соответствие региону указано в документе (осторожно, документ тяжелый - может временно положить браузер). int
keywords Массив ключевых фраз с информацией по каждому ключевому слову. json array of objects
keyword Ключевая фраза, по которой были получены параметры частотности и стоимости за клик с учетом всех фильтров. string
keyword.raw Ключевая фраза, которая пришла на пробивку частотности от пользователя. Частотность пробивается для ключевых фраз без спецсимволов (*, +, -, @, ~, !, &, |, (, ), :, ,, ., ;). string
status

Статус пробивки ключевой фразы. Статусы могут быть следующие:
2 - пробивка частотности успешно завершена. Данные в keyword_data присутствуют.
4 - ошибка получения данных от Google. Возможные причины ошибки:
1) был выбран запрещенный регион выдачи: Куба, Иран, Судан, Сирия, Северная Корея, россия [страна-террорист];
2) Google не предоставил информацию по фразе;
3) Google заменил часть символов во фразе. В таком случае мы не сможем предоставить информацию относительно первоначальной формулировки фразы.

string
cost Средняя стоимость за клик в Google Ads за последний год в USD int
searchVolume Частотность по выбранном региону и типу соответствия int
searchVolumeHistory История частотности по ключевой фразе за последние 12 месяцев. Каждый объект состоит из полей date (дата первого дня месяца в формате YYYY-MM-DDTHH:MM:SS) и value (месячная частотность). int
competition Конкуренция по ключевой фразе в Google Ads для Google (от 1 до 100%), которая показывает какой процент слотов для рекламы по этой фразе занято в данном регионе int

Example
Request data:
{
    "id": 1,
    "method": "SerpstatTaskProcedure.getTaskResult",
    "params": {
         "taskId": "bc0a46cc-357e-4706-a674-1e8166f81fb2",
         "page": 1,
         "pageSize" : 10
     }
}
Response data:
{
    "id": "1",
    "result": {
        "total": 6,
        "page": 1,
        "pageSize": 10,
        "taskMeta": {
            "typeId": "1",
            "seId": "1",
            "regionId": "2840",
            "match": "exact"
        },
        "keywords": [
            {
                "keyword": "iphone 10",
                "keyword.raw": "iphone 10",
                "status": 2,
                "cost": 1.01,
                "searchVolume": 246000,
                "searchVolumeHistory": [
                    {
                        "date": "2020-09-01T00:00:00",
                        "value": 246000
                    },
                    {
                        "date": "2020-10-01T00:00:00",
                        "value": 301000
                    },
                    {
                        "date": "2020-11-01T00:00:00",
                        "value": 368000
                    },
                    {
                        "date": "2020-12-01T00:00:00",
                        "value": 368000
                    },
                    {
                        "date": "2021-01-01T00:00:00",
                        "value": 246000
                    },
                    {
                        "date": "2021-02-01T00:00:00",
                        "value": 201000
                    },
                    {
                        "date": "2021-03-01T00:00:00",
                        "value": 246000
                    },
                    {
                        "date": "2021-04-01T00:00:00",
                        "value": 201000
                    },
                    {
                        "date": "2021-05-01T00:00:00",
                        "value": 246000
                    },
                    {
                        "date": "2021-06-01T00:00:00",
                        "value": 201000
                    },
                    {
                        "date": "2021-07-01T00:00:00",
                        "value": 246000
                    },
                    {
                        "date": "2021-08-01T00:00:00",
                        "value": 246000
                    }
                ],
                "competition": 100
            },
            {
                "keyword": "iphone X",
                "keyword.raw": "iphone X",
                "status": 2,
                "cost": 0.94999999999999996,
                "searchVolume": 550000,
                "searchVolumeHistory": [
                    {
                        "date": "2020-09-01T00:00:00",
                        "value": 550000
                    },
                    {
                        "date": "2020-10-01T00:00:00",
                        "value": 673000
                    },
                    {
                        "date": "2020-11-01T00:00:00",
                        "value": 673000
                    },
                    {
                        "date": "2020-12-01T00:00:00",
                        "value": 673000
                    },
                    {
                        "date": "2021-01-01T00:00:00",
                        "value": 550000
                    },
                    {
                        "date": "2021-02-01T00:00:00",
                        "value": 450000
                    },
                    {
                        "date": "2021-03-01T00:00:00",
                        "value": 550000
                    },
                    {
                        "date": "2021-04-01T00:00:00",
                        "value": 550000
                    },
                    {
                        "date": "2021-05-01T00:00:00",
                        "value": 450000
                    },
                    {
                        "date": "2021-06-01T00:00:00",
                        "value": 450000
                    },
                    {
                        "date": "2021-07-01T00:00:00",
                        "value": 450000
                    },
                    {
                        "date": "2021-08-01T00:00:00",
                        "value": 673000
                    }
                ],
                "competition": 81
            }
        ]
    }
}

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

Вы уверены?

Знакомство с Serpstat

Узнайте об основных возможностях сервиса удобным способом!

Отправьте заявку и наш специалист предложит вам варианты обучения: персональную демонстрацию, пробный период или материалы для самостоятельного изучения и повышения экспертизы. Все для комфортного начала работы с Serpstat.

Имя

Email

Телефон

Будем рады вашему комментарию
Я принимаю условия Политики конфиденциальности.

Спасибо, мы сохранили ваши новые настройки рассылок.

Открыть чат технической поддержки