Получение результатов Парсинга топа по обычной и локальной выдаче по идентификатору

Метод 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.

Имя

Email

Телефон

Будем рады вашему комментарию
Я принимаю условия Политики конфиденциальности.

Спасибо, мы сохранили ваши новые настройки рассылок.

Открыть чат технической поддержки