Skip to Content
OpenAPI 接入

Open API 接入列表

接入

  1. 申请密钥（需联系 @berenzhang(张家齐)）
  2. HTTP Header 信息携带：X-API-KEY（密钥）

Header 举例：

X-API-KEY: xxxxxxx
  1. TeamID、BrandID 的来源： TeamId 和 BrandID 的来源 可直接从页面上 URL 栏该部分获取。

团队、品牌与竞品管理

获取团队下的所有品牌

  • 请求方法：POST
  • 请求路径：/geo/query/brand

请求参数：

入参类型含义是否必填
team_idstring团队ID是

响应参数：

返回值类型含义
idstring品牌ID
brand_namestring品牌名称

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "id": "brand_test_001",
      "brand_name": "测试品牌A"
    }
  ]
}

新建品牌

  • 请求方法：POST
  • 请求路径：/geo/brand/create

请求参数：

入参类型含义是否必填
brandstring品牌名称是
aliasstring品牌别名否
team_idstring团队ID是
websitestring品牌官网否
descriptionstring品牌描述否
icon_mime_typestring品牌 logo 的 MIME 类型；支持 image/jpeg、image/jpg、image/png、image/gif、image/webp、image/svg+xml否
icon_datastring品牌 logo 内容，二进制字节流；最大 2MB否
notestring品牌备注否

响应参数：

返回值类型含义
idstring新建的品牌ID

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": "brand_test_001"
  }
}

新建品牌（可同时初始化品牌基础信息、竞品、用户提问）

  • 请求方法：POST
  • 请求路径：/geo/brand/bundle/create

说明：

  • 当传入 team_id 时，表示在已有团队下新建品牌。
  • 当未传 team_id 且传入 team 时，表示先创建团队，再在该团队下创建品牌。
  • user_prompts 为品牌初始化时要创建的用户提问列表。

请求参数：

入参类型含义是否必填
team_idstring团队ID；已有团队下创建品牌时传入否
teamobject团队信息；未传 team_id 时需传入否
team.namestring团队名称条件必填
team.descriptionstring团队描述否
team.icon_mime_typestring团队 logo 的 MIME 类型；支持 image/jpeg、image/jpg、image/png、image/gif、image/webp、image/svg+xml否
team.icon_datastring团队 logo 内容，二进制字节流；最大 2MB否
brandobject品牌信息是
brand.brand_namestring品牌名称是
brand.aliasstring品牌别名否
brand.websitestring品牌官网否
brand.descriptionstring品牌描述否
brand.notestring品牌备注否
brand.icon_mime_typestring品牌 logo 的 MIME 类型；支持 image/jpeg、image/jpg、image/png、image/gif、image/webp、image/svg+xml否
brand.icon_datastring品牌 logo 内容，二进制字节流；最大 2MB否
user_promptsobject 数组初始化创建的用户提问列表是
user_prompts.questionstring用户提问内容是
competitorsobject 数组竞品列表否
competitors.namestring竞品名称否
competitors.aliasstring竞品别名否
competitors.descriptionstring竞品描述否
competitors.websitestring竞品官网否

响应参数：

返回值类型含义
brandobject新建后的品牌信息
brand.idstring品牌ID
brand.brand_namestring品牌名称
brand.aliasstring品牌别名
brand.websitestring品牌官网
brand.descriptionstring品牌描述
brand.notestring品牌备注
promptsobject 数组初始化创建的用户提问列表
prompts.prompt_idstring用户提问ID
prompts.questionstring用户提问内容
competitorsobject 数组新建后的竞品列表
competitors.competitor_idstring竞品ID
competitors.namestring竞品名称
competitors.aliasstring竞品别名
competitors.descriptionstring竞品描述
competitors.websitestring竞品官网
teamobject团队信息
team.team_idstring团队ID
team.namestring团队名称
team.descriptionstring团队描述

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {
    "brand": {
      "id": "brand_test_001",
      "brand_name": "测试品牌A",
      "alias": "品牌A",
      "website": "https://brand-a.example.com",
      "description": "这是一个用于接口演示的测试品牌",
      "note": "测试备注"
    },
    "prompts": [
      {
        "prompt_id": "prompt_test_001",
        "question": "测试品牌A适合哪些业务场景？"
      }
    ],
    "competitors": [
      {
        "competitor_id": "competitor_test_001",
        "name": "测试竞品A",
        "alias": "竞品A",
        "description": "这是一个用于接口演示的测试竞品",
        "website": "https://competitor-a.example.com"
      }
    ],
    "team": {
      "team_id": "team_test_001",
      "name": "测试团队A",
      "description": "用于接口演示的测试团队"
    }
  }
}

