Skip to Content
OpenAPI 接入商品卡数据

商品卡数据

以下接口均使用 POST 请求，并通过 X-API-Key 鉴权。请求和响应中的 ID 使用字符串。

商品 GEO 看板

获取商品看板指标

  • 请求方法：POST
  • 请求路径：/geo/api/shop/dashboard/base

说明：begin_date 和 end_date 必须同时提供，按商品卡对应监控任务的完成日期筛选，包含开始日和结束日。看板接口不会在未传日期时默认查询最近 7 天。

请求参数：

入参类型含义是否必填
brand_idstring品牌 ID是
begin_datestring开始日期，格式：YYYY-MM-DD是
end_datestring结束日期，格式：YYYY-MM-DD是
platformsstring 数组大模型平台筛选；不传或传空数组表示不过滤否
title_idsstring 数组用户提问分类 ID 列表否
tag_idsstring 数组用户提问标签 ID 列表否
competitor_idsstring 数组竞品 ID 列表否
channelsstring 数组电商渠道列表否

请求示例：

{"brand_id":"2062493060792594432","begin_date":"2026-09-01","end_date":"2026-10-13","platforms":["yuanbao"],"title_ids":["2108503508733943808"],"tag_ids":[],"competitor_ids":["2062493061102972928"],"channels":["京东"]}

响应参数：

返回值类型含义
triggerobject商品卡触发指标
trigger.valuenumber当前触发值
trigger.fluctuationnumber触发值变化
mentionobject商品卡提及指标
mention.valuenumber当前提及值
mention.fluctuationnumber提及值变化
avg_rankobject平均排名指标
avg_rank.valuenumber当前平均排名
avg_rank.fluctuationnumber平均排名变化
count_shareobject推荐份额指标
count_share.valuenumber当前推荐份额
count_share.fluctuationnumber推荐份额变化

响应示例：

{"code":0,"msg":"success","data":{"trigger":{"value":62.5,"fluctuation":4.2},"mention":{"value":38.1,"fluctuation":-1.5},"avg_rank":{"value":2.4,"fluctuation":0.2},"count_share":{"value":27.3,"fluctuation":3.1}}}

获取提问触发趋势

  • 请求方法：POST
  • 请求路径：/geo/api/shop/dashboard/trigger/detail

说明：begin_date 和 end_date 必须同时提供，按商品卡对应监控任务的完成日期筛选，包含开始日和结束日。看板接口不会在未传日期时默认查询最近 7 天。

请求参数：

入参类型含义是否必填
brand_idstring品牌 ID是
begin_datestring开始日期，格式：YYYY-MM-DD是
end_datestring结束日期，格式：YYYY-MM-DD是
platformsstring 数组大模型平台筛选；不传或传空数组表示不过滤否
title_idsstring 数组用户提问分类 ID 列表否
tag_idsstring 数组用户提问标签 ID 列表否
competitor_idsstring 数组竞品 ID 列表否
channelsstring 数组电商渠道列表否

请求示例：

{"brand_id":"2062493060792594432","begin_date":"2026-09-01","end_date":"2026-10-13","platforms":["yuanbao"],"title_ids":["2108503508733943808"],"tag_ids":[],"competitor_ids":["2062493061102972928"],"channels":["京东"]}

响应参数：

返回值类型含义
trigger_statisticsobject 数组每日触发次数
trigger_statistics.datestring日期，格式：YYYY-MM-DD
trigger_statistics.valuenumber当日触发次数
model_seriesobject 数组按大模型平台拆分的趋势系列
model_series.idstring平台标识
model_series.namestring平台名称
model_series.statisticsobject 数组该平台每日数据点，字段为 date、value
model_rank_itemsobject 数组平台触发次数排行
model_rank_items.idstring平台标识
model_rank_items.namestring平台名称
model_rank_items.valuenumber触发次数

响应示例：

