实时 ChatGPT LLM 抓取器
实时 ChatGPT LLM Scraper 端点提供 ChatGPT 搜索结果。
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
keyword 必填字段。您可以在 keyword 字段中指定最多 2000 个字符。所有 %## 都将被解码(加号字符“+”将被解码为空格字符)。如果需要在关键词中使用“%”字符,请将其指定为“%25”;如果需要在关键词中使用“+”字符,请将其指定为“%2B”。有关 DataForSEO API 中 keyword 和 keywords 字段的规则与限制的更多信息,请参阅此帮助中心文章
搜索引擎位置的完整名称。如果未指定 location_code,则为必填字段。如果使用此字段,则无需指定 location_code。您可以通过向 https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locations 单独发送请求,获取包含 location_name 的搜索引擎可用位置列表。示例:United States
搜索引擎位置代码;如果未指定 location_name,则为必填字段;如果使用此字段,则无需指定 location_name;您可以通过向 https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locations 单独发出请求,获取搜索引擎可用位置及其 location_code 的列表;示例:2840
搜索引擎语言的完整名称。如果未指定 language_code,则为必填字段;如果使用此字段,则无需指定 language_code;您可以通过向 https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/languages 单独发出请求,获取包含 language_name 的搜索引擎可用语言列表。
搜索引擎语言代码。如果未指定 language_name,则为必填字段;如果使用此字段,则无需指定 language_name;您可以通过向 https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/languages 单独发出请求,获取包含 language_code 的搜索引擎可用语言列表。
强制 AI 智能体使用网页搜索 可选字段 启用后,将强制 AI 模型访问并引用当前网页信息;默认值:false;注意:即使将该参数设置为 true,也不能保证响应中会引用网页来源
用户定义的任务标识符。可选字段。字符数限制为 255。您可以使用此参数标识任务并将其与结果匹配;您将在响应的 data 对象中找到指定的 tag 值
响应
成功响应
API 的当前版本
通用状态码;您可以在此处查看完整的响应码列表。注意:我们强烈建议设计必要的系统来处理相关异常或错误情况
常规信息消息;可在此处查看常规信息消息的完整列表
执行时间(秒)
任务总成本(美元)
tasks 数组中的任务数量
返回错误的 tasks 数组中的任务数量
任务数组
任务标识符,系统中采用 UUID 格式的唯一任务标识符
DataForSEO 生成的任务状态码;范围为:10000-60000;完整响应代码列表可在此处查看
任务的信息性消息,你可以在此处查看通用信息性消息的完整列表
执行时间(秒)
任务成本(美元)
结果数组中的元素数量
URL 路径
包含您在 POST 请求中指定的相同参数
结果数组
通过 POST 数组接收的 keyword;返回时会解码 %##(加号“+”将被解码为空格字符)
POST 数组中的位置代码
POST 数组中的语言代码
指示模型版本
搜索引擎结果的直接 URL,可用于确认我们提供的结果准确无误
以 UTC 格式接收结果的日期和时间:“yyyy-mm-dd hh-mm-ss +00:00”,示例:2019-11-15 12:57:46 +00:00
Markdown 格式的元素内容,即使用 Markdown 标记语言格式化的结果内容
搜索结果数组,包含模型在查找信息时检索到的所有网页搜索输出,包括重复项和未使用的条目
element='chatgpt_search_result' 的类型n
结果 URL
结果域名
结果标题
结果描述
面包屑导航
来源数组 模型在最终答案中实际引用或依据的来源
元素类型='chat_gpt_source'
来源标题
来源描述
来源域名
来源 URL
来源缩略图
来源名称
结果发布日期和时间,格式为:“年-月-日 时:分:秒 UTC_时差小时数:UTC_时差分钟数”,示例:2019-11-15 12:57:46 +00:00
Markdown 格式的元素内容,即使用 Markdown 标记语言格式化的结果内容
扩展查询数组,包含从主查询派生的相关搜索查询,以提供更全面的响应
品牌实体数组,包含响应中提及的品牌信息
元素类型 = 'chat_gpt_brand_entity'
品牌名称
品牌类别
Markdown 格式的品牌名称,包含使用 Markdown 标记语言格式化的品牌名称
与品牌相关的 URL 和域名数组
URL
域名
结果总数
搜索结果类型;包含 SERP 中找到的搜索结果(项目)类型。可能的项目类型:chat_gpt_text、chat_gpt_table、chat_gpt_navigation_list、chat_gpt_images、chat_gpt_local_businesses、chat_gpt_products
items 数组中返回的结果数量
ChatGPT 结果元素
响应中的元素
元素类型='chat_gpt_text'
SERP 中的组内排名,即在 type 值相同的一组元素中的位置;type 值不同的元素位置不会计入 rank_group
SERP 中的绝对排名,即该元素在 SERP 所有元素中的绝对位置
Markdown 格式的元素内容,即使用 Markdown 标记语言格式化的结果内容
来源数组
element='chat_gpt_source'n 的类型
来源标题
来源描述
SERP 中的来源域名
来源 URL
来源缩略图
来源名称
结果发布日期和时间,格式为:“年-月-日 时:分:秒 UTC_时差小时数:UTC_时差分钟数”,示例:2019-11-15 12:57:46 +00:00
Markdown 格式的元素内容,即使用 Markdown 标记语言格式化的结果内容
品牌实体数组,包含文本中提及的品牌信息
元素类型 = 'chat_gpt_brand_entity'
品牌名称
品牌类别
Markdown 格式的品牌名称,包含使用 Markdown 标记语言格式化的品牌名称
与品牌相关的 URL 和域名数组
URL
域名
响应中的元素
元素类型='chat_gpt_table'
SERP 中的组内排名,即在 type 值相同的一组元素中的位置;type 值不同的元素位置不会计入 rank_group
SERP 中的绝对排名,即该元素在 SERP 所有元素中的绝对位置
元素文本
Markdown 格式的元素内容,即使用 Markdown 标记语言格式化的结果内容
元素中的表格,包括元素中表格的表头和内容
表格标题中的内容
元素中表格内容的数组,每个数组代表一个表格行
品牌实体数组,包含表格中提及的品牌信息
元素类型 = 'chat_gpt_brand_entity'
品牌名称
品牌类别
Markdown 格式的品牌名称,包含使用 Markdown 标记语言格式化的品牌名称
与品牌相关的 URL 和域名数组
URL
域名
响应中的元素
元素类型='chat_gpt_navigation_list'
SERP 中的组内排名,即在 type 值相同的一组元素中的位置;type 值不同的元素位置不会计入 rank_group
SERP 中的绝对排名,即该元素在 SERP 所有元素中的绝对位置
元素标题
来源数组
元素类型='chat_gpt_source'
来源标题
来源描述
SERP 中的来源域名
来源 URL
来源缩略图
来源名称
结果发布日期和时间,格式为:“年-月-日 时:分:秒 UTC_时差小时数:UTC_时差分钟数”,示例:2019-11-15 12:57:46 +00:00
Markdown 格式的元素内容,即使用 Markdown 标记语言格式化的结果内容
响应中的元素
元素类型='chat_gpt_images'
SERP 中的组内排名,即在 type 值相同的一组元素中的位置;type 值不同的元素位置不会计入 rank_group
SERP 中的绝对排名,即该元素在 SERP 所有元素中的绝对位置
Markdown 格式的元素内容,即使用 Markdown 标记语言格式化的结果内容
元素中的项目
元素类型 = 'chat_gpt_images_element'
图片的 alt 标签
相关 URL
图片的 URL;该 URL 指向原始资源或 DataForSEO 存储中的图片(当原始来源不可用时)
Markdown 格式的元素内容,即使用 Markdown 标记语言格式化的结果内容
响应中的元素
元素类型='chat_gpt_local_businesses'
SERP 中的组内排名,即在 type 值相同的一组元素中的位置;type 值不同的元素位置不会计入 rank_group
SERP 中的绝对排名,即该元素在 SERP 所有元素中的绝对位置
Markdown 格式的元素内容,即使用 Markdown 标记语言格式化的结果内容
元素中的项目
元素类型 = 'chat_gpt_local_businesses_element'
本地商家的标题
本地商家的描述
本地商家的地址
本地商家的电话号码
为该本地商家提交的评论总数
本地商家的网站 URL
本地商家的域名
对应本地商家的热门度评分,基于评论计算并显示在 SERP 中
评分类型,可包含以下值:Max5、Percents、CustomMax
基于所有评论计算的平均评分
投票数
rating_type 的最大值
响应中的元素
element='chat_gpt_products' 的类型
SERP 中的组内排名,即在 type 值相同的一组元素中的位置;type 值不同的元素位置不会计入 rank_group
SERP 中的绝对排名,即该元素在 SERP 所有元素中的绝对位置
元素中的项目
元素类型 = 'chat_gpt_products_element'
产品 ID
提供该产品的商家
产品标识符 token,经过 Base64 编码的 token,其中包含与该产品关联的 Google Shopping 产品 ID
产品标题
基于评论得出的产品受欢迎程度评分,显示在 SERP 中
评分类型,可包含以下值:Max5、Percents、CustomMax
基于所有评论计算的平均评分
投票数
rating_type 的最大值
产品价格
所列价格的货币,即应用于该价格的货币 ISO 代码
标签文本
结果 URL
SERP 中的结果域名
元素的图像 URL,包含指向原始资源中图像的 URL;如果原始来源不可用,则指向 DataForSEO 存储中的图像
Google Shopping 产品标识符数组,包含与该产品关联的 Google Shopping 产品 ID
元素类型 = 'chat_gpt_google_shopping_product'
事件标识符,Google 使用的内部事件标识符
产品标识符,可在 Google Shopping API 端点中用作 data_docid
产品的 Google Shopping 目录标识符,可在 Google Shopping API 端点中用作 product_id
Google 产品集群标识符,可在 Google Shopping API 端点中用作 gid
标题中主优惠的文档标识符,可在 Google Shopping API 端点中用作 data_docid
所展示产品图片的标识符
资源描述符字符串;用于在 Google 的 Shopping 索引中标识产品的 Google 内部资源描述符字符串
搜索查询;ChatGPT 用于从 Google Shopping 检索产品的搜索查询
商家标识符 Google Shopping 中卖家或商家账户的标识符
商品视图类型:Google 内部参数,用于指定渲染商品项时使用的商品视图类型
编码后的位置参数,用于指定搜索位置
国家/地区代码,指示显示哪个位置的搜索结果
主机语言代码,表示搜索结果的显示语言