编辑品牌基础信息

  • 请求方法：POST
  • 请求路径：/geo/brand/update

说明：该接口按完整对象更新，除 id 外，业务上建议其余字段也一并传入；未传字段在当前实现下可能被清空或覆盖。

请求参数：

入参类型含义是否必填
idstring品牌ID是
brand_namestring品牌名称是
brand_aliasstring品牌别名是
websitestring品牌官网是
descriptionstring品牌描述是
notestring品牌备注是
website_auto_tracebool是否自动追踪官网内容：true-开启，false-关闭是

响应参数：

接口调用成功时，返回空对象。

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {}
}
  • 请求方法：POST
  • 请求路径：/geo/brand/update/icon

请求参数：

入参类型含义是否必填
brand_idstring品牌ID是
mime_typestring图片 MIME 类型；支持 image/jpeg、image/jpg、image/png、image/gif、image/webp、image/svg+xml是
datastring图片内容，二进制字节流；最大 2MB是

响应参数：

返回值类型含义
icon_urlstring更新后的品牌 logo 地址

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {
    "icon_url": "https://static.example.com/brand/logo-test.png"
  }
}

获取竞品列表

  • 请求方法：POST
  • 请求路径：/geo/competitor/get

请求参数：

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

响应参数：

返回值类型含义
competitor_idstring竞品ID
competitor_namestring竞品名称
competitor_aliasstring竞品别名

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "competitor_id": "competitor_test_001",
      "competitor_name": "测试竞品A",
      "competitor_alias": "竞品A"
    }
  ]
}

新建竞品

  • 请求方法：POST
  • 请求路径：/geo/competitor/create

请求参数：

入参类型含义是否必填
brand_idstring品牌ID是
competitor_namestring竞品名称是
competitor_aliasstring竞品别名否

响应参数：

返回值类型含义
idstring新建的竞品ID

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": "competitor_test_001"
  }
}

编辑竞品

  • 请求方法：POST
  • 请求路径：/geo/competitor/update

说明：该接口按完整对象更新，业务上建议更新时将可编辑字段全部传入；未传字段在当前实现下可能被清空或覆盖。

请求参数：

入参类型含义是否必填
brand_idstring品牌ID是
competitor_idstring竞品ID是
competitor_namestring竞品名称是
competitor_aliasstring竞品别名是

响应参数：

接口调用成功时，返回空对象。

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {}
}

删除竞品

  • 请求方法：POST
  • 请求路径：/geo/competitor/delete

请求参数：

入参类型含义是否必填
brand_idstring品牌ID是
competitor_idstring竞品ID是

响应参数：

接口调用成功时，返回空对象。

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {}
}

文章管理

获取团队下的所有标签

  • 请求方法：POST
  • 请求路径：/geo/article/tag/get

请求参数：

入参类型含义是否必填
team_idstring团队ID是
tag_typeint标签类型：1-用户标签，2-系统标签否

响应参数：

返回值类型含义
tag_idstring标签ID
team_idstring团队ID
namestring标签名称
notestring标签备注
tag_typeint标签类型：1-用户标签，2-系统标签
statusint标签状态：1-启用，2-禁用
created_bystring创建人
article_countint标签关联的文章数
created_timeint64创建时间

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "tag_id": "tag_test_001",
      "team_id": "team_test_001",
      "name": "测试标签A",
      "note": "测试标签备注",
      "tag_type": 1,
      "status": 1,
      "created_by": "test_user",
      "article_count": 10,
      "created_time": "1735689600000"
    }
  ]
}

新建文章并加入追踪

  • 请求方法：POST
  • 请求路径：/geo/article/trace/save

请求参数：

入参类型含义是否必填
brand_idstring品牌ID是
titlestring文章标题是
urlsstring 数组文章的各个发布链接是
tag_idsstring 数组文章需要关联的标签ID否
languagestring文章语言，使用 BCP 47 语言码；默认 zh-CN。支持：zh-CN、zh-SG、zh-TW、zh-HK、zh-MO、en-US、en-GB、ja-JP、ko-KR、fr-FR、de-DE、es-ES、pt-BR、pt-PT、it-IT、th-TH、vi-VN、id-ID、ar-SA、ru-RU、ms-MY否

返回参数：

返回值类型含义
article_idstring文章ID

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": "article_test_001"
}

获取文章列表

  • 请求方法：POST
  • 请求路径：/geo/article/query

