> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. # 实时 Gemini LLM 抓取器高级版 > Live Gemini LLM Scraper 端点提供来自 Gemini 的结构化结果。 ## OpenAPI ````yaml openapi/zh/dataforseo.json POST /dataforseo/ai_optimization/gemini/llm_scraper/live/advanced openapi: 3.0.3 info: title: DataForSEO API version: 1.0.0 description: 通过 AIsa 统一网关提供的 DataForSEO API 端点。 servers: - url: https://api.aisa.one/apis/v1 security: - BearerAuth: [] paths: /dataforseo/ai_optimization/gemini/llm_scraper/live/advanced: post: summary: 实时 Gemini LLM 抓取器高级版 description: >- 实时 Gemini LLM 抓取器端点提供来自 Gemini 的结构化结果。结果取决于所选位置（请参阅[位置列表](https://docs.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/locations.md)）、语言（请参阅[语言列表](https://docs.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/languages.md)）和关键词。 operationId: post_dataforseo_ai_optimization_gemini_llm_scraper_live_advanced requestBody: required: true content: application/json: schema: type: object properties: keyword: type: string description: >- keyword 必填字段。您可以在 keyword 字段中指定最多 2000 个字符。所有 %## 都将被解码（加号字符“+”将被解码为空格字符）。如果需要在关键词中使用“%”字符，请将其指定为“%25”；如果需要在关键词中使用“+”字符，请将其指定为“%2B”。有关 DataForSEO API 中 keyword 和 keywords 字段的规则与限制的更多信息，请参阅此帮助中心文章 location_name: type: string description: >- 搜索引擎位置的完整名称；如果未指定 location_code，则为必填字段。如果使用此字段，则无需指定 location_code。您可以向 https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/locations 单独发出请求，以获取搜索引擎的可用位置及其 location_name 列表；示例：United States location_code: type: integer description: >- 搜索引擎位置代码；如果未指定 location_name，则为必填字段；如果使用此字段，则无需指定 location_name；您可以通过向 https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/locations 单独发出请求，获取搜索引擎可用位置及其 location_code 的列表；示例：2840 language_name: type: string description: >- 搜索引擎语言的完整名称。如果未指定 language_code，则为必填字段；如果使用此字段，则无需指定 language_code；可通过向 https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/languages 单独发送请求，获取搜索引擎的可用语言及其 language_name。示例：English language_code: type: string description: >- 搜索引擎语言代码。如果未指定 language_name，则此字段为必填字段；如果使用此字段，则无需指定 language_name；您可以单独向 https://api.dataforseo.com/v3/ai_optimization/gemini/llm_scraper/languages 发出请求，以获取搜索引擎可用语言及其 language_code_ 的列表。示例：enn tag: type: string description: >- 用户定义的任务标识符。可选字段。字符数限制为 255。您可以使用此参数标识任务并将其与结果匹配；您将在响应的 data 对象中找到指定的 tag 值 required: - keyword - location_name - location_code - language_name - language_code responses: '200': description: 成功响应 content: application/json: schema: type: object properties: version: type: string description: API 的当前版本 status_code: type: integer description: 通用状态码；您可以在此处查看完整的响应码列表。注意：我们强烈建议设计必要的系统来处理相关异常或错误情况 status_message: type: string description: 常规信息消息；可在此处查看常规信息消息的完整列表 time: type: string description: 执行时间（秒） cost: type: number description: 任务总成本（美元） tasks_count: type: integer description: tasks 数组中的任务数量 tasks_error: type: integer description: 返回错误的 tasks 数组中的任务数量 tasks: type: array items: type: string description: 任务数组 tasks.id: type: string description: 任务标识符，系统中采用 UUID 格式的唯一任务标识符 tasks.status_code: type: integer description: DataForSEO 生成的任务状态码；范围为：10000-60000；完整响应代码列表可在此处查看 tasks.status_message: type: string description: 任务的信息性消息，你可以在此处查看通用信息性消息的完整列表 tasks.time: type: string description: 执行时间（秒） tasks.cost: type: number description: 任务成本（美元） tasks.result_count: type: integer description: 结果数组中的元素数量 tasks.path: type: array items: type: string description: URL 路径 tasks.data: type: object description: 包含您在 POST 请求中指定的相同参数 tasks.result: type: array items: type: string description: 结果数组 tasks.result.keyword: type: string description: 通过 POST 数组接收的 keyword；返回时会解码 %##（加号“+”将被解码为空格字符） tasks.result.location_code: type: integer description: POST 数组中的位置代码 tasks.result.language_code: type: string description: POST 数组中的语言代码 tasks.result.model: type: string description: 指示模型版本 tasks.result.datetime: type: string description: >- 以 UTC 格式接收结果的日期和时间：“yyyy-mm-dd hh-mm-ss +00:00”，示例：2019-11-15 12:57:46 +00:00 tasks.result.markdown: type: string description: Markdown 格式的元素内容，即使用 Markdown 标记语言格式化的结果内容 tasks.result.sources: type: array items: type: string description: 来源数组 模型在最终答案中实际引用或依据的来源 tasks.result.sources.type: type: string description: 元素类型='gemini_source' tasks.result.sources.title: type: string description: 来源标题 tasks.result.sources.snippet: type: string description: 来源描述 tasks.result.sources.domain: type: string description: 来源域名 tasks.result.sources.url: type: string description: 来源 URL tasks.result.sources.thumbnail: type: string description: 来源缩略图 tasks.result.sources.source_name: type: string description: 来源名称 tasks.result.sources.publication_date: type: string description: >- 结果发布日期和时间，格式为：“年-月-日 时:分:秒 UTC_时差小时数:UTC_时差分钟数”，示例：2019-11-15 12:57:46 +00:00 tasks.result.sources.markdown: type: string description: Markdown 格式的元素内容，即使用 Markdown 标记语言格式化的结果内容 tasks.result.se_results_count: type: integer description: 结果总数 tasks.result.item_types: type: array items: type: string description: >- 搜索结果类型，包含 SERP 中找到的搜索结果（项目）类型。可能的项目类型：gemini_text、gemini_table、gemini_images tasks.result.items_count: type: integer description: items 数组中返回的结果数量 tasks.result.items: type: array items: type: string description: Gemini 结果的元素 tasks.result.items.gemini_text: type: object description: 响应中的元素 tasks.result.items.gemini_text.type: type: string description: 元素类型='gemini_text' tasks.result.items.gemini_text.rank_group: type: integer description: >- SERP 中的组内排名，即在 type 值相同的一组元素中的位置；type 值不同的元素位置不会计入 rank_group tasks.result.items.gemini_text.rank_absolute: type: integer description: SERP 中的绝对排名，即该元素在 SERP 所有元素中的绝对位置 tasks.result.items.gemini_text.markdown: type: string description: Markdown 格式的元素内容，即使用 Markdown 标记语言格式化的结果内容 tasks.result.items.gemini_text.original_text: type: string description: 元素的未格式化文本内容 tasks.result.items.gemini_text.sources: type: array items: type: string description: 来源数组 tasks.result.items.gemini_text.sources.type: type: string description: 元素类型='gemini_source' tasks.result.items.gemini_text.sources.title: type: string description: 来源标题 tasks.result.items.gemini_text.sources.snippet: type: string description: 来源描述 tasks.result.items.gemini_text.sources.domain: type: string description: SERP 中的来源域名 tasks.result.items.gemini_text.sources.url: type: string description: 来源 URL tasks.result.items.gemini_text.sources.thumbnail: type: string description: 来源缩略图 tasks.result.items.gemini_text.sources.source_name: type: string description: 来源名称 tasks.result.items.gemini_text.sources.publication_date: type: string description: >- 结果发布日期和时间，格式为：“年-月-日 时:分:秒 UTC_时差小时数:UTC_时差分钟数”，示例：2019-11-15 12:57:46 +00:00 tasks.result.items.gemini_text.sources.markdown: type: string description: Markdown 格式的元素内容，即使用 Markdown 标记语言格式化的结果内容 tasks.result.items.gemini_table: type: object description: 响应中的元素 tasks.result.items.gemini_table.type: type: string description: element='gemini_table' 的类型 tasks.result.items.gemini_table.rank_group: type: integer description: >- SERP 中的组内排名，即在 type 值相同的一组元素中的位置；type 值不同的元素位置不会计入 rank_group tasks.result.items.gemini_table.rank_absolute: type: integer description: SERP 中的绝对排名，即该元素在 SERP 所有元素中的绝对位置 tasks.result.items.gemini_table.markdown: type: string description: Markdown 格式的元素内容，即使用 Markdown 标记语言格式化的结果内容 tasks.result.items.gemini_table.original_text: type: string description: 元素的未格式化文本内容 tasks.result.items.gemini_table.table: type: object description: 元素中的表格，包括元素中表格的表头和内容 tasks.result.items.gemini_table.table.table_header: type: array items: type: string description: 表格标题中的内容 tasks.result.items.gemini_table.table.table_content: type: array items: type: string description: 元素中表格内容的数组，每个数组代表一个表格行 tasks.result.items.gemini_images: type: object description: 响应中的元素 tasks.result.items.gemini_images.type: type: string description: element='gemini_images' 的类型 tasks.result.items.gemini_images.rank_group: type: integer description: >- SERP 中的组内排名，即在 type 值相同的一组元素中的位置；type 值不同的元素位置不会计入 rank_group tasks.result.items.gemini_images.rank_absolute: type: integer description: SERP 中的绝对排名，即该元素在 SERP 所有元素中的绝对位置 tasks.result.items.gemini_images.markdown: type: string description: Markdown 格式的元素内容，即使用 Markdown 标记语言格式化的结果内容 tasks.result.items.gemini_images.items: type: array items: type: string description: 元素中的项目 tasks.result.items.gemini_images.items.type: type: string description: 元素类型 = 'gemini_images_element' tasks.result.items.gemini_images.items.url: type: string description: 相关 URL tasks.result.items.gemini_images.items.alt: type: string description: 图片的 alt 标签 tasks.result.items.gemini_images.items.image_url: type: string description: 图片的 URL；该 URL 指向原始资源或 DataForSEO 存储中的图片（当原始来源不可用时） tasks.result.items.gemini_images.items.markdown: type: string description: Markdown 格式的元素内容，即使用 Markdown 标记语言格式化的结果内容 '400': description: 错误请求 '401': description: 未授权 '429': description: 超出速率限制 '500': description: 内部服务器错误 components: securitySchemes: BearerAuth: type: http scheme: bearer ````