{"code":0,"msg":"success","data":{"trigger_statistics":[{"date":"2026-10-13","value":12}],"model_series":[{"id":"yuanbao","name":"元宝","statistics":[{"date":"2026-10-13","value":12}]}],"model_rank_items":[{"id":"yuanbao","name":"元宝","value":12}]}}

获取模型触发趋势

  • 请求方法：POST
  • 请求路径：/geo/api/shop/dashboard/model/trigger/detail

说明：begin_date 和 end_date 必须同时提供，按商品卡对应监控任务的完成日期筛选，包含开始日和结束日。看板接口不会在未传日期时默认查询最近 7 天。

请求参数：

入参类型含义是否必填
brand_idstring品牌 ID是
begin_datestring开始日期，格式：YYYY-MM-DD是
end_datestring结束日期，格式：YYYY-MM-DD是
platformsstring 数组大模型平台筛选；不传或传空数组表示不过滤否
title_idsstring 数组用户提问分类 ID 列表否
tag_idsstring 数组用户提问标签 ID 列表否
competitor_idsstring 数组竞品 ID 列表否
channelsstring 数组电商渠道列表否

请求示例：

{"brand_id":"2062493060792594432","begin_date":"2026-09-01","end_date":"2026-10-13","platforms":["yuanbao"],"title_ids":["2108503508733943808"],"tag_ids":[],"competitor_ids":["2062493061102972928"],"channels":["京东"]}

响应参数：

返回值类型含义
trigger_statisticsobject 数组每日触发次数
trigger_statistics.datestring日期，格式：YYYY-MM-DD
trigger_statistics.valuenumber当日触发次数
group_seriesobject 数组按推荐分组拆分的趋势系列
group_series.idstring分组 ID
group_series.namestring分组名称
group_series.statisticsobject 数组该分组每日数据点，字段为 date、value
group_rank_itemsobject 数组分组触发次数排行
group_rank_items.idstring分组 ID
group_rank_items.namestring分组名称
group_rank_items.valuenumber触发次数

响应示例：

{"code":0,"msg":"success","data":{"trigger_statistics":[{"date":"2026-10-13","value":12}],"group_series":[{"id":"group-1","name":"推荐","statistics":[{"date":"2026-10-13","value":12}]}],"group_rank_items":[{"id":"group-1","name":"推荐","value":12}]}}

获取品牌与竞品提及趋势

  • 请求方法：POST
  • 请求路径：/geo/api/shop/dashboard/mention/competitor/detail

说明：begin_date 和 end_date 必须同时提供，按商品卡对应监控任务的完成日期筛选，包含开始日和结束日。看板接口不会在未传日期时默认查询最近 7 天。

请求参数：

入参类型含义是否必填
brand_idstring品牌 ID是
begin_datestring开始日期，格式：YYYY-MM-DD是
end_datestring结束日期，格式：YYYY-MM-DD是
platformsstring 数组大模型平台筛选；不传或传空数组表示不过滤否
title_idsstring 数组用户提问分类 ID 列表否
tag_idsstring 数组用户提问标签 ID 列表否
competitor_idsstring 数组竞品 ID 列表否
channelsstring 数组电商渠道列表否

请求示例：

{"brand_id":"2062493060792594432","begin_date":"2026-09-01","end_date":"2026-10-13","platforms":["yuanbao"],"title_ids":["2108503508733943808"],"tag_ids":[],"competitor_ids":["2062493061102972928"],"channels":["京东"]}

响应参数：

返回值类型含义
mention_statisticsobject 数组每日提及次数
mention_statistics.datestring日期，格式：YYYY-MM-DD
mention_statistics.valuenumber当日提及次数
competitor_seriesobject 数组按品牌或竞品拆分的提及趋势系列
competitor_series.idstring品牌或竞品 ID
competitor_series.namestring品牌或竞品名称
competitor_series.statisticsobject 数组每日数据点，字段为 date、value
competitor_rank_itemsobject 数组品牌与竞品提及次数排行
competitor_rank_items.idstring品牌或竞品 ID
competitor_rank_items.namestring品牌或竞品名称
competitor_rank_items.valuenumber提及次数
competitor_rank_items.is_brandbool是否为当前品牌；可选
competitor_rank_items.fluctuationnumber提及次数变化；可选

