# Получить расширенные результаты ChatGPT LLM Scraper по id **API:** Data API **Endpoint:** `GET /v1/beta/dataforseo/ai_optimization/chat_gpt/llm_scraper/task_get/advanced/{id}` **Tags:** DataForSEO Получает поставленный в очередь скрапинг ChatGPT по `id`. Та же разобранная структура, что у живого эндпоинта. Обёрнуто в конверт DataForSEO: данные в `tasks[0].result`, результат в `tasks[0].status_code` — отклонённый запрос всё равно возвращает HTTP 200. ### Справочные данные о ценах - Тарификация: заявленная стоимость ответа. - Ориентировочная стоимость запроса: USD 0.012. - Справочный множитель для клиента: 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`) ## Parameters | Name | In | Required | Type | Description | | --- | --- | --- | --- | --- | | `id` | path | yes | string | идентификатор задачи
универсальный уникальный идентификатор (UUID)
уникальный идентификатор задачи в нашей системе
в течение 30 дней вы сможете в любое время запросить по нему результаты задачи | ## Responses ### 200 — Успешная операция Headers: - `X-Request-Id` (string) — Идентификатор запроса, который нужно указать при обращении в поддержку Felo. **application/json** Schema: object | null ```json { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_AiOptimizationChatGptLlmScraperTaskGetAdvancedResponseInfo" } ] } ``` ### 400 — Запрос не удалось обработать. Проверьте параметры запроса. ### 401 — Требуется действительный API-ключ Felo. ### 402 — Запрос не может быть выполнен: не выполнено требование биллинга. ### 403 — Аккаунту не разрешено выполнять эту операцию. ### 429 — Достигнут лимит запросов или расходов. ### 502 — Сервис не смог выполнить запрос. ### 503 — API или сервис биллинга временно недоступны. ### 504 — Истекло время ожидания обработки запроса. ### default — Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера **application/json** Schema: ```json {} ``` ## Schema definitions ### Response36Afe1097B20_AiOptimizationChatGptLlmScraperTaskGetAdvancedResponseInfo `#/components/schemas/Response36Afe1097B20_AiOptimizationChatGptLlmScraperTaskGetAdvancedResponseInfo` ```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_AiOptimizationChatGptLlmScraperTaskGetAdvancedTaskInfo" } ] }, "description": "массив задач" } } } ] } ``` ### Response36Afe1097B20_AiOptimizationChatGptLlmScraperTaskGetAdvancedResultInfo `#/components/schemas/Response36Afe1097B20_AiOptimizationChatGptLlmScraperTaskGetAdvancedResultInfo` ```json { "type": "object", "properties": { "keyword": { "type": [ "string", "null" ], "description": "ключевое слово, полученное в массиве POST
ключевое слово возвращается с декодированными %## (символ '+' будет декодирован в пробел)" }, "location_code": { "type": [ "integer", "null" ], "description": "код местоположения в массиве POST" }, "language_code": { "type": [ "string", "null" ], "description": "код языка в массиве POST" }, "model": { "type": [ "string", "null" ], "description": "указывает версию модели" }, "check_url": { "type": [ "string", "null" ], "description": "прямой URL к результатам поисковой системы
с его помощью можно убедиться, что мы предоставили точные результаты" }, "datetime": { "type": [ "string", "null" ], "description": "дата и время получения результата
в формате UTC: “yyyy-mm-dd hh-mm-ss +00:00”
пример:
2019-11-15 12:57:46 +00:00" }, "markdown": { "type": [ "string", "null" ], "description": "содержимое элемента в формате markdown
содержимое результата, отформатированное на языке разметки markdown" }, "search_results": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_ChatgptSearchResult" } ] }, "description": "массив результатов поиска
все результаты веб-поиска, полученные моделью при поиске информации, включая дубликаты и неиспользованные записи" }, "sources": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_SourceInfo" } ] }, "description": "массив источников
источники, на которые модель фактически ссылалась или опиралась в окончательном ответе" }, "fan_out_queries": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "массив fan-out запросов
содержит связанные поисковые запросы, производные от основного запроса, для более полного ответа" }, "brand_entities": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_ChatGptBrandEntity" } ] }, "description": "массив сущностей брендов
содержит информацию о брендах, упомянутых в ответе" }, "se_results_count": { "type": [ "integer", "null" ], "description": " общее количество результатов", "format": "int64" }, "item_types": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "типы результатов поиска
содержит типы результатов поиска (items), которые были найдены.
возможные типы элементов:
chat_gpt_text, chat_gpt_table, chat_gpt_navigation_list, chat_gpt_images, chat_gpt_local_businesses, chat_gpt_products" }, "items_count": { "type": [ "integer", "null" ], "description": "количество результатов, возвращённых в массиве items", "format": "int64" }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseChatGptLlmScraperElementItem" } ] }, "description": "элементы, содержащиеся в элементе" } } } ``` ### Response36Afe1097B20_AiOptimizationChatGptLlmScraperTaskGetAdvancedTaskInfo `#/components/schemas/Response36Afe1097B20_AiOptimizationChatGptLlmScraperTaskGetAdvancedTaskInfo` ```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_AiOptimizationChatGptLlmScraperTaskGetAdvancedResultInfo" } ] }, "description": "массив результатов" } } } ] } ``` ### Response36Afe1097B20_BaseChatGptLlmScraperElementItem `#/components/schemas/Response36Afe1097B20_BaseChatGptLlmScraperElementItem` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "rank_group": { "type": [ "integer", "null" ], "description": "групповой ранг в SERP
позиция внутри группы элементов с одинаковыми значениями type
позиции элементов с другими значениями type не учитываются в rank_group" }, "rank_absolute": { "type": [ "integer", "null" ], "description": "абсолютный ранг в SERP
абсолютная позиция среди всех элементов" } }, "additionalProperties": false, "discriminator": { "propertyName": "type", "mapping": { "chat_gpt_text": "#/components/schemas/Response36Afe1097B20_ChatGptTextElementItem", "chat_gpt_table": "#/components/schemas/Response36Afe1097B20_ChatGptTableElementItem", "chat_gpt_navigation_list": "#/components/schemas/Response36Afe1097B20_ChatGptNavigationListElementItem", "chat_gpt_images": "#/components/schemas/Response36Afe1097B20_ChatGptImagesElementItem", "chat_gpt_products": "#/components/schemas/Response36Afe1097B20_ChatGptProductsElementItem", "chat_gpt_local_businesses": "#/components/schemas/Response36Afe1097B20_ChatGptLocalBusinessesElementItem", "chat_gpt_ad": "#/components/schemas/Response36Afe1097B20_ChatGptAdElementItem" } } } ``` ### 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_ChatGptBrandEntity `#/components/schemas/Response36Afe1097B20_ChatGptBrandEntity` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "title": { "type": [ "string", "null" ], "description": "название бренда" }, "category": { "type": [ "string", "null" ], "description": "категория бренда" }, "markdown": { "type": [ "string", "null" ], "description": "название бренда в формате markdown
содержит название бренда, отформатированное с помощью языка разметки markdown" }, "urls": { "type": [ "object", "null" ], "description": " массив URL и доменов, относящихся к бренду" } } } ``` ### Response36Afe1097B20_ChatgptSearchResult `#/components/schemas/Response36Afe1097B20_ChatgptSearchResult` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "url": { "type": [ "string", "null" ], "description": "URL результата" }, "domain": { "type": [ "string", "null" ], "description": "домен результата" }, "title": { "type": [ "string", "null" ], "description": "заголовок результата" }, "description": { "type": [ "string", "null" ], "description": "описание результата" }, "breadcrumb": { "type": [ "string", "null" ], "description": "навигационная цепочка" } } } ``` ### Response36Afe1097B20_SourceInfo `#/components/schemas/Response36Afe1097B20_SourceInfo` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "title": { "type": [ "string", "null" ], "description": "заголовок источника" }, "snippet": { "type": [ "string", "null" ], "description": "описание источника" }, "domain": { "type": [ "string", "null" ], "description": "домен источника в SERP" }, "url": { "type": [ "string", "null" ], "description": "исходный URL" }, "thumbnail": { "type": [ "string", "null" ], "description": "миниатюра источника" }, "source_name": { "type": [ "string", "null" ], "description": "название источника" }, "publication_date": { "type": [ "string", "null" ], "description": "дата и время публикации результата
в формате: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”
пример:
2019-11-15 12:57:46 +00:00" }, "markdown": { "type": [ "string", "null" ], "description": "содержимое элемента в формате markdown
содержимое результата, отформатированное на языке разметки markdown" } } } ```