概览
TikTok Shop 商品详情数据把商品页面上的关键信息整理到同一份可比较的资料中,适合用来建立选品、竞品观察和商品运营的基础底表。你可以一次提交一批商品 ID 或 SPU,查看商品标题、价格、卖家、物流、SKU 和规格信息,减少逐个打开页面核对的时间。
资料还保留了商品图片、描述、销售属性、采集时间和已售数量等页面内容,方便把不同批次的商品资料放在一起比对。对于暂时没有采集到详情的商品,资料中会明确标记,避免把空白误认为商品不存在。
数据说明
每条资料代表一个 TikTok Shop 商品在采集时的公开详情快照。同一批商品按查询商品标识区分,每个任务项最多对应一条详情记录。价格、卖家、物流、SKU、销售属性和规格等复杂内容以来源的原始文本保留;部分商品属性可能没有值,资料会保留为空。已下架、无法公开访问或暂未采集到详情的商品,可能只返回无数据标记。
结果长什么样
每条资料对应一个商品及其采集时的页面信息,示例如下:
| 商品编号 | 商品标题 | 价格信息 | 卖家信息 | 已售数量 | 是否无数据 |
|---|---|---|---|---|---|
| 1732250021131883485 | VEVOR Commercial Rust-Resist Rice Cooker & Warmer | {"currency":"USD","realPrice":"157.17"} | {"location":"US"} | 34 | 否 |
资料中另有商品图片、描述、销售属性、物流信息、SKU 列表、规格列表、采集时间、SPU 编号和查询商品等信息。
应用场景
- 做竞品定价时,对比价格信息、商品标题、规格和已售数量,观察同类商品的价格与销售差异。
- 整理商品目录时,使用商品编号、SPU 编号、商品标题、销售属性和 SKU 列表建立统一的商品主数据。
- 进行店铺与履约观察时,结合卖家信息、物流信息、商品图片和采集时间,核对不同商品的供应与配送情况。
- 复盘采集质量时,使用查询商品和无数据标记识别未采集到详情的商品,并对照商品 ID 或 SPU 修正后重新查询。
适用边界
单次提交 1–200 个 TikTok Shop 商品 ID 或 SPU;每个任务项最多返回一条商品详情记录或无数据标记,覆盖接口可采集的公开商品详情。
- 适合用于
- 需要批量获取 TikTok Shop 商品标题、价格、卖家、物流和 SKU 信息时
- 需要按商品 ID 或 SPU 建立公开商品详情底表或核对采集状态时
- 不要用于
- 需要实时价格、库存或订单信息时——本应用返回商品采集时的公开详情快照
- 需要会员、订单或其他非公开店铺数据时——本应用只覆盖接口可采集的公开商品详情
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1无数据记录先核对商品 ID 或 SPU,并使用无数据标记区分未采集到详情的商品
- 2部分成功时继续使用已完成商品的结果,失败商品修正标识后重新提交
- 3鉴权失败、任务上下文不匹配或任务过期时,先检查执行环境凭证并重新提交,不要重复使用旧任务
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| product_items | 商品 ID/SPU 清单 | array<object> | 是 | — | 最多 200 项 | [{"item":"1732250021131883485"}] | 要采集 TikTok Shop 商品详情的商品 ID 或 SPU 清单,一次填写 1–200 项;每项填写一个商品标识,例如 1732250021131883485 |
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| biz_id | 业务编号 | string | 1732250021131883485 | 商品详情记录的业务编号;上游无值时为空 |
| crawl_time | 采集时间 | string | 2026-09-11T17:00:17 | 商品详情被采集的时间文本;上游无值时为空 |
| created_at | 创建时间原文 | string | 1789117214846 | 商品来源记录的创建时间原文;上游无值时为空 |
| default_sku_id | 默认 SKU 编号 | string | 1732250020632433629 | 商品默认 SKU 的编号;上游无值时为空 |
| image_url_list | 商品图片列表 | string | ["https://example.com/product-image.webp"] | 商品图片链接列表的原始 JSON 文本;上游无值时为空 |
| item_id | 商品项编号 | string | 1732250021131883485 | 结果记录对应的商品项编号;上游无值时为空 |
| price_info | 价格信息 | string | {"currency":"USD","currencySymbol":"$","discount":"36.27","originalPrice":null,"realPrice":"157.17"} | 商品价格、币种和折扣信息的原始 JSON 文本;上游无值时为空 |
| product_desc_detail | 商品描述详情 | string | [{"type":"text","text":"Durable Construction"}] | 商品详情描述段落的原始 JSON 文本;上游无值时为空 |
| product_id | 商品编号 | string | 1732250021131883485 | TikTok Shop 商品编号;上游无值时为空 |
| product_title | 商品标题 | string | VEVOR Commercial Rust-Resist Rice Cooker & Warmer | 商品页面展示的完整标题;上游无值时为空 |
| sale_props | 销售属性 | string | [{"property_name":"Specifications","property_values":[{"property_value_name":"Default"}]}] | 商品规格和销售属性的原始 JSON 文本;上游无值时为空 |
| seller_info | 卖家信息 | string | {"avatar":"https://example.com/avatar.webp","id":"7496093765791419357","link":"https://shop.tiktok.com/us/store/example/7496093765791419357","location":"US","status":null} | 卖家头像、编号、链接、地区和状态的原始 JSON 文本;上游无值时为空 |
| shipping_info | 物流信息 | string | {"pkg_of_service":{}} | 物流服务、配送时效和可达 SKU 信息的原始 JSON 文本;上游无值时为空 |
| sku_list | SKU 列表 | string | [{"sku_id":"1732250020632433629","sku_name":"Default","sku_status":1}] | 商品 SKU、库存、尺寸和销售状态的原始 JSON 文本;上游无值时为空 |
| sold_count | 已售数量 | string | 34 | 商品已售数量的原始文本;上游无值时为空 |
| specification_list | 规格列表 | string | [{"name":"Dangerous goods or hazardous materials","value":"No"}] | 商品规格名称和值的原始 JSON 文本;上游无值时为空 |
| spu_id | SPU 编号 | string | 1732250021131883485 | TikTok Shop 商品 SPU 编号;上游无值时为空 |
| updated_at | 更新时间原文 | string | 1789117217470 | 商品来源记录的更新时间原文;上游无值时为空 |
| task_item | 查询商品 | string | 1732250021131883485 | 本条结果对应的输入商品 ID 或 SPU,用于区分任务项 |
| no_data | 是否无数据 | boolean | false | 该商品是否未采集到详情数据 |
记录 Schema
输出按记录逐条返回。记录主键为 task_item,去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"biz_id": {
"type": "string",
"title": "业务编号",
"description": "商品详情记录的业务编号;上游无值时为空",
"prefill": "1732250021131883485"
},
"crawl_time": {
"type": "string",
"title": "采集时间",
"description": "商品详情被采集的时间文本;上游无值时为空",
"prefill": "2026-09-11T17:00:17"
},
"created_at": {
"type": "string",
"title": "创建时间原文",
"description": "商品来源记录的创建时间原文;上游无值时为空",
"prefill": "1789117214846"
},
"default_sku_id": {
"type": "string",
"title": "默认 SKU 编号",
"description": "商品默认 SKU 的编号;上游无值时为空",
"prefill": "1732250020632433629"
},
"image_url_list": {
"type": "string",
"title": "商品图片列表",
"description": "商品图片链接列表的原始 JSON 文本;上游无值时为空",
"prefill": "[\"https://example.com/product-image.webp\"]"
},
"item_id": {
"type": "string",
"title": "商品项编号",
"description": "结果记录对应的商品项编号;上游无值时为空",
"prefill": "1732250021131883485"
},
"price_info": {
"type": "string",
"title": "价格信息",
"description": "商品价格、币种和折扣信息的原始 JSON 文本;上游无值时为空",
"prefill": "{\"currency\":\"USD\",\"currencySymbol\":\"$\",\"discount\":\"36.27\",\"originalPrice\":null,\"realPrice\":\"157.17\"}"
},
"product_desc_detail": {
"type": "string",
"title": "商品描述详情",
"description": "商品详情描述段落的原始 JSON 文本;上游无值时为空",
"prefill": "[{\"type\":\"text\",\"text\":\"Durable Construction\"}]"
},
"product_id": {
"type": "string",
"title": "商品编号",
"description": "TikTok Shop 商品编号;上游无值时为空",
"prefill": "1732250021131883485"
},
"product_title": {
"type": "string",
"title": "商品标题",
"description": "商品页面展示的完整标题;上游无值时为空",
"prefill": "VEVOR Commercial Rust-Resist Rice Cooker & Warmer"
},
"sale_props": {
"type": "string",
"title": "销售属性",
"description": "商品规格和销售属性的原始 JSON 文本;上游无值时为空",
"prefill": "[{\"property_name\":\"Specifications\",\"property_values\":[{\"property_value_name\":\"Default\"}]}]"
},
"seller_info": {
"type": "string",
"title": "卖家信息",
"description": "卖家头像、编号、链接、地区和状态的原始 JSON 文本;上游无值时为空",
"prefill": "{\"avatar\":\"https://example.com/avatar.webp\",\"id\":\"7496093765791419357\",\"link\":\"https://shop.tiktok.com/us/store/example/7496093765791419357\",\"location\":\"US\",\"status\":null}"
},
"shipping_info": {
"type": "string",
"title": "物流信息",
"description": "物流服务、配送时效和可达 SKU 信息的原始 JSON 文本;上游无值时为空",
"prefill": "{\"pkg_of_service\":{}}"
},
"sku_list": {
"type": "string",
"title": "SKU 列表",
"description": "商品 SKU、库存、尺寸和销售状态的原始 JSON 文本;上游无值时为空",
"prefill": "[{\"sku_id\":\"1732250020632433629\",\"sku_name\":\"Default\",\"sku_status\":1}]"
},
"sold_count": {
"type": "string",
"title": "已售数量",
"description": "商品已售数量的原始文本;上游无值时为空",
"prefill": "34"
},
"specification_list": {
"type": "string",
"title": "规格列表",
"description": "商品规格名称和值的原始 JSON 文本;上游无值时为空",
"prefill": "[{\"name\":\"Dangerous goods or hazardous materials\",\"value\":\"No\"}]"
},
"spu_id": {
"type": "string",
"title": "SPU 编号",
"description": "TikTok Shop 商品 SPU 编号;上游无值时为空",
"prefill": "1732250021131883485"
},
"updated_at": {
"type": "string",
"title": "更新时间原文",
"description": "商品来源记录的更新时间原文;上游无值时为空",
"prefill": "1789117217470"
},
"task_item": {
"type": "string",
"title": "查询商品",
"description": "本条结果对应的输入商品 ID 或 SPU,用于区分任务项",
"prefill": "1732250021131883485"
},
"no_data": {
"type": "boolean",
"title": "是否无数据",
"description": "该商品是否未采集到详情数据",
"prefill": false
}
},
"required": [],
"additionalProperties": false
}调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"mona_kk__tiktok-shop-detail": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=mona_kk/tiktok-shop-detail",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。