响应示例：

{"code":0,"msg":"success","data":{"mention_statistics":[{"date":"2026-10-13","value":8}],"competitor_series":[{"id":"2062493061102972928","name":"竞品A","statistics":[{"date":"2026-10-13","value":8}]}],"competitor_rank_items":[{"id":"2062493061102972928","name":"竞品A","value":8,"is_brand":false,"fluctuation":1.2}]}}

获取模型提及趋势

  • 请求方法：POST
  • 请求路径：/geo/api/shop/dashboard/mention/model/detail

说明：begin_date 和 end_date 必须同时提供，按商品卡对应监控任务的完成日期筛选，包含开始日和结束日。看板接口不会在未传日期时默认查询最近 7 天。

请求参数：

入参类型含义是否必填
brand_idstring品牌 ID是
begin_datestring开始日期，格式：YYYY-MM-DD是
end_datestring结束日期，格式：YYYY-MM-DD是
platformsstring 数组大模型平台筛选；不传或传空数组表示不过滤否
title_idsstring 数组用户提问分类 ID 列表否
tag_idsstring 数组用户提问标签 ID 列表否
competitor_idsstring 数组竞品 ID 列表否
channelsstring 数组电商渠道列表否

请求示例：

{"brand_id":"2062493060792594432","begin_date":"2026-09-01","end_date":"2026-10-13","platforms":["yuanbao"],"title_ids":["2108503508733943808"],"tag_ids":[],"competitor_ids":["2062493061102972928"],"channels":["京东"]}

响应参数：

返回值类型含义
mention_statisticsobject 数组每日提及次数
mention_statistics.datestring日期，格式：YYYY-MM-DD
mention_statistics.valuenumber当日提及次数
model_seriesobject 数组按大模型平台拆分的提及趋势系列
model_series.idstring平台标识
model_series.namestring平台名称
model_series.statisticsobject 数组每日数据点，字段为 date、value
model_rank_itemsobject 数组平台提及次数排行
model_rank_items.idstring平台标识
model_rank_items.namestring平台名称
model_rank_items.valuenumber提及次数

响应示例：

{"code":0,"msg":"success","data":{"mention_statistics":[{"date":"2026-10-13","value":8}],"model_series":[{"id":"yuanbao","name":"元宝","statistics":[{"date":"2026-10-13","value":8}]}],"model_rank_items":[{"id":"yuanbao","name":"元宝","value":8}]}}

获取指定模型下的品牌与竞品提及详情

  • 请求方法：POST
  • 请求路径：/geo/api/shop/dashboard/model/mention/detail

说明：begin_date 和 end_date 必须同时提供，按商品卡对应监控任务的完成日期筛选，包含开始日和结束日。看板接口不会在未传日期时默认查询最近 7 天。

请求参数：

入参类型含义是否必填
brand_idstring品牌 ID是
begin_datestring开始日期，格式：YYYY-MM-DD是
end_datestring结束日期，格式：YYYY-MM-DD是
platformsstring 数组大模型平台筛选；不传或传空数组表示不过滤否
title_idsstring 数组用户提问分类 ID 列表否
tag_idsstring 数组用户提问标签 ID 列表否
competitor_idsstring 数组竞品 ID 列表否
channelsstring 数组电商渠道列表否

请求示例：

{"brand_id":"2062493060792594432","begin_date":"2026-09-01","end_date":"2026-10-13","platforms":["yuanbao"],"title_ids":["2108503508733943808"],"tag_ids":[],"competitor_ids":["2062493061102972928"],"channels":["京东"]}

