Некоторые функции ограничены.
Вход Регистрация

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

Получение результатов Парсинга топа по идентификатору (tasks.getTaskResult)

Метод tasks.getTaskResult позволяет получить результаты Парсинга топа по идентификатору.

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

Параметры запроса
Параметр Описание Тип данных Опциональный Варианты значений
id Идентификатор текущего запроса, можно указать вручную или он подставится автоматически string нет 1, test
method Имя метода string нет tasks.getTaskResult 
params Объект с параметрами object нет
taskId Идентификатор задачи для получения результата (получить его можно из методов: tasks.addTask или tasks.addKeywordList) int нет 2071486
page

В объемных проектах результат отдается частями. В ответе присутствует параметр next_page, указывающий на номер следующей части результата.

int да "page": 2

Параметры ответа
Параметр Описание
id Соответствует идентификатору запроса
result Содержит в себе ответ
next_page Параметр отдается только для больших проектов, при наличии следующей части ответа
task_meta Идентификаторы настроек парсинга:
se_id — идентификатор поисковой системы;
* country_id — идентификатор страны;
* region_id — идентификатор региона или города;
device_type_id — тип устройства
tops Массив результатов по ключевым словам проекта
keyword_id
Номер ключевой фразы, по которой анализируется выдача
keyword
Ключевое слово
keyword_data
Содержит параметры
top
Массив топов по ключевому слову
url
URL страницы
domain
Доменное имя результата
subdomain
Поддомен домена
snippet_length
Длина сниппета
title
Заголовок в выдаче
title_length
Длина заголовка
snippet
html представление выдачи
breadcrumbs
«Хлебные крошки», если есть в выдаче
spec_elements
Массив с параметрами спецэлементов
types
Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое)
position
Позиция в списке
ads
Контекстная реклама:
 1 — выдача вверху страницы;
 2 — выдача справа (устаревшая вёрстка);
 3 — выдача внизу страницы

Параметры объекта контекстной рекламы:
* domain — доменное имя результата;
* position — позиция в списке;
* subdomain — поддомен домена;
* text — рекламный текст;
* title — заголовок в выдаче;
* url — URL страницы;
* top_features_content - массив с параметрами спецэлементов.
right_spell
Правильное написание ключевого слова
results
Общее количество результатов выдачи

Возможные ошибки
Значение Описание
Task not found Не найдена задача с заданным id
Not all keywords have been tracked. Progress x% Еще не все ключевые фразы обработаны

Example
Request data:
{
    "id": "some_id" ,
    "method": "tasks.getTaskResult",
    "params": {
        "taskId": 2071486
    }
}
Response data:
{
    "id": "some_id",
    "result": {
        "task_meta": {
            "se_id": "1",
            "country_id": "23",
            "region_id": "0",
            "device_type_id": "1"
        },
        "tops": [
            {
                "keyword_id": "469901244",
                "keyword": "iphone 12",
                "keyword_data": {
                    "top": [
                        {
                            "url": "https://www.apple.com/iphone-12/",
                            "domain": "apple.com",
                            "subdomain": "www.apple.com",
                            "snippet_length": 138,
                            "title": "iPhone 12 and iPhone 12 mini - Apple",
                            "title_length": 36,
                            "snippet": Meet the new iPhone 12 and iPhone 12 mini. 5G speed. A14 Bionic. Super Retina XDR display. Ceramic Shield. And Night mode on every camera.,
                            "breadcrumbs": "https://www.apple.com › iphone-12",
                            "spec_elements": [
                                {
                                    "type": "snip_breadcrumbs",
                                    "anchor": null,
                                    "href": null,
                                    "content": "https://www.apple.com › iphone-12",
                                    "sort_number": 0
                                }
                            ],
                            "types": [
                                "snip_breadcrumbs"
                            ],
                            "position": 1
                        },
                        {
                            "url": "https://www.apple.com/iphone-12-pro/",
                            "domain": "apple.com",
                            "subdomain": "www.apple.com",
                            "snippet_length": 148,
                            "title": "iPhone 12 Pro Max - Apple",
                            "title_length": 25,
                            "snippet": iPhone 12 Pro and iPhone 12 Pro Max. 5G. A14 Bionic. Ceramic Shield. Pro camera system. LiDAR Scanner. Night mode portraits. Dolby Vision recording.,
                            "breadcrumbs": "https://www.apple.com › iphone-12-pro",
                            "spec_elements": [
                                {
                                    "type": "snip_breadcrumbs",
                                    "anchor": null,
                                    "href": null,
                                    "content": "https://www.apple.com › iphone-12-pro",
                                    "sort_number": 0
                                }
                            ],
                            "types": [
                                "snip_breadcrumbs"
                            ],
                            "position": 2
                        },

...

                    ],
                    "ads": {
                        "1": [
                            {
                                "title": "iPhone 12 - Apple Official Site",
                                "url": "https://www.apple.com/iphone-12/",
                                "domain": "apple.com",
                                "subdomain": "www.apple.com",
                                "text": "5G speed. Blast past fast. Buy now. Special AT&T offer available at apple.com. Night mode. A14 Bionic chip. Six colors. Super Retina XDR display. 5G. Ceramic Shield.",
                                "position": 1
                            },
                            {
                                "title": "Verizon: iPhone 12 Offer - Up To $700 Off w/ Trade In",
                                "url": "https://www.verizon.com/smartphones/apple-iphone-12/",
                                "domain": "verizon.com",
                                "subdomain": "www.verizon.com",
                                "text": "Up to $700 w/ select trade-in & select Unlimited. Plus up to $500 w/ port-in. Terms apply.",
                                "position": 2
                            }
                        ],
                        "2": [],
                        "3": []
                    },
                    "types": [
                        "top_stories",
                        "shopping_top",
                        "kn_graph_disambiguation",
                        "kn_graph_carousel_list",
                        "ads_top"
                    ],
                    "results": 82,
                    "right_spell": "",
                    "top_features_content": [
                        {
                            "Disambiguation": {
                                "HiddenName": {
                                    "text": "See results about"
                                }
                            }
                        },
                        {
                            "TopShop": {
                                "TopShopBlock": {
                                    "shop_content": [
                                        {
                                            "position": 1,
                                            "store_url": "https://www.verizon.com/smartphones/apple-iphone-12/?sku=sku4120364",
                                            "title": "Apple iPhone 12 128 GB in Blue with installment",
                                            "price": "$0.00",
                                            "store": "Verizon",
                                            "network": "n/a",
                                            "network_url": "n/a"
                                        },
                                        {
                                            "position": 2,
                                            "store_url": "https://www.verizon.com/smartphones/apple-iphone-12/?sku=sku4490077",
                                            "title": "Apple iPhone 12 128 GB in Purple with installment",
                                            "price": "$0.00",
                                            "store": "Verizon",
                                            "network": "n/a",
                                            "network_url": "n/a"
                                        },

...

                                    ]
                                }
                            }
                        },
                        {
                            "Disambiguation": {
                                "HiddenName": {
                                    "text": "See results about"
                                }
                            }
                        }
                    ]
                },
                "target_fields": "[]"
            }
        ]
    }
}