Отримання результатів Парсингу топу звичайної та локальної видачі за ідентифікатором
Метод 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 | Контекстна реклама: |
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": "[]"
}
]
}
}