Получение результатов Парсинга топа по обычной и локальной выдаче по идентификатору
Метод 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 выдачи: |
Возможные ошибки | |
Значение | Описание |
Task not found | Не найдена задача с заданным id |
Not all keywords have been tracked. Progress x% | Еще не все ключевые фразы обработаны |
{
"id": "some_id" ,
"method": "tasks.getTaskResult",
"params": {
"taskId": 2436110
}
}
{
"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": "[]"
}
]
}
}