# Живая расширенная органическая выдача Google **API:** Data API **Endpoint:** `POST /v1/beta/dataforseo/serp/google/organic/live/advanced` **Tags:** DataForSEO Синхронно возвращает ранжированные результаты по ключевому слову в Google. Возвращает `keyword`, `type`, `se_domain`, `location_code`, `language_code`, `check_url`, `datetime`, `spell`, `refinement_chips`, `item_types`, `items_count` и `items`. `advanced` — вариант по умолчанию; берите `regular`, когда важен только ранжированный список, и `html` — только чтобы проверить, что потерял парсер. Ответ обёрнут в конверт DataForSEO: данные в `tasks[0].result`, результат в `tasks[0].status_code` — отклонённый запрос всё равно возвращает HTTP 200. ### Справочные цены - Тарификация: стоимость ответа по данным провайдера. - Справочная оценка запроса: USD 0.0175. - Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента. Справочные метаданные, а не коммерческое предложение для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo. ## Base URL - `https://openapi.felo.ai` ## Authentication - `FeloBearerAuth` (http bearer, bearer format Felo API Key) - `FeloApiKey` (apiKey in header `X-API-Key`) ## Request body Required: **no** ### application/json Schema: ```json { "type": "array", "items": { "type": [ "object", "null" ], "oneOf": [ { "type": "object", "properties": { "keyword": { "type": "string", "description": "ключевое слово обязательное поле в поле keyword можно указать до 700 символов все %## будут декодированы (символ ‘+’ декодируется в пробел) если в keyword нужен символ “%”, укажите его как “%25”; если в keyword нужен символ “+”, укажите его как “%2B”; если это поле содержит такие параметры, как ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘cache:’, ‘define:’, ‘definition:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘site:’, стоимость задачи умножается на 5 Подробнее о правилах и ограничениях полей keyword и keywords в API DataForSEO читайте в этой статье справочного центра" }, "location_code": { "type": [ "integer", "null" ], "description": "код местоположения поисковой системы обязательное поле, если не указаны location_name или location_coordinate если используете это поле, location_name или location_coordinate указывать не нужно список доступных местоположений поисковых систем с их location_code можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/google/locations пример: 2840" }, "language_code": { "type": [ "string", "null" ], "description": "код языка поисковой системы необязательное поле, если указан language_name если используете это поле, language_name указывать не нужно список доступных языков поисковой системы с их language_code можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/google/languages пример: en" }, "depth": { "type": [ "integer", "null" ], "description": "глубина парсинга необязательное поле количество результатов в SERP значение по умолчанию: 10 максимальное значение: 200 С вашего аккаунта взимается плата за каждый SERP, содержащий до 10 результатов; Установка глубины выше 10 может привести к дополнительным списаниям, если поисковая система возвращает более 10 результатов; Стоимость можно рассчитать на странице Pricing." }, "device": { "type": [ "string", "null" ], "description": "тип устройства необязательное поле возвращать результаты для определённого типа устройства может принимать значения: desktop, mobile значение по умолчанию: desktop" }, "load_async_ai_overview": { "type": [ "boolean", "null" ], "description": "загрузка асинхронного AI-обзора необязательное поле установите true, чтобы получать элементы ai_overview в SERP, даже если они загружаются асинхронно; если задано false, вы получите элементы ai_overview только из кэша; значение по умолчанию: false Примечание: за использование этого параметра дополнительно взимается $0.002; если элемент отсутствует или содержит \"asynchronous_ai_overview\": false, все дополнительные списания будут возвращены на баланс вашего аккаунта" }, "location_name": { "type": [ "string", "null" ], "description": "полное название местоположения поисковой системы обязательное поле, если не указаны location_code или location_coordinate если используете это поле, location_code или location_coordinate указывать не нужно список доступных местоположений поисковой системы с их location_name можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/google/locations пример: London,England,United Kingdom" }, "language_name": { "type": [ "string", "null" ], "description": "полное название языка поисковой системы необязательное поле, если указан language_code если используете это поле, language_code указывать не нужно список доступных языков поисковой системы с их language_name можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/google/languages пример: English" }, "os": { "type": [ "string", "null" ], "description": "операционная система устройства необязательное поле если в поле device указано desktop, выбирайте из значений: windows, macos значение по умолчанию: windows если в поле device указано mobile, выбирайте из значений: android, ios значение по умолчанию: android" }, "tag": { "type": [ "string", "null" ], "description": "пользовательский идентификатор задачи необязательное поле ограничение — 255 символов этот параметр позволяет идентифицировать задачу и сопоставить её с результатом указанное значение tag можно найти в объекте data ответа" }, "stop_crawl_on_match": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "type": "object", "properties": { "match_value": { "type": [ "string", "null" ], "description": "целевой домен или значение с подстановкой\nобязательное поле, если указан stop_crawl_on_match;\nукажите целевой домен или значение с подстановкой;\nПримечание: имя домена указывается без протокола запроса;\nпример: dataforseo.com" }, "match_type": { "type": [ "string", "null" ], "description": "тип сопоставления цели\nобязательное поле, если указан stop_crawl_on_match;\nтип сопоставления для match_value\nвозможные значения: domain, with_subdomains, wildcard" } } } ] }, "description": "массив целей для остановки обхода\nнеобязательное поле\nесли указано, ответ будет содержать результаты SERP до указанного match_value включительно;\nв этом массиве можно указать до 10 целевых значений\nпример:\n\"stop_crawl_on_match\":[{\"match_value\":\"dataforseo.com\",\"match_type\":\"with_subdomains\"}]\nподробнее об этом параметре — в нашем справочном центре: https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api\nоплата взимается за каждый SERP, обойдённый по указанным целям" }, "match_type": { "type": [ "string", "null" ], "description": "тип соответствия цели обязательное поле, если указан stop_crawl_on_match тип соответствия для match_value возможные значения: domain – конкретный домен или поддомен with_subdomains – основной домен и поддомены wildcard – шаблон с подстановочными символами" }, "match_value": { "type": [ "string", "null" ], "description": "целевой домен, поддомен или значение шаблона обязательное поле, если указан stop_crawl_on_match укажите целевой домен, поддомен или значение шаблона; Примечание: домен или поддомен указывается без протокола запроса; пример: \"match_value\": \"dataforseo.com\", \"match_value\": \"/blog/post-*\"" }, "max_crawl_pages": { "type": [ "integer", "null" ], "description": "лимит обхода страниц необязательное поле количество страниц результатов поиска для обхода максимальное значение: 100 Примечание: плата взимается за каждую просканированную страницу (10 органических результатов на страницу); подробнее о тарифах — на странице Pricing; Примечание#2: параметры max_crawl_pages и depth дополняют друг друга; подробнее в нашем справочном центре" }, "search_param": { "type": [ "string", "null" ], "description": "дополнительные параметры поискового запроса необязательное поле список доступных параметров и подробности — здесь Примечание: следующие параметры поисковой системы не поддерживаются и будут автоматически сброшены, если указаны: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype." }, "remove_from_url": { "type": [ "array", "null" ], "items": { "type": "string" }, "description": "удаление определённых параметров из URL необязательное поле с помощью этого поля можно указать до 10 параметров для удаления из URL в результате пример: \"remove_from_url\": [\"srsltid\"] Примечание: если указано поле target, указанные параметры URL будут удалены перед поиском" }, "people_also_ask_click_depth": { "type": [ "integer", "null" ], "description": "клики по соответствующему элементу необязательное поле укажите глубину кликов по элементу people_also_ask, чтобы получить дополнительные элементы people_also_ask_element; Примечание: за каждый клик с аккаунта дополнительно взимается $0.00015; если элемент отсутствует или мы выполним меньше кликов, чем вы указали, все дополнительные списания будут возвращены на баланс вашего аккаунта возможные значения: от 1 до 4" }, "group_organic_results": { "type": [ "boolean", "null" ], "description": "показывать связанные результаты необязательное поле если задано true, элемент related_result в ответе будет предоставлен как сниппет его родительского органического результата; если задано false, элемент related_result будет предоставлен как отдельный органический результат; значение по умолчанию: true" }, "calculate_rectangles": { "type": [ "boolean", "null" ], "description": "расчёт пиксельных позиций для элементов SERP в расширенных результатах необязательное поле пиксельная позиция — это расстояние между сниппетом результата и верхним левым углом экрана; Подробнее в Help Center>> по умолчанию параметр установлен в false; Примечание: за использование этого параметра дополнительно взимается $0.002" }, "browser_screen_width": { "type": [ "integer", "null" ], "description": "ширина экрана браузера необязательное поле можно задать собственную ширину экрана браузера для расчёта пиксельных позиций для конкретного устройства; можно указать в следующем диапазоне: 240-9999; по умолчанию параметр установлен в: 1920 для десктопа; 360 для мобильных на android; 375 для мобильных на iOS; Примечание: чтобы использовать этот параметр, задайте для calculate_rectangles значение true", "format": "int64" }, "browser_screen_height": { "type": [ "integer", "null" ], "description": "высота экрана браузера необязательное поле можно задать собственную высоту экрана браузера для расчёта пиксельных позиций для конкретного устройства; можно указать в следующем диапазоне: 240-9999; по умолчанию параметр установлен в: 1080 для десктопа; 640 для мобильных на android; 812 для мобильных на iOS; Примечание: чтобы использовать этот параметр, задайте для calculate_rectangles значение true" }, "browser_screen_resolution_ratio": { "type": [ "integer", "null" ], "description": "коэффициент разрешения экрана браузера необязательное поле можно задать собственный коэффициент разрешения экрана браузера для расчёта пиксельных позиций для конкретного устройства; можно указать в следующем диапазоне: 0.5-3; по умолчанию параметр установлен в: 1 для десктопа; 3 для мобильных на android; 3 для мобильных на iOS; Примечание: чтобы использовать этот параметр, задайте для calculate_rectangles значение true" }, "url": { "type": [ "string", "null" ], "description": "прямой URL поискового запроса необязательное поле вы можете указать прямой URL, и мы разберём его по нужным полям. Учтите, что этот способ самый сложный для обработки нашим API и требует указать в URL точный язык и местоположение. В большинстве случаев мы не рекомендуем этот способ. пример: https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS Примечание: следующие параметры поисковой системы не поддерживаются и будут автоматически сброшены, если указаны: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype." }, "location_coordinate": { "type": [ "string", "null" ], "description": "GPS-координаты местоположения необязательное поле, если указаны location_name или location_code если используете это поле, location_name или location_code указывать не нужно параметр location_coordinate указывается в формате \"latitude,longitude,radius\" максимальное количество десятичных цифр для \"latitude\" и \"longitude\": 7 минимальное значение для \"radius\": 199 (мм) максимальное значение для \"radius\": 199999 (мм) пример: 53.476225,-2.243572,200" }, "se_domain": { "type": [ "string", "null" ], "description": "домен поисковой системы необязательное поле мы автоматически выбираем подходящий домен поисковой системы в соответствии с указанными местоположением и языком однако в этом поле можно задать собственный домен поисковой системы пример: google.co.uk, google.com.au, google.de и т. д." }, "target": { "type": [ "string", "null" ], "description": "целевой домен, поддомен или веб-страница для получения результатов необязательное поле домен или поддомен указывается без https:// и www. учтите, что результаты задач по target будут включать только элементы SERP, содержащие строку url; также можно использовать символ подстановки (‘*’), чтобы задать шаблон поиска в SERP и сузить результаты; примеры: example.com - возвращает результаты для домашней страницы сайта с URL, например https://example.com, https://www.example.com/ или https://example.com/; example.com* - возвращает результаты для домена, включая все его страницы; *example.com* - возвращает результаты для всего домена, включая все его страницы и поддомены; *example.com - возвращает результаты для домашней страницы независимо от поддомена, например https://en.example.com; example.com/example-page - возвращает результаты для точного URL; example.com/example-page* - возвращает результаты для всех URL домена, начинающихся с указанной строки" }, "target_search_mode": { "type": [ "string", "null" ], "description": "режим сопоставления целей необязательное поле чтобы включить этот параметр, также должен быть включён stop_crawl_on_match определяет, как должен останавливаться обход, если в stop_crawl_on_match указано несколько целей возможные значения: all, any all — обход останавливается только после обнаружения всех указанных целей any — обход останавливается при обнаружении любой одной цели значение по умолчанию: any подробнее об этом параметре — в нашем Help Center" }, "find_targets_in": { "type": [ "array", "null" ], "items": { "type": "string" }, "description": "типы элементов SERP для проверки на соответствие целям необязательное поле чтобы включить этот параметр, также должен быть включён stop_crawl_on_match указывает, какие типы элементов SERP следует проверять на совпадение с целями если не указано, на цели проверяются все элементы первого уровня с полями url и domain возможные значения: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter Примечание: не может содержать те же типы элементов, что и ignore_targets_in пример: \"find_targets_in\": [\"organic\", \"featured_snippet\"] подробнее об этом параметре — в нашем Help Center" }, "ignore_targets_in": { "type": [ "array", "null" ], "items": { "type": "string" }, "description": "типы элементов SERP, исключаемые из поиска целей необязательное поле чтобы включить этот параметр, также должен быть включён stop_crawl_on_match указывает, какие типы элементов SERP следует исключать при поиске совпадений с целями возможные значения: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter Примечание: не может содержать те же типы элементов, что и find_targets_in пример: \"ignore_targets_in\": [\"paid\", \"images\"] подробнее об этом параметре — в нашем Help Center" } }, "example": [ { "language_code": "en", "location_code": 2840, "keyword": "albert einstein", "calculate_rectangles": true } ] } ] }, "example": [ { "language_code": "en", "location_code": 2840, "keyword": "albert einstein", "calculate_rectangles": true } ] } ``` ## Responses ### 200 — Успешная операция Headers: - `X-Request-Id` (string) — Идентификатор запроса, который нужно указать при обращении в поддержку Felo. **application/json** Schema: object | null ```json { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResponseInfo" } ] } ``` ### 400 — Запрос не удалось обработать. Проверьте параметры запроса. ### 401 — Требуется действительный API-ключ Felo. ### 402 — Запрос не может быть выполнен: не выполнено требование биллинга. ### 403 — Аккаунту не разрешено выполнять эту операцию. ### 429 — Достигнут лимит запросов или расходов. ### 502 — Сервис не смог выполнить запрос. ### 503 — API или сервис биллинга временно недоступны. ### 504 — Истекло время ожидания обработки запроса. ### default — Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера **application/json** Schema: ```json {} ``` ## Schema definitions ### Response36Afe1097B20_AiModeRectangleInfo `#/components/schemas/Response36Afe1097B20_AiModeRectangleInfo` ```json { "type": "object", "properties": { "x": { "type": [ "number", "null" ], "description": "координата по оси x\nкоордината x левого верхнего угла сниппета результата, где началом координат является левый верхний угол экрана", "format": "double" }, "y": { "type": [ "number", "null" ], "description": "координата по оси y\nкоордината y левого верхнего угла сниппета результата, где началом координат является левый верхний угол экрана", "format": "double" }, "width": { "type": [ "number", "null" ], "description": "ширина элемента в пикселях", "format": "double" }, "height": { "type": [ "number", "null" ], "description": "высота элемента в пикселях", "format": "double" } } } ``` ### Response36Afe1097B20_AmazonLabelElement `#/components/schemas/Response36Afe1097B20_AmazonLabelElement` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "title": { "type": [ "string", "null" ], "description": "заголовок элемента" }, "url": { "type": [ "string", "null" ], "description": "URL поиска с параметрами уточнения" }, "domain": { "type": [ "string", "null" ], "description": "домен в SERP" } } } ``` ### Response36Afe1097B20_BaseResponseInfo `#/components/schemas/Response36Afe1097B20_BaseResponseInfo` ```json { "properties": { "version": { "type": [ "string", "null" ], "description": "текущая версия API" }, "status_code": { "type": [ "integer", "null" ], "description": "общий код состояния.\nПолный список кодов ответа можно найти здесь." }, "status_message": { "type": [ "string", "null" ], "description": "общее информационное сообщение.\nПолный список общих информационных сообщений можно найти здесь." }, "time": { "type": [ "string", "null" ], "description": "общее время выполнения, секунды" }, "cost": { "type": [ "number", "null" ], "description": "общая стоимость задач, USD", "format": "double" }, "tasks_count": { "type": [ "integer", "null" ], "description": "число задач в массиве tasks", "format": "int64" }, "tasks_error": { "type": [ "integer", "null" ], "description": "число задач в массиве tasks, возвращённых с ошибкой", "format": "int64" } } } ``` ### Response36Afe1097B20_BaseResponseTaskInfo `#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo` ```json { "properties": { "id": { "type": [ "string", "null" ], "description": "идентификатор задачи\nуникальный идентификатор задачи в нашей системе в формате UUID" }, "status_code": { "type": [ "integer", "null" ], "description": "код состояния задачи\nформируется DataForSEO, может находиться в диапазоне 10000-60000\nПолный список кодов ответа можно найти здесь." }, "status_message": { "type": [ "string", "null" ], "description": "информационное сообщение задачи\nПолный список общих информационных сообщений можно найти здесь." }, "time": { "type": [ "string", "null" ], "description": "время выполнения, секунды" }, "cost": { "type": [ "number", "null" ], "description": "общая стоимость задач, USD", "format": "double" }, "result_count": { "type": [ "integer", "null" ], "description": "число элементов в массиве result", "format": "int64" }, "path": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "путь URL" }, "data": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "object", "null" ] }, "description": "содержит те же параметры, что вы указали в POST-запросе" } } } ``` ### Response36Afe1097B20_BaseSerpApiElementItem `#/components/schemas/Response36Afe1097B20_BaseSerpApiElementItem` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "page": { "type": [ "integer", "null" ], "description": "номер страницы результатов поиска
указывает номер страницы SERP, на которой расположен элемент" }, "position": { "type": [ "string", "null" ], "description": "выравнивание элемента в SERP
может принимать следующие значения:
left, right" }, "xpath": { "type": [ "string", "null" ], "description": "XPath элемента" }, "rectangle": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_AiModeRectangleInfo" } ], "description": "параметры прямоугольника
содержит декартовы координаты и размеры в пикселях сниппета результата в SERP
равно null, если calculate_rectangles в POST-запросе не установлен в true" } }, "additionalProperties": false, "discriminator": { "propertyName": "type", "mapping": { "paid": "#/components/schemas/Response36Afe1097B20_PaidSerpElementItem", "organic": "#/components/schemas/Response36Afe1097B20_OrganicSerpElementItem", "featured_snippet": "#/components/schemas/Response36Afe1097B20_FeaturedSnippetSerpElementItem", "knowledge_graph": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphSerpElementItem", "top_stories": "#/components/schemas/Response36Afe1097B20_TopStoriesSerpElementItem", "people_also_ask": "#/components/schemas/Response36Afe1097B20_PeopleAlsoAskSerpElementItem", "people_also_search": "#/components/schemas/Response36Afe1097B20_PeopleAlsoSearchSerpElementItem", "images": "#/components/schemas/Response36Afe1097B20_ImagesSerpElementItem", "twitter": "#/components/schemas/Response36Afe1097B20_TwitterSerpElementItem", "google_reviews": "#/components/schemas/Response36Afe1097B20_GoogleReviewsSerpElementItem", "jobs": "#/components/schemas/Response36Afe1097B20_JobsSerpElementItem", "map": "#/components/schemas/Response36Afe1097B20_MapSerpElementItem", "app": "#/components/schemas/Response36Afe1097B20_AppSerpElementItem", "local_pack": "#/components/schemas/Response36Afe1097B20_LocalPackSerpElementItem", "carousel": "#/components/schemas/Response36Afe1097B20_CarouselSerpElementItem", "video": "#/components/schemas/Response36Afe1097B20_VideoSerpElementItem", "answer_box": "#/components/schemas/Response36Afe1097B20_AnswerBoxSerpElementItem", "shopping": "#/components/schemas/Response36Afe1097B20_ShoppingSerpElementItem", "google_flights": "#/components/schemas/Response36Afe1097B20_GoogleFlightsSerpElementItem", "events": "#/components/schemas/Response36Afe1097B20_EventsSerpElementItem", "related_searches": "#/components/schemas/Response36Afe1097B20_RelatedSearchesSerpElementItem", "multi_carousel": "#/components/schemas/Response36Afe1097B20_MultiCarouselSerpElementItem", "recipes": "#/components/schemas/Response36Afe1097B20_RecipesSerpElementItem", "top_sights": "#/components/schemas/Response36Afe1097B20_TopSightsSerpElementItem", "scholarly_articles": "#/components/schemas/Response36Afe1097B20_ScholarlyArticlesSerpElementItem", "popular_products": "#/components/schemas/Response36Afe1097B20_PopularProductsSerpElementItem", "stocks_box": "#/components/schemas/Response36Afe1097B20_StocksBoxSerpElementItem", "find_results_on": "#/components/schemas/Response36Afe1097B20_FindResultsOnSerpElementItem", "questions_and_answers": "#/components/schemas/Response36Afe1097B20_QuestionsAndAnswersSerpElementItem", "hotels_pack": "#/components/schemas/Response36Afe1097B20_HotelsPackSerpElementItem", "commercial_units": "#/components/schemas/Response36Afe1097B20_CommercialUnitsSerpElementItem", "local_services": "#/components/schemas/Response36Afe1097B20_LocalServicesSerpElementItem", "google_hotels": "#/components/schemas/Response36Afe1097B20_GoogleHotelsSerpElementItem", "math_solver": "#/components/schemas/Response36Afe1097B20_MathSolverSerpElementItem", "currency_box": "#/components/schemas/Response36Afe1097B20_CurrencyBoxSerpElementItem", "product_considerations": "#/components/schemas/Response36Afe1097B20_ProductConsiderationsSerpElementItem", "short_videos": "#/components/schemas/Response36Afe1097B20_ShortVideosSerpElementItem", "refine_products": "#/components/schemas/Response36Afe1097B20_RefineProductsSerpElementItem", "perspectives": "#/components/schemas/Response36Afe1097B20_PerspectivesSerpElementItem", "discussions_and_forums": "#/components/schemas/Response36Afe1097B20_DiscussionsAndForumsSerpElementItem", "compare_sites": "#/components/schemas/Response36Afe1097B20_CompareSitesSerpElementItem", "knowledge_graph_carousel_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphCarouselItemSerpElementItem", "knowledge_graph_description_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphDescriptionItemSerpElementItem", "knowledge_graph_images_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphImagesItemSerpElementItem", "knowledge_graph_list_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphListItemSerpElementItem", "knowledge_graph_row_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphRowItemSerpElementItem", "knowledge_graph_hotels_booking_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphHotelsBookingItemSerpElementItem", "knowledge_graph_expanded_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphExpandedItemSerpElementItem", "knowledge_graph_part_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphPartItemSerpElementItem", "knowledge_graph_shopping_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphShoppingItemSerpElementItem", "knowledge_graph_ai_overview_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphAiOverviewItemSerpElementItem", "ai_overview": "#/components/schemas/Response36Afe1097B20_AiOverviewSerpElementItem", "third_party_reviews": "#/components/schemas/Response36Afe1097B20_ThirdPartyReviewsSerpElementItem", "dictionary": "#/components/schemas/Response36Afe1097B20_DictionarySerpElementItem", "google_posts": "#/components/schemas/Response36Afe1097B20_GooglePostsSerpElementItem", "mention_carousel": "#/components/schemas/Response36Afe1097B20_MentionCarouselSerpElementItem", "podcasts": "#/components/schemas/Response36Afe1097B20_PodcastsSerpElementItem", "visual_stories": "#/components/schemas/Response36Afe1097B20_VisualStoriesSerpElementItem", "found_on_web": "#/components/schemas/Response36Afe1097B20_FoundOnWebSerpElementItem", "explore_brands": "#/components/schemas/Response36Afe1097B20_ExploreBrandsSerpElementItem", "courses": "#/components/schemas/Response36Afe1097B20_CoursesSerpElementItem" } } } ``` ### Response36Afe1097B20_RefinementChipsElement `#/components/schemas/Response36Afe1097B20_RefinementChipsElement` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "title": { "type": [ "string", "null" ], "description": "заголовок элемента" }, "url": { "type": [ "string", "null" ], "description": "URL поиска с параметрами уточнения" }, "domain": { "type": [ "string", "null" ], "description": "домен в SERP" }, "options": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_AmazonLabelElement" } ] }, "description": "дополнительные параметры уточнения поиска" } } } ``` ### Response36Afe1097B20_RefinementChipsInfo `#/components/schemas/Response36Afe1097B20_RefinementChipsInfo` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "xpath": { "type": [ "string", "null" ], "description": "XPath элемента" }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_RefinementChipsElement" } ] }, "description": "дочерние элементы" } } } ``` ### Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResponseInfo `#/components/schemas/Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResponseInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo" }, { "type": "object", "properties": { "tasks": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedTaskInfo" } ] }, "description": "массив задач" } } } ] } ``` ### Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResultInfo `#/components/schemas/Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResultInfo` ```json { "type": "object", "properties": { "keyword": { "type": [ "string", "null" ], "description": "ключевое слово, полученное в массиве POST. ключевое слово возвращается с декодированными %## (символ '+' будет декодирован в пробел)." }, "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "se_domain": { "type": [ "string", "null" ], "description": "домен поисковой системы в POST-массиве" }, "location_code": { "type": [ "integer", "null" ], "description": "код местоположения в массиве POST" }, "language_code": { "type": [ "string", "null" ], "description": "код языка в массиве POST" }, "check_url": { "type": [ "string", "null" ], "description": "прямой URL к результатам поисковой системы\nего можно использовать, чтобы убедиться, что мы предоставили точные результаты" }, "datetime": { "type": [ "string", "null" ], "description": "дата и время получения результата\nв формате UTC: “yyyy-mm-dd hh-mm-ss +00:00”\nпример:\n2019-11-15 12:57:46 +00:00" }, "spell": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_SpellInfo" } ], "description": "автокоррекция поисковой системы\nесли поисковая система предоставила результаты для исправленного ключевого слова, мы укажем ключевое слово, исправленное поисковой системой, и тип автокоррекции" }, "refinement_chips": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_RefinementChipsInfo" } ], "description": "чипы уточнения поиска" }, "item_types": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "типы результатов поиска в SERP. содержит типы результатов поиска (items), найденных в SERP. возможные типы элементов: answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, recipes, top_sights, scholarly_articles, popular_products, questions_and_answers, find_results_on, stocks_box, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, short_videos, refine_products, perspectives, discussions_and_forums, compare_sites, ai_overview" }, "se_results_count": { "type": [ "integer", "null" ], "description": "общее количество результатов в SERP", "format": "int64" }, "pages_count": { "type": [ "integer", "null" ], "description": "всего получено страниц поисковых результатов. общее число полученных SERP в результате.", "format": "int64" }, "items_count": { "type": [ "integer", "null" ], "description": "количество результатов, возвращённых в массиве items", "format": "int64" }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseSerpApiElementItem" } ] }, "description": "дочерние элементы" } } } ``` ### Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedTaskInfo `#/components/schemas/Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedTaskInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo" }, { "type": "object", "properties": { "result": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResultInfo" } ] }, "description": "массив результатов" } } } ] } ``` ### Response36Afe1097B20_SpellInfo `#/components/schemas/Response36Afe1097B20_SpellInfo` ```json { "properties": { "keyword": { "type": [ "string", "null" ], "description": "ключевое слово, полученное в результате автокоррекции поисковой системы\nрезультаты будут предоставлены для исправленного ключевого слова" }, "type": { "type": [ "string", "null" ], "description": "тип автокоррекции\nвозможные значения:\ndid_you_mean, showing_results_for, no_results_found_for, including_results_for\nпримечание: Yahoo и Yandex поддерживают только следующий тип автокоррекции:\nincluding_results_for" } } } ```