2026-09-17

本次更新主要覆盖 AI 平台枚举、监测计划管理、竞品分析、口碑数据、对话原始明细、账户余额与媒体发稿能力。整体以向后兼容为主，旧客户端无需立即改造，但建议新接入统一使用新的平台枚举和新增字段。

#1. AI 平台枚举更新

OpenAPI 现支持更明确的 Web / App 平台枚举：

平台值	含义
deepseek-web	DeepSeek 网页
doubao-app	豆包 APP
wenxin-web	文心网页
kimi-app	Kimi APP
qianwen-web	千问网页
qianwen-app	千问 APP
yuanbao-app	元宝 APP

兼容旧调用方：裸平台值仍可继续传入，并按以下规则处理：

旧值	兼容处理
deepseek	deepseek-web
doubao	doubao-app
wenxin	wenxin-web
kimi	kimi-app
qianwen	qianwen-web
yuanbao	yuanbao-app

涉及字段：

字段	类型	必填	说明
topics[].monitoring_platforms	string[]	否	初始监测平台范围，至少 1 个；不传时默认裸值对应的 6 个平台，兼容旧客户端；其中 qianwen 表示千问网页，qianwen-app 表示千问 APP

建议新客户端在新增或编辑监测计划时显式传入 *-web / *-app 平台值。

#2. 监测计划创建限制调整

接口：

POST /brands/{brand_id}/topics
PUT /topics/{topic_id}/monitoring-plan

更新内容：

• 新建监测计划不再限制话题类型数量。
• 首次创建不再强制同时包含品牌词和行业词。
• 免费版首次创建不再限制只能创建 2 条，改为仅校验工作区监测计划总配额。
• 编辑监测计划时支持更新 topic_type、monitoring_enabled、monitoring_platforms 中任意一个或多个字段。

示例：

{
  "topics": [
    {
      "keyword": "示例品牌 怎么样",
      "topic_type": "brand",
      "monitoring_platforms": ["deepseek-web", "doubao-app", "qianwen-web"]
    },
    {
      "keyword": "AI营销工具推荐",
      "topic_type": "industry",
      "monitoring_platforms": ["kimi-app", "qianwen-app"]
    }
  ]
}

#3. 竞品分析接口增强

#3.1 发现的竞品

GET /brands/{brand_id}/competitors?days=30&topic_id=<topic_id>&include_self_brand=true

新增能力：

• 支持 topic_id，可获取单个话题维度的竞品数据。
• 支持 include_self_brand=true 或 include_self_brand=1，返回结果中会包含自有品牌。
• 自有品牌数据通过 is_our_brand: true 标识。

#3.2 竞品汇总

GET /brands/{brand_id}/competitors/summary?days=30&topic_id=<topic_id>

新增能力：

• 支持 topic_id，可获取单个话题维度的竞品汇总数据。

注意：该接口的 total_competitors 始终只统计真实竞品，不包含自有品牌。

#3.3 竞品分平台

GET /brands/{brand_id}/competitors/by-platform?days=30&topic_id=<topic_id>&include_self_brand=true

新增能力：

• 支持 topic_id，可获取单个话题维度、分平台的竞品数据。
• 支持 include_self_brand=true 或 include_self_brand=1，返回自有品牌分平台表现。
• 自有品牌数据通过 is_our_brand: true 标识。

#4. 口碑数据口径调整

接口：

GET /brands/{brand_id}/sentiment-overview
GET /brands/{brand_id}/sentiment-mentions

更新内容：

• 口碑数据不再只统计 topic_type=brand 的品牌词话题。
• 所有监测话题中，只要 AI 回答实际提及自有品牌且情感分析有效，都会纳入口碑统计。
• 行业词话题中产生的自有品牌评价，也会进入口碑概览、趋势、平台分布、话题分布和评价明细。

新增响应字段：

字段	位置	说明
topic_type	by_topic[]、heatmap.topics[]、评价明细	话题类型：brand / industry
has_brand_mention	by_topic[]、heatmap.topics[]	当前查询范围内该话题是否实际提及自有品牌

未提及自有品牌的话题会保留为零数据行。

#5. 对话原始明细补充商品卡片

接口：

GET /brands/{brand_id}/crawl-replays?date=2025-12-08

更新内容：

• 每个快照除录屏、原始回复 raw_response 外，新增商品卡片字段 products。
• 商品卡片数据与工作区对话记录右侧展示同源。

products[] 字段：

字段	说明
product_id	上游商品 ID，可能为空；不是独角兽GEO内部 ID
name	商品名称
brand	商品品牌
url	商品链接
image_url	商品图片
store	店铺名称
price_text	上游页面原始价格文案
rating	评分
review_count	评价数
description	商品描述或卖点

#6. 新增账户余额与积分接口

接口：

GET /account/balance

返回 API Key 所属账户的钱包余额与可用积分。

示例响应：

{
  "data": {
    "balance_cents": 128800,
    "balance_points": 986.75
  }
}

说明：

• balance_cents 单位为分。
• balance_points 为当前可用积分。
• 即使请求携带 X-Active-Workspace 切换工作区，资金账户仍绑定 API Key 创建者本人。

#7. 媒体发稿与短视频投稿更新

#7.1 媒体资源列表支持短视频

接口：

GET /press/media

media_type 新增：

值	说明
shortvideo	短视频账号

短视频支持平台、行业、地区、粉丝量、账号认证、价格区间等筛选。

新增或建议使用的筛选参数：

参数	说明
follower_range	短视频账号粉丝量区间
account_verification	短视频账号认证类型
price_min / price_max	价格区间，单位元
sort=price_asc	价格从低到高
sort=price_desc	价格从高到低

#7.2 新增短视频/图文投稿接口

接口：

POST /press/shortvideo/orders
Content-Type: multipart/form-data

支持视频+文案、图片+文案（图文）。

主要限制：

字段	说明
resources	仅允许 shortvideo 媒体账号，不可与网站媒体或自媒体混单
title	必填，最多 50 字
content	简介或配文，纯文本
video	最多 1 个 MP4，最大 30MB
images	最多 10 张，单张最大 10MB，支持 JPG/PNG/GIF/WebP
keywords	最多 20 个标签

网站媒体和自媒体发稿仍使用原接口：

POST /press/orders

#8. 调用方适配建议

• 新接入请统一使用 deepseek-web、doubao-app、qianwen-app 等显式平台枚举。
• 解析响应时请允许新增字段，尤其是口碑接口的 topic_type、has_brand_mention 和对话明细的 products。
• 如需按话题查看竞品，请优先使用 topic_id 参数。
• 如需把自有品牌纳入竞品对比图表，请在 5.12 和 5.14 接口传 include_self_brand=true。
• 短视频账号必须使用 /press/shortvideo/orders 下单，不能混入 /press/orders。