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

Метод tasks.getTaskResult дозволяє отримати результати Парсингу топу за ідентифікатором (результати звичайної та локальної видачі).

Примітка: результати Google AI Overview в даний момент доступні в рамках стандартних запитів Парсингу топу без додаткової плати. Це дозволяє отримувати вміст блоку AI Overview в рамках отриманих результатів Google. Однак з 1 серпня 2025 року отримання вмісту блоку AI Overview стане окремим необов'язковим параметром за додатковою ціною. Після цієї дати необхідно буде включати отримання AI Overview в рамках запитів API та враховувати додаткові витрати на такий тип запитів.

Загальні параметри запиту та інструкція щодо використання 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 знаходиться в режимі бета і вміст може змінюватися і доповнюватися.

AiOverview — кореневий контейнер для вмісту блоку Google AI Overview.
Параметри об'єкта AiOverview:
* aio_content — містить основний AI-згенерований контент та пов'язані інтерактивні елементи з блоку Google AI Overview.
* aio_content.text — основний AI-згенерований текст з блоку Google AI Overview.
*aio_content.links — гіперпосилання, вбудовані в текстовий блок Google AI Overview.
* aio_content.links[].text — клікабельний текст анкора для посилань, вбудованих у текстовий блок Google AI Overview.
* aio_content.links[].url — URL-адреса посилань, згаданих у текстовому блоці Google AI Overview.
* aio_references — вміст блоку, який знаходиться праворуч від згенерованої відповіді та містить список основних посилань-джерел AI Overview.
* aio_references[].title — заголовок сторінки джерела, відображеного у блоці праворуч.
* aio_references[].snippet — опис рекомендованого джерела. Може бути порожнім, якщо Google не надає опис даного посилання.
* aio_references[].url — повна URL-адреса рекомендованого джерела з блоку праворуч.
* aio_references[].domain — кореневий домен рекомендованого джерела (наприклад, "kayak.com").
* aio_references[].subdomain — повний шлях піддомену рекомендованого джерела (наприклад, "www.kayak.com").
* aio_references[].position — позиція, на якій знаходиться рекомендоване посилання у блоці праворуч (1, 2, 3 тощо), що вказує на порядок ранжування Google даних посилань.