说明：

  • 该接口用于获取品牌下的文章列表，并返回文章维度的汇总引用数据。
  • 如果只需要导出文章维度的引用总数、引用趋势、已发布平台等信息，该接口可以直接满足。
  • 如果需要按 AI 平台拆分的引用明细，需要先通过该接口获取 article_id，再调用「获取文章追踪详情」。

请求参数：

入参类型含义是否必填
brand_idstring品牌ID是
limitint每次返回数量；不传默认 20否
scroll_idstring游标；翻页时传上一次响应中的 scroll_id否
start_timeint64引用统计开始时间，毫秒时间戳否
end_timeint64引用统计结束时间，毫秒时间戳否
titlestring文章标题关键字否
statusint 数组文章状态列表否
sourceint 数组文章来源列表否
template_typeint 数组文章模板类型列表否
tag_idsstring 数组标签ID列表否
ref_order_typeint引用数排序：1-升序，2-降序否
languagestring 数组文章语言列表，使用 BCP 47 语言码否
has_videobool是否筛选已生成视频的文章否
has_video_generatingbool是否筛选视频生成中的文章否

响应参数：

返回值类型含义
listobject 数组文章列表
list.idstring文章ID
list.brand_idstring品牌ID
list.titlestring文章标题
list.statusint文章状态
list.sourceint文章来源
list.template_typeint文章模板类型
list.ref_countint当前筛选时间范围内的文章引用总数
list.fluctuationfloat引用数变化值
list.ref_trendsobject 数组文章引用趋势
list.ref_trends.datestring日期，格式：YYYY-MM-DD
list.ref_trends.countint当日引用数
list.published_platformsobject 数组文章已发布平台
list.published_platforms.platformstring发布平台标识
list.published_platforms.display_namestring发布平台展示名
list.published_platforms.icon_urlstring发布平台图标
list.published_platforms.publish_urlstring发布链接
scroll_idstring下一页游标；为空表示没有更多数据
totalint匹配文章总数
total_linksint匹配文章的发布链接总数

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {
    "list": [
      {
        "id": "article_test_001",
        "brand_id": "brand_test_001",
        "title": "测试文章A",
        "status": 1,
        "source": 1,
        "template_type": 1,
        "ref_count": 12,
        "fluctuation": 3,
        "ref_trends": [
          {
            "date": "2026-01-15",
            "count": 4
          }
        ],
        "published_platforms": [
          {
            "platform": "wechat",
            "display_name": "微信公众号",
            "icon_url": "https://static.example.com/platform/wechat.png",
            "publish_url": "https://example.com/article/a"
          }
        ]
      }
    ],
    "scroll_id": "12:article_test_001",
    "total": 1,
    "total_links": 1
  }
}

获取文章追踪详情

  • 请求方法：POST
  • 请求路径：/geo/article/trace/detail

说明：

  • 该接口用于获取单篇追踪文章的引用详情，包含按 AI 平台拆分的引用次数和趋势。

请求参数：

入参类型含义是否必填
article_idstring文章ID是
begin_datestring开始日期，格式：YYYY-MM-DD；不传则按系统默认统计范围否
end_datestring结束日期，格式：YYYY-MM-DD；传入时需与 begin_date 同时传入否

响应参数：

返回值类型含义
trace_infoobject 数组文章追踪记录列表；一篇文章可对应多个发布链接
trace_info.trace_idstring追踪记录ID
trace_info.article_idstring文章ID
trace_info.urlstring追踪链接
trace_info.platformstring发布平台
trace_info.iconstring发布平台图标
trace_info.titlestring文章标题
trace_info.can_editbool当前追踪链接是否允许编辑
trace_info.statsobject当前追踪链接的引用统计
statsobject文章整体引用统计
stats.ref_countobject按 AI 平台统计的引用次数，key 为平台标识，value 为引用次数
stats.total_countint引用总数
stats.ref_count_increaseint引用增长数
stats.ref_trendsobject 数组按 AI 平台拆分的引用趋势
stats.ref_trends.platformstringAI 平台标识
stats.ref_trends.ref_trendsobject 数组该平台下的每日引用趋势
stats.ref_trends.ref_trends.datestring日期，格式：YYYY-MM-DD
stats.ref_trends.ref_trends.ref_countint当日引用数
stats.ref_trends.ref_trends.promptsobject 数组产生引用的用户提问列表
stats.ref_trends.ref_trends.prompts.prompt_idstring用户提问ID
stats.ref_trends.ref_trends.prompts.prompt_contentstring用户提问内容
stats.ref_trends.ref_trends.prompts.title_namestring用户提问分类名称
stats.ref_trends.ref_trends.prompts.ref_countint该用户提问产生的引用数

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {
    "trace_info": [
      {
        "trace_id": "trace_test_001",
        "article_id": "article_test_001",
        "url": "https://example.com/article/a",
        "platform": "wechat",
        "icon": "https://static.example.com/platform/wechat.png",
        "title": "测试文章A",
        "can_edit": false,
        "stats": {
          "ref_count": {
            "deepseek": 4,
            "yuanbao": 2
          },
          "total_count": 6
        }
      }
    ],
    "stats": {
      "ref_count": {
        "deepseek": 8,
        "yuanbao": 4
      },
      "total_count": 12,
      "ref_count_increase": 3,
      "ref_trends": [
        {
          "platform": "deepseek",
          "ref_trends": [
            {
              "date": "2026-01-15",
              "ref_count": 4,
              "prompts": [
                {
                  "prompt_id": "prompt_test_001",
                  "prompt_content": "测试品牌A适合哪些业务场景？",
                  "title_name": "测试分类A",
                  "ref_count": 2
                }
              ]
            }
          ]
        }
      ]
    }
  }
}

