Получить результат парсинга
Метод 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 | Статус пробивки ключевой фразы. Статусы могут быть следующие: | 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 |
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
}
]
}
}