响应参数：

返回值类型含义
mention_statisticsobject 数组指定大模型下的每日提及次数
mention_statistics.datestring日期，格式：YYYY-MM-DD
mention_statistics.valuenumber当日提及次数
competitor_seriesobject 数组按品牌或竞品拆分的提及趋势系列
competitor_series.idstring品牌或竞品 ID
competitor_series.namestring品牌或竞品名称
competitor_series.statisticsobject 数组每日数据点，字段为 date、value
group_rank_itemsobject 数组提及次数分组排行
group_rank_items.idstring分组 ID
group_rank_items.namestring分组名称
group_rank_items.valuenumber提及次数

响应示例：

{"code":0,"msg":"success","data":{"mention_statistics":[{"date":"2026-10-13","value":8}],"competitor_series":[{"id":"2062493061102972928","name":"竞品A","statistics":[{"date":"2026-10-13","value":8}]}],"group_rank_items":[{"id":"group-1","name":"推荐","value":8}]}}

获取品牌与竞品平均排名

  • 请求方法：POST
  • 请求路径：/geo/api/shop/dashboard/avg_rank/competitor/detail

说明：begin_date 和 end_date 必须同时提供，按商品卡对应监控任务的完成日期筛选，包含开始日和结束日。看板接口不会在未传日期时默认查询最近 7 天。

请求参数：

入参类型含义是否必填
brand_idstring品牌 ID是
begin_datestring开始日期，格式：YYYY-MM-DD是
end_datestring结束日期，格式：YYYY-MM-DD是
platformsstring 数组大模型平台筛选；不传或传空数组表示不过滤否
title_idsstring 数组用户提问分类 ID 列表否
tag_idsstring 数组用户提问标签 ID 列表否
competitor_idsstring 数组竞品 ID 列表否
channelsstring 数组电商渠道列表否

请求示例：

{"brand_id":"2062493060792594432","begin_date":"2026-09-01","end_date":"2026-10-13","platforms":["yuanbao"],"title_ids":["2108503508733943808"],"tag_ids":[],"competitor_ids":["2062493061102972928"],"channels":["京东"]}

响应参数：

返回值类型含义
avg_rank_statisticsobject 数组每日平均排名
avg_rank_statistics.datestring日期，格式：YYYY-MM-DD
avg_rank_statistics.valuenumber当日平均排名
competitor_seriesobject 数组按品牌或竞品拆分的平均排名趋势系列
competitor_series.idstring品牌或竞品 ID
competitor_series.namestring品牌或竞品名称
competitor_series.statisticsobject 数组每日数据点，字段为 date、value
competitor_rank_itemsobject 数组品牌与竞品平均排名排行
competitor_rank_items.idstring品牌或竞品 ID
competitor_rank_items.namestring品牌或竞品名称
competitor_rank_items.valuenumber平均排名
competitor_rank_items.is_brandbool是否为当前品牌；可选
competitor_rank_items.fluctuationnumber平均排名变化；可选

响应示例：

{"code":0,"msg":"success","data":{"avg_rank_statistics":[{"date":"2026-10-13","value":2.4}],"competitor_series":[{"id":"2062493061102972928","name":"竞品A","statistics":[{"date":"2026-10-13","value":2.4}]}],"competitor_rank_items":[{"id":"2062493061102972928","name":"竞品A","value":2.4,"is_brand":false,"fluctuation":0.2}]}}

获取模型平均排名

  • 请求方法：POST
  • 请求路径：/geo/api/shop/dashboard/avg_rank/model/detail

说明：begin_date 和 end_date 必须同时提供，按商品卡对应监控任务的完成日期筛选，包含开始日和结束日。看板接口不会在未传日期时默认查询最近 7 天。

请求参数：