У видачі 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.kayak.com/Cheap-Metairie-Car-Rentals.20715.cars.ksp",
      "domain": "kayak.com",
      "subdomain": "www.kayak.com",
      "position": 1,
      "title": "Metairie car rentals from $37/day",
      "title_length": 33,
      "snippet": "In the past 72 hours, the cheapest rental cars were found at Thrifty ($28.70/day), Hertz ($44.97/day) and Enterprise Rent-A-Car ($47.52/day). Starting from $36.70",
      "snippet_length": 162,
      "breadcrumbs": "https://www.kayak.com › Cheap-Metairie-Car-Rentals.2...",
      "types": [
        "snip_breadcrumbs",
        "snip_image_thumbnail",
        "snip_url_in_aio"
      ],
      "spec_elements": [
        {
          "anchor": null,
          "content": "https://www.kayak.com › Cheap-Metairie-Car-Rentals.2...",
          "href": null,
          "sort_number": 0,
          "type": "snip_breadcrumbs"
        },
        {
          "anchor": null,
          "content": null,
          "href": null,
          "sort_number": 1,
          "type": "snip_image_thumbnail"
        },
        {
          "anchor": null,
          "content": null,
          "href": null,
          "sort_number": 2,
          "type": "snip_url_in_aio"
        }
      ]
    }
  ],
  "ads": {
    "1": [
      {
        "url": "https://www.avis.com/en/locations/find-a-location",
        "domain": "avis.com",
        "subdomain": "www.avis.com",
        "position": 1,
        "title": "Avis Rent a Car | Avis® Car Rental",
        "text": "Avis has a wide range of car options and thousands of convenient locations",
        "breadcrumbs": "https://www.avis.com"
      }
    ],
    "2": [],
    "3": []
  },
  "results": 1050000,
  "right_spell": "",
  "types": [
    "related_search",
    "also_asks",
    "ai_overview",
    "local_pack",
    "pic",
    "ads_top"
  ],
  "top_features_content": [
    {
      "LocalPack": {
        "LocalPackSnippet": {
          "localpack": [
            {
              "title": "Enterprise Rent-A-Car",
              "ads": false,
              "thumbnail": false,
              "extensions": [
                "Car rental agency",
                "Metairie, LA",
                "(504) 457-0180",
                "Closed",
                "Opens 7:30 AM"
              ],
              "rating": "4.2",
              "review": "194",
              "pricing": null,
              "wrapped": "\"Cannot recommend highly enough.\"",
              "options": null,
              "position": 1
            },
            {
              "title": "Enterprise Rent-A-Car",
              "ads": false,
              "thumbnail": false,
              "extensions": [
                "Car rental agency",
                "Metairie, LA",
                "(504) 454-2247",
                "Closed",
                "Opens 8 AM"
              ],
              "rating": "4.0",
              "review": "413",
              "pricing": null,
              "wrapped": "\"It had been damaged previously, but none of that was too big of a deal.\"",
              "options": null,
              "position": 2
            },
            {
              "title": "Budget Car Rental",
              "ads": false,
              "thumbnail": false,
              "extensions": [
                "Car rental agency",
                "Metairie, LA",
                "(504) 887-2952",
                "Closed",
                "Opens 9 AM"
              ],
              "rating": "3.3",
              "review": "37",
              "pricing": null,
              "wrapped": "\"She gave us an additional discount.\"",
              "options": null,
              "position": 3
            }
          ]
        }
      }
    },
    {
      "PeopleAlsoAsk": {
        "PeopleAlsoAsk": {
          "people_also_ask_block": [],
          "people_also_ask_questions": [
            "Which car rental company has the lowest fees?",
            "How to get the lowest price on a rental car?",
            "How can I pay less for a rental car?",
            "Is it cheaper to rent a car for a week or by day?"
          ]
        }
      }
    },
    {
      "AiOverview": {
        "AiOverview": {
          "aio_content": {
            "text": "To find a cheap car rental in Metairie, LA, compare prices from different rental companies, consider booking last-minute, and look for deals on smaller, more fuel-efficient cars. Here's a more detailed breakdown of how to find the best deals: 1. Compare Prices: Use online comparison websites: Sites like Kayak, Expedia, and Orbitz search multiple rental companies to find the best prices. Check multiple rental companies: Consider Thrifty, Hertz, Enterprise, Dollar, Budget, and Avis.",
            "links": [
              {
                "text": "Avis",
                "url": "https://www.avis.com/"
              }
            ]
          },
          "aio_references": [
            {
              "title": "Metairie car rentals from $37/day - Kayak",
              "snippet": "End of interactive chart. What is the cheapest car rental company in Metairie? In the past 72 hours, the cheapest rental cars were...",
              "url": "https://www.kayak.com/Cheap-Metairie-Car-Rentals.20715.cars.ksp",
              "position": 1,
              "domain": "kayak.com",
              "subdomain": "www.kayak.com"
            },
            {
              "title": "$21 Car Rental Metairie, LA - Expedia",
              "snippet": "",
              "url": "https://www.expedia.com/Car-Rentals-In-Metairie.d8827.Car-Rental-Guide",
              "position": 2,
              "domain": "expedia.com",
              "subdomain": "www.expedia.com"
            },
            {
              "title": "$33 Rental Cars in Metairie, LA - Orbitz.com",
              "snippet": "Orbitz FAQs about car rental in Metairie. How much is car rental in Metairie? Car rental deals in Metairie cost an average of $40 ...",
              "url": "https://www.orbitz.com/Car-Rentals-In-Metairie.d8827.Car-Rental-Guide",
              "position": 3,
              "domain": "orbitz.com",
              "subdomain": "www.orbitz.com"
            },
            {
              "title": "Car Rentals Near Me in Metairie, LA - Cheap Rates - Uber",
              "snippet": "Search for the best car rental deals in Metairie, LA. ... Popular rental car suppliers available through Uber Rent in Metairie inc...",
              "url": "https://www.uber.com/us/en/r/cities/car-rentals/metairie-la-us/",
              "position": 4,
              "domain": "uber.com",
              "subdomain": "www.uber.com"
            },
            {
              "title": "Cheap Car Rental at - Metairie Dollar",
              "snippet": "Dollar Car Rental - Metairie Dollar Car Rental Stats by Day* * $72.00. Ford Focus. * $68.00. Chevrolet Malibu. * $46.00. Mazda 3 ...",
              "url": "https://www.dollar.com/us/en/location/unitedstates/louisiana/metairie/msyc05",
              "position": 5,
              "domain": "dollar.com",
              "subdomain": "www.dollar.com"
            }
          ]
        }
      }
    }
  ]
},
                "target_fields": "[]"
            }
        ]
    }
}

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

Ви впевнені?

Знайомство з сервісом

Serpstat економить час, як і ми готові заощадити ваш, на знайомстві з ключовими можливостями сервісу.

Наш фахівець зв'яжеться з вами і за підсумком запропонує відповідний варіант, який може включати персональну демонстрацію, пробний період, навчальні статті та записи вебінарів, консультацію фахівця, а також комфортні умови для старту використання Serpstat.

Ім’я

Введіть адресу електронної пошти

Телефон

Будемо раді вашому коментарю

Дякуємо, ми зберегли ваші нові налаштування розсилок.

Відкрити чат технічної підтримки