用户提问与分类管理

新建用户提问

  • 请求方法：POST
  • 请求路径：/geo/prompt/create

请求参数：

入参类型含义是否必填
brand_idstring品牌ID是
title_idstring用户提问分类ID是
query_strstring用户提问内容是
recommend_idstring关联推荐记录ID否

响应参数：

返回值类型含义
idstring新建的 query ID

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": "prompt_test_001"
  }
}

更新用户提问

  • 请求方法：POST
  • 请求路径：/geo/prompt/update

说明：该接口为局部更新（patch）语义。id、brand_id 必传；query_str 与 status 按传入内容更新，未传则不更新。注意：query_str 不能更新为空字符串，status=0 不表示更新。

请求参数：

入参类型含义是否必填
idstringquery ID是
brand_idstring品牌ID是
query_strstring用户提问内容；传入时更新否
statusint用户提问状态；传入时更新，支持：1-启用，2-禁用。0 不表示有效状态，仅表示不更新否

响应参数：

接口调用成功时，返回空对象。

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {}
}

批量新建用户提问

  • 请求方法：POST
  • 请求路径：/geo/prompt/create/batch

请求参数：

入参类型含义是否必填
brand_idstring品牌ID是
title_idstring用户提问分类ID是
promptsstring 数组用户提问内容列表是
recommend_idsstring 数组关联推荐记录ID列表，与 prompts 一一对应；无关联时可填 -1否

响应参数：

返回值类型含义
prompt_idsstring 数组新建的用户提问ID 列表

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {
    "prompt_ids": [
      "prompt_test_001",
      "prompt_test_002"
    ]
  }
}

获取品牌下的用户提问列表（分组）

  • 请求方法：POST
  • 请求路径：/geo/prompt/get/group

说明：

  • 该接口用于获取品牌下的用户提问列表，按用户提问分类分组。
  • 不传 begin_date 和 end_date 时，默认查询最近 7 天；只传其中一个会返回参数错误。

请求参数：

入参类型含义是否必填
brand_idstring品牌ID是
group_typeint分组类型：1-按用户提问分类是
begin_datestring开始日期，格式：YYYY-MM-DD否
end_datestring结束日期，格式：YYYY-MM-DD否
pageint页码否
page_sizeint每页数量否
title_idsstring 数组用户提问分类ID列表否
tag_idsstring 数组标签ID列表否
query_strstring用户提问关键字否

响应参数：