入参类型含义是否必填
brand_idstring品牌 ID是
begin_datestring开始日期，格式：YYYY-MM-DD是
end_datestring结束日期，格式：YYYY-MM-DD是
platformsstring 数组大模型平台筛选；不传或传空数组表示不过滤否
title_idsstring 数组用户提问分类 ID 列表否
tag_idsstring 数组用户提问标签 ID 列表否
competitor_idsstring 数组竞品 ID 列表否
channelsstring 数组电商渠道列表否

请求示例：

{"brand_id":"2062493060792594432","begin_date":"2026-09-01","end_date":"2026-10-13","platforms":["yuanbao"],"title_ids":["2108503508733943808"],"tag_ids":[],"competitor_ids":["2062493061102972928"],"channels":["京东"]}

响应参数：

返回值类型含义
avg_rank_statisticsobject 数组每日平均排名
avg_rank_statistics.datestring日期，格式：YYYY-MM-DD
avg_rank_statistics.valuenumber当日平均排名
model_seriesobject 数组按大模型平台拆分的平均排名趋势系列
model_series.idstring平台标识
model_series.namestring平台名称
model_series.statisticsobject 数组每日数据点，字段为 date、value
model_rank_itemsobject 数组平台平均排名排行
model_rank_items.idstring平台标识
model_rank_items.namestring平台名称
model_rank_items.valuenumber平均排名

响应示例：

{"code":0,"msg":"success","data":{"avg_rank_statistics":[{"date":"2026-10-13","value":2.4}],"model_series":[{"id":"yuanbao","name":"元宝","statistics":[{"date":"2026-10-13","value":2.4}]}],"model_rank_items":[{"id":"yuanbao","name":"元宝","value":2.4}]}}

获取推荐份额分布

  • 请求方法：POST
  • 请求路径：/geo/api/shop/dashboard/count_share/detail

说明：begin_date 和 end_date 必须同时提供，按商品卡对应监控任务的完成日期筛选，包含开始日和结束日。看板接口不会在未传日期时默认查询最近 7 天。

请求参数：

入参类型含义是否必填
brand_idstring品牌 ID是
begin_datestring开始日期，格式：YYYY-MM-DD是
end_datestring结束日期，格式：YYYY-MM-DD是
platformsstring 数组大模型平台筛选；不传或传空数组表示不过滤否
title_idsstring 数组用户提问分类 ID 列表否
tag_idsstring 数组用户提问标签 ID 列表否
competitor_idsstring 数组竞品 ID 列表否
channelsstring 数组电商渠道列表否

请求示例：

{"brand_id":"2062493060792594432","begin_date":"2026-09-01","end_date":"2026-10-13","platforms":["yuanbao"],"title_ids":["2108503508733943808"],"tag_ids":[],"competitor_ids":["2062493061102972928"],"channels":["京东"]}

响应参数：

返回值类型含义
group_distributionobject 数组按电商渠道统计的推荐份额
group_distribution.namestring渠道名称
group_distribution.pctnumber份额百分比
group_distribution.countstring推荐次数
price_distributionobject 数组按价格区间统计的推荐份额
price_distribution.namestring价格区间名称
price_distribution.pctnumber该区间总份额百分比
price_distribution.countstring该区间推荐次数
price_distribution.brand_pctnumber当前品牌在该区间的份额百分比
price_distribution.brand_countstring当前品牌在该区间的推荐次数
recommendation_share_comparisonobject 数组品牌与竞品推荐份额对比
recommendation_share_comparison.idstring品牌或竞品 ID
recommendation_share_comparison.namestring品牌或竞品名称
recommendation_share_comparison.valuenumber推荐份额

响应示例：

{"code":0,"msg":"success","data":{"group_distribution":[{"name":"京东","pct":27.3,"count":"12"}],"price_distribution":[{"name":"100-500","pct":40,"count":"8","brand_pct":25,"brand_count":"2"}],"recommendation_share_comparison":[{"id":"2062493061102972928","name":"竞品A","value":18.5}]}}

