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

Ми використовуємо файли 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": "[]"
            }
        ]
    }
}

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

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

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

Або 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
Повідомлення
Необов'язково

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

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

Я хочу більше лімітів
Відкрити чат технічної підтримки