Отримання результатів Парсингу топу звичайної та локальної видачі за ідентифікатором

Метод 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 сторінки.
right_spell	Правильне написання слова
results	Загальна кількість результатів видачі
top_features_content	Масив з параметрами спецелементів: PeopleAlsoAsk — блок «Схожі запити», який показує відповідні пошукові питання на запит. Параметри об'єкта LocalPack: * title — заголовок; * ads — інформація про те, чи є блок рекламою чи ні (true/false); * thumbnail — наявність картинки; * rating — рейтинг; * review — кількість відгуків; * pricing — ціни в закладі в різних валютах ($, ₽, £), чим більше грошових знаків, тим дорожче; * extensions: - type — тип закладу; - situation — де розташований заклад (у якій будівлі: ТЦ, музей та ін.); - address — адреса (можливо із зазначенням телефону та розташування; додаткова інформація, наприклад: «7+ years in business»); - hours — години роботи («Відкрито/Закрито» і до якої години; або без вказівки часу, наприклад «Відкрито цілодобово»); * wrapped — різна додаткова інформація; * options — сервісні опції, які пропонує заклад, наприклад: «Їжа у закладі», «Замовлення з вулиці», «Немає доставки» Отримання даних по блоку LocalPack знаходиться в режимі бета і вміст може змінюватися і доповнюватися.

У видачі Google в блоці Local pack при відкритті всіх результатів показується місцева (local) видача з картою, де відображаються блоки з інформацією щодо бізнесу/громадських місцях — максимум 50 результатів.
Параметри відповіді для локальної (local) видачі
Параметр	Опис
id	Відповідно до ідентифікатора запиту
result	Містить в собі відповідь
task_meta	Ідентифікатори налаштувань парсингу: * se_id — ідентифікатор пошукової системи; * country_id — ідентифікатор країни; * region_id — ідентифікатор регіону чи міста; * device_type_id — тип пристрою
tops	Масив результатів за ключовими словами проєкту
keyword_id	Номер ключової фрази, за якою аналізується видача
keyword	Ключове слово
keyword_data	Містить параметри
my_business	Масив даних місцевої видачі за ключовим словом
title	Заголовок
ads	Інформація про те, чи є блок рекламою чи ні (true/false)
thumbnail	Наявність картинки
rating	Рейтинг
review	Кількість відгуків
pricing	Ціни в закладі в різних валютах ($, ₽, £), чим більше грошових знаків, тим дорожче
extensions	Масив інформації, яка може включати таку інформацію: - type — тип закладу; - situation — де розташований заклад (у якій будівлі: ТЦ, музей та ін.); - address — адреса (можливо із зазначенням телефону та розташування; додаткова інформація, наприклад: «7+ years in business»); - hours — години роботи («Відкрито/Закрито» і до якої години; або без вказівки часу, наприклад «Відкрито цілодобово»)
wrapped	Різна додаткова інформація
options	Сервісні опції, які пропонує заклад, наприклад: «Їжа у закладі», «Замовлення з вулиці», «Немає доставки»
position	Позиція у списку
Приклад відповіді Local видачі: { "id": "some_id", "result": { "task_meta": { "se_id": "1", "country_id": "23", "region_id": "21176", "device_type_id": "1" }, "tops": [ { "keyword_id": "529084768", "keyword": "burger", "keyword_data": { "my_business": [ { "title": "Lucy's Big Burgers", "ads": false, "thumbnail": true, "extensions": [ "Hamburger", "Abilene, TX, United States", "Closed", "Opens 11AM" ], "rating": "4.7", "review": null, "pricing": "$$", "wrapped": "Low-key, family-run eatery with rustic decor, offering burgers, hot dogs & homemade ice cream.", "options": [ "Dine-in", "Takeaway", "No delivery" ], "position": 1 }, { "title": "Larry's Better Burger Drive-In", "ads": false, "thumbnail": true, "extensions": [ "Hamburger", "Abilene, TX, United States" ], "rating": "4.7", "review": null, "pricing": "$", "wrapped": "Old-fashioned burger shack serving a lengthy comfort-food menu & ice cream from the window.", "options": [ "Curbside pickup", "No delivery" ], "position": 2 }, ... { "title": "From Scratch", "ads": false, "thumbnail": true, "extensions": [ "American", "Salt Lake City, UT, United States", "In the Gallivan Center", "Closed", "Opens 11AM" ], "rating": "4.4", "review": null, "pricing": "$$", "wrapped": "Relaxed, rustic-chic locale featuring artisanal pizzas, burgers & sandwiches, plus beer & wine.", "options": [ "Dine-in", "Curbside pickup", "No delivery" ], "position": 50 } ] }, "target_fields": "[]" } ] } }

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

Example

Request data:

{
    "id": "some_id" ,
    "method": "tasks.getTaskResult",
    "params": {
        "taskId": 2436110
    }
}

Response data:

{
    "id": "some_id",
    "result": {
        "task_meta": {
            "se_id": "1",
            "country_id": "23",
            "region_id": "21176",
            "device_type_id": "1"
        },
        "tops": [
            {
                "keyword_id": "529102158",
                "keyword": "burger",
                "keyword_data": {
                    "top": [
                        {
                            "url": "https://www.bk.com/",
                            "domain": "bk.com",
                            "subdomain": "www.bk.com",
                            "snippet_length": 109,
                            "title": "Burger King",
                            "title_length": 11,
                            "snippet": "Get access to exclusive coupons. Discover our menu and order delivery or pick up from a Burger King near you.",
                            "breadcrumbs": "https://www.bk.com",
                            "spec_elements": [
                                {
                                    "type": "snip_breadcrumbs",
                                    "anchor": null,
                                    "href": null,
                                    "content": "https://www.bk.com",
                                    "sort_number": 0
                                }
                            ],
                            "types": [
                                "snip_breadcrumbs"
                            ],
                            "position": 1
                        },
                        {
                            "url": "https://en.wikipedia.org/wiki/Burger",
                            "domain": "wikipedia.org",
                            "subdomain": "en.wikipedia.org",
                            "snippet_length": 158,
                            "title": "Burger - Wikipedia",
                            "title_length": 18,
                            "snippet": "Hamburger, a sandwich consisting of one or more cooked patties, placed inside a sliced bread roll or bun roll. Cheeseburger, a hamburger with added cheese(s).",
                            "breadcrumbs": "https://en.wikipedia.org › wiki › Burger",
                            "spec_elements": [
                                {
                                    "type": "snip_breadcrumbs",
                                    "anchor": null,
                                    "href": null,
                                    "content": "https://en.wikipedia.org › wiki › Burger",
                                    "sort_number": 0
                                }
                            ],
                            "types": [
                                "snip_breadcrumbs"
                            ],
                            "position": 2
                        },


...


                        {
                            "url": "https://pizarospizza.com/",
                            "domain": "pizarospizza.com",
                            "subdomain": null,
                            "snippet_length": 150,
                            "title": "Pizaro's Pizza – Napoletana Style Pizza | Cooks in ... - Houston",
                            "title_length": 64,
                            "snippet": "What is Napoletana Pizza? ... Pizzas must be cooked at a blistering 900 degrees for no more than 90 seconds in a bell ... What is Detroit Style Pizza?",
                            "breadcrumbs": "https://pizarospizza.com",
                            "spec_elements": [
                                {
                                    "type": "snip_breadcrumbs",
                                    "anchor": null,
                                    "href": null,
                                    "content": "https://pizarospizza.com",
                                    "sort_number": 0
                                }
                            ],
                            "types": [
                                "snip_breadcrumbs"
                            ],
                            "position": 97
                        }
                    ],
                    "ads": {
                        "1": [
                            {
                                "breadcrumbs": "https://www.dominos.com/",
                                "title": "Domino’s® Pizza - Domino’s® Pizza Online - Online Ordering",
                                "url": "https://www.dominos.com/",
                                "domain": "dominos.com",
                                "subdomain": "www.dominos.com",
                                "text": "Order Your Next Pizza Online & Track Its Delivery With The Domino's Tracker®. Choose Any 2 Or More: Only $5.99 Each: Pizza, Pasta, Dips & Twists & More. Delivery or Carryout. Find A Location Near You. Earn Rewards. Track Your Order. Types: Hand Tossed, Thin Crust.",
                                "position": 1
                            }
                        ],
                        "2": [],
                        "3": []
                    },
                    "results": 1390000000,
                    "right_spell": "",
                    "types": [
                        "map",
                        "local_pack",
                        "also_asks",
                        "ads_top"
                    ],
                    "top_features_content": [
                        {
                            "LocalPack": {
                                "LocalPackSnippet": {
                                    "localpack": [
                                        {
                                            "title": "Pizza Hut",
                                            "ads": false,
                                            "thumbnail": true,
                                            "extensions": [
                                                "Pizza",
                                                "Ballinger, TX"
                                            ],
                                            "rating": "3.8",
                                            "reviews": "128",
                                            "pricing": "$",
                                            "wrapped": null,
                                            "options": [
                                                "Takeout",
                                                "No dine-in",
                                                "No delivery"
                                            ],
                                            "position": 1
                                        },
                                        {
                                            "title": "Domino's Pizza",
                                            "ads": false,
                                            "thumbnail": true,
                                            "extensions": [
                                                "Pizza",
                                                "Sweetwater, TX"
                                            ],
                                            "rating": "4.1",
                                            "reviews": "201",
                                            "pricing": "$",
                                            "wrapped": null,
                                            "options": [
                                                "Drive-through",
                                                "No-contact delivery"
                                            ],
                                            "position": 2
                                        },
                                        {
                                            "title": "Pizza Hut",
                                            "ads": false,
                                            "thumbnail": true,
                                            "extensions": [
                                                "Pizza",
                                                "Abilene, TX"
                                            ],
                                            "rating": "3.6",
                                            "reviews": "288",
                                            "pricing": "$",
                                            "wrapped": null,
                                            "options": [
                                                "Drive-through",
                                                "No-contact delivery",
                                                "No dine-in"
                                            ],
                                            "position": 3
                                        }
                                    ]
                                }
                            }
                        },
                        {
                            "PeopleAlsoAsk": {
                                "PeopleAlsoAskBlock": {
                                    "people_also_ask_questions": [
                                        "Is pizza healthy to eat?",
                                        "What is the best pizza of all time?",
                                        "How is pizza made?",
                                        "Why does pizza taste good?"
                                    ]
                                }
                            }
                        }
                    ]
                },
                "target_fields": "[]"
            }
        ]
    }
}