获取模型推荐份额分布

  • 请求方法：POST
  • 请求路径：/geo/api/shop/dashboard/model/count_share/detail

说明：begin_date 和 end_date 必须同时提供，按商品卡对应监控任务的完成日期筛选，包含开始日和结束日。看板接口不会在未传日期时默认查询最近 7 天。

请求参数：

入参类型含义是否必填
brand_idstring品牌 ID是
begin_datestring开始日期，格式：YYYY-MM-DD是
end_datestring结束日期，格式：YYYY-MM-DD是
platformsstring 数组大模型平台筛选；不传或传空数组表示不过滤否
title_idsstring 数组用户提问分类 ID 列表否
tag_idsstring 数组用户提问标签 ID 列表否
competitor_idsstring 数组竞品 ID 列表否
channelsstring 数组电商渠道列表否

请求示例：

{"brand_id":"2062493060792594432","begin_date":"2026-09-01","end_date":"2026-10-13","platforms":["yuanbao"],"title_ids":["2108503508733943808"],"tag_ids":[],"competitor_ids":["2062493061102972928"],"channels":["京东"]}

响应参数：

返回值类型含义
group_distributionobject 数组按电商渠道统计的推荐份额
group_distribution.namestring渠道名称
group_distribution.pctnumber份额百分比
group_distribution.countstring推荐次数
price_distributionobject 数组按价格区间统计的推荐份额
price_distribution.namestring价格区间名称
price_distribution.pctnumber该区间总份额百分比
price_distribution.countstring该区间推荐次数
price_distribution.brand_pctnumber当前品牌在该区间的份额百分比
price_distribution.brand_countstring当前品牌在该区间的推荐次数
recommendation_share_comparisonobject 数组品牌与竞品推荐份额对比
recommendation_share_comparison.idstring品牌或竞品 ID
recommendation_share_comparison.namestring品牌或竞品名称
recommendation_share_comparison.valuenumber推荐份额

响应示例：

{"code":0,"msg":"success","data":{"group_distribution":[{"name":"京东","pct":27.3,"count":"12"}],"price_distribution":[{"name":"100-500","pct":40,"count":"8","brand_pct":25,"brand_count":"2"}],"recommendation_share_comparison":[{"id":"2062493061102972928","name":"竞品A","value":18.5}]}}

查询店铺列表

  • 请求路径：/geo/api/shop/list

说明：begin_date 和 end_date 分别表示店铺数据统计的开始日期和结束日期，统计范围包含这两个日期。两者都不传时默认统计最近 7 天（含今天）；只传其中一个会返回参数错误。

请求参数：

入参类型含义是否必填
brand_idstring品牌 ID是
shop_idsstring 数组店铺 ID 列表否
shop_namesstring 数组店铺名称列表否
pageint页码，从 1 开始否
page_sizeint每页数量，最大 50否
platformsstring 数组大模型平台列表否
begin_datestring开始日期，格式：YYYY-MM-DD否
end_datestring结束日期，格式：YYYY-MM-DD否
title_idsstring 数组分类 ID 列表否
tag_idsstring 数组用户提示词标签 ID 列表否
channelstring电商渠道否

请求示例：

{
  "brand_id": "2062493060792594432",
  "shop_ids": [],
  "shop_names": [],
  "page": 1,
  "page_size": 20,
  "platforms": ["yuanbao"],
  "begin_date": "2026-09-01",
  "end_date": "2026-10-13",
  "title_ids": ["2108503508733943808"],
  "tag_ids": [],
  "channel": "京东"
}

响应参数：

返回值类型含义
itemsobject 数组店铺排行列表
items.idstring店铺 ID
items.namestring店铺名称
items.rankint排名
items.rank_deltaint与上一周期相比的排名变化
items.product_countstring商品数
items.appear_countstring出现次数
items.mention_ratenumber提及率
totalstring符合条件的店铺总数
monitor_totalstring监控范围内的店铺总数

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {
    "items": [
      {"id": "2070000000000000003", "name": "品牌京东自营店", "rank": 1, "rank_delta": 0, "product_count": "18", "appear_count": "32", "mention_rate": 43.8}
    ],
    "total": "1",
    "monitor_total": "1"
  }
}

