Skip to Content
OpenAPI 接入大模型回答

大模型回答

获取大模型回答记录列表

  • 请求方法:POST
  • 请求路径:/geo/task/get

说明:传入 include_unanalyzed=true 可包含分析中的、需要处理或暂无可用分析的回答;默认只返回已完成分析的结果。

请求参数:

入参类型含义是否必填
brand_idstring品牌ID是
begin_datestring开始日期,格式:YYYY-MM-DD是
end_datestring结束日期,格式:YYYY-MM-DD是
includeint提示词筛选方式:0-不包含,1-包含否
promptstring用户提问关键字否
title_idstring 数组提示词标题ID列表否
prompt_idsstring 数组提示词ID列表否
tag_idsstring 数组标签ID列表否
task_idsstring 数组任务ID列表否
platformsstring 数组大模型平台列表否
languagestring 数组语言列表否
mention_brandint是否提及品牌筛选:-1-全部,0-未提及,1-提及否
min_scoreint最小分数否
max_scoreint最大分数否
include_unanalyzedbool是否包含尚未完成分析的回答,默认 false否
urlstring引用链接URL过滤否
ref_platformstring引用来源域名过滤(兼容旧参数)否
article_idstring文章ID过滤否
pageint页码否
page_sizeint每页数量否

响应参数:

返回值类型含义
scoresobject 数组大模型回答记录列表
scores.task_idstring任务ID
scores.query_idstring提示词ID
scores.query_strstring提示词内容
scores.platformstring大模型平台
scores.languagestring语言
scores.zonestring地区
scores.datestring任务日期
scores.exposureint是否提及品牌:0-未提及,1-提及
scores.scoreint品牌曝光度评分
scores.avg_rankint品牌排名,0 表示未提及
scores.title_idstring提示词标题ID
scores.title_namestring提示词标题名称
scores.trace_article_cntint追踪文章引用数量
scores.tagsobject 数组提示词关联标签
scores.tags.tag_idstring标签ID
scores.tags.tag_namestring标签名称
scores.tags.tag_typeint标签类型:1-用户,2-系统,3-大模型
scores.analysisobject分析状态与指标(有数据时返回)
scores.analysis.stateint0未知;1分析中;2分析完成;3需要处理;4无可用分析
scores.analysis.action_reasonintstate=3 时的原因:0未知;1积分不足
scores.analysis.metricsobject分析指标,仅 state=2 时返回
scores.analysis.metrics.exposure / score / rank / exposure_countint提及标记、分数、排名和提及次数
totalint总数

响应示例:

{ "code": 0, "msg": "success", "data": { "scores": [ { "task_id": "task_test_001", "prompt_id": "prompt_test_001", "query_str": "测试品牌A适合哪些业务场景?", "platform": "test-llm", "language": "zh", "zone": "CN", "date": "2026-01-15", "exposure": 1, "score": 86, "avg_rank": 2, "title_id": "title_test_001", "title_name": "测试分类A", "trace_article_cnt": 3, "tags": [ { "tag_id": "tag_test_001", "tag_name": "测试标签A", "tag_type": 1 } ], "analysis": { "state": 2, "action_reason": 0, "metrics": { "exposure": 1, "score": 86, "rank": 2, "exposure_count": 1 } } } ], "total": 1 } }

获取大模型回答记录详情

  • 请求方法:POST
  • 请求路径:/geo/task/detail/get

说明:analysis 对象用于表示分析状态、处理原因及可用的分析指标。

请求参数:

入参类型含义是否必填
brand_idstring品牌ID是
task_idstring任务ID是

响应参数:

返回值类型含义
querystring提示词内容
query_idstring提示词ID
scoreint品牌曝光度评分
zonestring地区
languagestring语言
exposureint是否提及品牌:0-未提及,1-提及
rankint品牌排名,0 表示未提及
exposure_cntint品牌提及次数
llm_outputstring大模型回答原文
platformstring大模型平台
datestring任务日期
linksobject 数组引用链接列表
links.indexint引用序号
links.urlstring引用链接URL
links.titlestring引用链接标题
links.sourceint引用来源类型:0-未关联追踪文章/未知,1-平台创作,2-用户创作,3-官网文章
links.article_idstring关联追踪文章ID
picstring 数组图片链接列表
fanoutobject 数组扩展信息列表
recommend_queriesstring 数组推荐提示词列表
video_cardsobject 数组视频卡片列表
video_cards.idstring视频卡片ID
video_cards.video_titlestring视频标题
video_cards.source_namestring来源名称
video_cards.video_descriptionstring视频描述
video_cards.video_linkstring视频链接
video_cards.sort_indexint排序序号
video_cards.cover_urlstring封面图链接
product_cardsobject 数组商品卡片列表
product_cards.idstring商品卡片ID
product_cards.product_namestring商品名称
product_cards.product_pricestring商品价格
product_cards.product_imagestring商品图片
product_cards.product_linkstring商品链接
product_cards.product_descriptionstring商品描述
product_cards.platformstring商品平台
product_cards.sort_indexint排序序号
title_namestring提示词标题名称
title_idstring提示词标题ID
tagsobject 数组提示词关联标签
tags.tag_idstring标签ID
tags.tag_namestring标签名称
tags.tag_typeint标签类型:1-用户,2-系统,3-大模型
analysisobject分析状态与指标(有数据时返回)
analysis.stateint0未知;1分析中;2分析完成;3需要处理;4无可用分析
analysis.action_reasonintstate=3 时的原因:0未知;1积分不足
analysis.metricsobject分析指标,仅 state=2 时返回
analysis.metrics.exposure / score / rank / exposure_countint提及标记、分数、排名和提及次数

响应示例:

{ "code": 0, "msg": "success", "data": { "prompt": "测试品牌A适合哪些业务场景?", "prompt_id": "prompt_test_001", "score": 86, "zone": "CN", "language": "zh", "exposure": 1, "rank": 2, "exposure_cnt": 1, "llm_output": "测试品牌A适用于场景一、场景二与场景三。", "platform": "test-llm", "date": "2026-01-15", "links": [ { "index": 1, "url": "https://example.com/articles/test-article-1", "title": "测试文章一", "source": 1, "article_id": "article_test_001" } ], "pic": [ "https://example.com/images/test-image-1.png" ], "fanout": [], "recommend_queries": [ "测试品牌A的核心优势是什么?" ], "analysis": { "state": 2, "action_reason": 0, "metrics": { "exposure": 1, "score": 86, "rank": 2, "exposure_count": 1 } }, "video_cards": [ { "id": "video_card_test_001", "video_title": "测试视频一", "source_name": "测试来源", "video_description": "测试视频描述", "video_link": "https://example.com/videos/test-video-1", "sort_index": 1, "cover_url": "https://example.com/images/video-cover-1.png" } ], "product_cards": [ { "id": "product_card_test_001", "product_name": "测试商品一", "product_price": "99.00", "product_image": "https://example.com/images/product-1.png", "product_link": "https://example.com/products/test-product-1", "product_description": "测试商品描述", "platform": "test-platform", "sort_index": 1 } ], "title_name": "测试分类A", "title_id": "title_test_001", "tags": [ { "tag_id": "tag_test_001", "tag_name": "测试标签A", "tag_type": 1 } ] } }

手动再次运行用户提问

  • 请求方法:POST
  • 请求路径:/geo/prompt/run

说明:run_count 表示每个提问当天额外运行的次数。共享副本提问不支持手动运行;运行结果通过获取大模型回答记录列表查询。

请求参数:

入参类型含义是否必填
brand_idstring品牌 ID是
prompt_idsstring 数组要运行的已启用提问 ID是
run_countint每个提问额外运行次数;接口接受大于 0 的整数,控制台当前选项为 1–5是

请求示例:

{ "brand_id": "1001", "prompt_ids": [ "3001" ], "run_count": 1 }

响应参数:

返回值类型含义
codeint0 表示成功
msgstring返回消息
dataobject成功时为空对象

响应示例:

{ "code": 0, "msg": "success", "data": {} }
Answerbit - AI搜索可见度追踪平台