返回值类型含义
titlesobject 数组按分类分组的结果
titles.title_idstring分类ID
titles.title_namestring分类名称
titles.title_descstring分类描述
titles.prompt_countint分类下的用户提问数量
titles.exposurefloat曝光率
titles.fluctuationfloat曝光率变化值
titles.avg_rankfloat平均排名
titles.daily_avg_scoreobject 数组每日平均分
titles.promptsobject 数组分类下的用户提问列表
prompts.idstring用户提问ID
prompts.query_strstring用户提问内容
prompts.statusint用户提问状态：1-启用，2-禁用
prompts.exposurefloat曝光率
prompts.avg_rankfloat平均排名
prompts.daily_avg_scoreobject 数组每日平均分
prompts.title_idstring分类ID
prompts.title_namestring分类名称
prompts.creator_namestring创建人名称
prompts.created_timeint64创建时间
prompts.fluctuationfloat曝光率变化值
prompts.trace_article_cntint关联追踪文章数量
prompts.tagsobject 数组用户提问关联标签
totalint分组总数
total_promptsint用户提问总数

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {
    "titles": [
      {
        "title_id": "title_test_001",
        "title_name": "测试分类A",
        "title_desc": "用于演示的用户提问分类",
        "prompt_count": 1,
        "exposure": 0.8,
        "fluctuation": 0.1,
        "avg_rank": 2.5,
        "daily_avg_score": [
          {
            "date": "2026-01-15",
            "score": 86
          }
        ],
        "prompts": [
          {
            "id": "prompt_test_001",
            "query_str": "测试品牌A适合哪些业务场景？",
            "status": 1,
            "exposure": 0.8,
            "avg_rank": 2.5,
            "title_id": "title_test_001",
            "title_name": "测试分类A",
            "creator_name": "test_user",
            "created_time": "1735689600000",
            "trace_article_cnt": 3
          }
        ]
      }
    ],
    "total": 1,
    "total_prompts": 1
  }
}

获取用户提问分类列表

  • 请求方法：POST
  • 请求路径：/geo/title/get

说明：这里的“分类”对应系统中的 title。

请求参数：

入参类型含义是否必填
brand_idstring品牌ID是
idstring分类ID否
title_namestring分类名称，支持按名称过滤否

响应参数：

返回值类型含义
idstring分类ID
brand_idstring品牌ID
title_namestring分类名称
title_descstring分类描述
countint该分类下的用户提问数量
created_timestring创建时间
updated_timestring更新时间

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "id": "title_test_001",
      "brand_id": "brand_test_001",
      "title_name": "测试分类A",
      "title_desc": "用于演示的用户提问分类",
      "count": 12,
      "created_time": "2026-01-01",
      "updated_time": "2026-01-15"
    }
  ]
}

新建用户提问 分类

  • 请求方法：POST
  • 请求路径：/geo/title/create

说明：这里的“分类”对应系统中的 title。

请求参数：

入参类型含义是否必填
brand_idstring品牌ID是
title_namestring分类名称是
title_descstring分类描述否

响应参数：

返回值类型含义
idstring新建的分类ID

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": "title_test_001"
  }
}

更新用户提问 分类

  • 请求方法：POST
  • 请求路径：/geo/title/update

说明：这里的“分类”对应系统中的 title。该接口为部分更新语义：id、brand_id、title_name 必传；title_desc 传入时才更新，未传则不更新。

请求参数：

入参类型含义是否必填
idstring分类ID是
brand_idstring品牌ID是
title_namestring分类名称是
title_descstring分类描述；传入时更新否

响应参数：

接口调用成功时，返回空对象。

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {}
}

更新用户提问 所属分类

  • 请求方法：POST
  • 请求路径：/geo/prompt/relation/update

说明：该接口不是局部更新，而是替换关联语义，用于将指定用户提问重新归类到新的分类下。

请求参数：

入参类型含义是否必填
brand_idstring品牌ID是
title_idstring目标分类ID是
prompt_idstring用户提问ID是

响应参数：

接口调用成功时，返回空对象。

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {}
}

删除用户提问

  • 请求方法：POST
  • 请求路径：/geo/prompt/delete

请求参数：

入参类型含义是否必填
idstringquery ID是
brand_idstring品牌ID是

响应参数：

接口调用成功时，返回空对象。

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {}
}

批量删除用户提问

  • 请求方法：POST
  • 请求路径：/geo/prompt/delete/batch

请求参数：

入参类型含义是否必填
prompt_idsstring 数组用户提问ID 列表是
brand_idstring品牌ID是

响应参数：

接口调用成功时，返回空对象。

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {}
}

删除用户提问分类

  • 请求方法：POST
  • 请求路径：/geo/title/delete

请求参数：

入参类型含义是否必填
idstring分类ID是

响应参数：

接口调用成功时，返回空对象。

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {}
}

大模型回答

获取大模型回答记录列表

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

请求参数：

入参类型含义是否必填
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最大分数否
urlstring引用链接URL过滤否
ref_platformstring引用来源域名过滤（兼容旧参数）否
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-大模型
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
          }
        ]
      }
    ],
    "total": 1
  }
}

获取大模型回答记录详情

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

请求参数：

入参类型含义是否必填
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-大模型

响应示例：

{
  "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的核心优势是什么？"
    ],
    "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
      }
    ]
  }
}
查看数据与优化常见问题
Answerbit Docs
Answerbit — Make every piece of information the AI's top answer

快速开始

产品文档

开始使用

© 2026 Answerbit