查询店铺详情

  • 请求路径：/geo/api/shop/get

请求参数：

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

请求示例：

{"brand_id": "2062493060792594432", "shop_id": "2070000000000000003"}

响应参数：

返回值类型含义
idstring店铺 ID
brand_idstring品牌 ID
ecommerce_platformstring电商平台标识
external_shop_idstring平台侧店铺 ID
shop_namestring店铺名称
shop_urlstring店铺链接

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": "2070000000000000003",
    "brand_id": "2062493060792594432",
    "ecommerce_platform": "jd",
    "external_shop_id": "jd-shop-001",
    "shop_name": "品牌京东自营店",
    "shop_url": "https://mall.example.com"
  }
}

查询商品列表

  • 请求路径：/geo/api/product/list

说明：日期用于筛选商品卡对应监控任务完成时间范围内的商品曝光数据，开始日期和结束日期均包含在范围内。两者都不传时默认查询最近 7 天（含今天）；只传其中一个会返回参数错误。

请求参数：

入参类型含义是否必填
brand_idstring品牌 ID是
product_idsstring 数组商品 ID 列表否
product_namesstring 数组商品名称列表否
shop_idstring店铺 ID否
pageint页码，从 1 开始否
page_sizeint每页数量，最大 50否
platformsstring 数组大模型平台列表否
begin_datestring开始日期，格式：YYYY-MM-DD否
end_datestring结束日期，格式：YYYY-MM-DD否
title_idsstring 数组分类 ID 列表否
tag_idsstring 数组用户提示词标签 ID 列表否
channelstring电商渠道否
ownership_filterint商品范围：0-全部，1-仅我的商品，2-我的商品和竞品否

请求示例：

{
  "brand_id": "2062493060792594432",
  "product_ids": [],
  "product_names": [],
  "page": 1,
  "page_size": 20,
  "platforms": ["yuanbao"],
  "begin_date": "2026-09-01",
  "end_date": "2026-10-13",
  "title_ids": ["2108503508733943808"],
  "tag_ids": [],
  "channel": "京东",
  "ownership_filter": 0
}

响应参数：

返回值类型含义
itemsobject 数组商品排行列表
items.idstring商品 ID
items.namestring商品名称
items.rankint排名
items.rank_deltaint与上一周期相比的排名变化
items.price_minnumber最低价格
items.price_maxnumber最高价格
items.appear_countstring出现次数
items.mention_ratenumber提及率
items.is_markedbool是否标记为本品牌商品
items.image_urlstring商品图片地址
items.shop_namestring店铺名称
items.is_favoritedbool是否已收藏
items.competitor_idstring关联竞品 ID；本品牌商品为 0
totalstring符合条件的商品总数
monitor_totalstring监控范围内的商品总数

响应示例：

{
  "code": 0,
  "msg": "success",
  "data": {
    "items": [
      {
        "id": "2070000000000000004",
        "name": "测试商品一",
        "rank": 1,
        "rank_delta": 2,
        "price_min": 99.0,
        "price_max": 129.0,
        "appear_count": "12",
        "mention_rate": 37.5,
        "is_marked": true,
        "image_url": "https://example.com/products/item-1.png",
        "shop_name": "品牌京东自营店",
        "is_favorited": false,
        "competitor_id": "0"
      }
    ],
    "total": "1",
    "monitor_total": "8"
  }
}
概览页数据常见问题
Answerbit Docs
Answerbit — Make every piece of information the AI's top answer

快速开始

产品文档

开始使用

© 2026 Answerbit
Answerbit - AI搜索可见度追踪平台