logo

TikTok Shop 关键词搜索

输入 TikTok Shop 搜索关键词和期望商品数量，返回匹配商品及店铺信息

数据获取电商零售TikTok商品

概览

输入一个商品、品牌或品类关键词，获取 TikTok Shop 中匹配的公开商品记录，帮助选品、竞品观察和市场研究快速建立商品清单。

数据说明

每次任务搜索一个关键词，并按你设置的期望数量采集商品。结果包含商品标题、价格、品牌、店铺、销量、评价数量、排名和商品图片等信息，同时保留搜索关键词与采集时间。

结果长什么样

商品编号商品标题价格店铺名称销量搜索排名
1729435358486827693Micro Ingredients Whole Milk Powder, 4lbs, Made in USA41.54Micro Ingredients232840

应用场景

  • 通过品牌词或品类词发现 TikTok Shop 在售商品
  • 对比不同店铺的商品价格、销量和评价规模
  • 为选品、竞品跟踪和市场研究整理结构化商品底表

适用边界

每次任务支持 1 个搜索关键词，期望采集数量为 1–300 条；结果按每页 30 条、最多 10 页获取，覆盖 TikTok Shop 公开搜索商品。

  • 适合用于
  • 需要按品牌、产品或品类关键词发现 TikTok Shop 商品时
  • 需要比较商品标题、价格、店铺和销量等公开信息时
  • 不要用于
  • 需要商品详情页的完整规格或订单数据时
  • 需要即时单条查询而不是后台采集任务时

失败处理

开发者声明的失败与重试处理方式，接入时建议一并写进系统提示词。

  1. 1没有结果时，尝试缩短关键词或改用更宽泛的品类词后重新提交
  2. 2任务部分成功时保留已返回记录；失败或过期后可重新提交
  3. 3遇到限流、服务暂不可用或超时可稍后重试；鉴权失败需检查执行环境中的 API Key

输入参数

调用本 App 需要传入的参数，与 manifest.json 的 input.schema 同源。

字段名业务名称类型必填默认值枚举 / 约束示例说明
keyword搜索关键词string是——milk要在 TikTok Shop 搜索的品牌、商品或品类词，一次任务只支持一个关键词，长度为 1–512 个字符。
crawl_count期望采集数量string是——1本次任务期望采集的商品记录数，范围为 1–300 条；结果按每页 30 条获取，最多拉取 10 页。

输出数据

单条记录的字段结构，与 manifest.json 的 output.schema 同源。

字段名业务名称类型示例说明
biz_id业务标识stringmilk结果记录中的业务标识；无值时为空。
brand_name品牌名称stringMicro Ingredients商品品牌名称；无值时为空。
collect_time采集时间戳string1789121807761记录采集时间的毫秒时间戳字符串；无值时为空。
crawl_time采集时间string2026-09-11T18:16:47记录采集时间，接口未声明时区；无值时为空。
created_at创建时间戳string1789121807761商品记录创建时间的毫秒时间戳字符串；无值时为空。
image_url商品图片链接stringhttps://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/a6be9c262efc4e9e95cce5c93daa4ccf~tplv-fhlh96nyum-crop-webp:2000:2000.webp商品主图链接；无值时为空。
keyword命中关键词stringmilk本条商品记录对应的搜索关键词；无值时为空。
page_num结果页码string1商品记录所在结果页码字符串；无值时为空。
platform_code平台编码stringtiktokShop来源平台编码；无值时为空。
price商品价格string41.54商品价格的原始字符串，币种由来源平台决定；无值时为空。
product_id商品编号string1729435358486827693TikTok Shop 商品的稳定唯一标识。
product_title商品标题stringMicro Ingredients Whole Milk Powder, 4lbs, Made in USATikTok Shop 商品展示标题；无值时为空。
rank_index搜索排名integer0商品在结果中的排名索引，从 0 开始；无值时为空。
rating_count评价数量string3185商品评价数量的数字字符串；无值时为空。
sale_count销量string23284商品销量的数字字符串；无值时为空。
shop_id店铺编号string7494949083499694765TikTok Shop 店铺的唯一标识；无值时为空。
shop_name店铺名称stringMicro Ingredients商品所属店铺名称；无值时为空。
status_code商品状态码string—商品状态码原始值；无值时为空。
task_meta_item任务关键词stringmilk该条记录所属任务项的关键词。
task_meta_no_data是否无数据booleanfalse表示该任务项是否没有可用商品结果。

记录 Schema

输出按记录逐条返回。记录主键为 product_id，去重、增量、关联以它为准。

output.schema
{
  "type": "object",
  "properties": {
    "biz_id": {
      "type": "string",
      "title": "业务标识",
      "description": "结果记录中的业务标识；无值时为空。",
      "prefill": "milk"
    },
    "brand_name": {
      "type": "string",
      "title": "品牌名称",
      "description": "商品品牌名称；无值时为空。",
      "prefill": "Micro Ingredients"
    },
    "collect_time": {
      "type": "string",
      "title": "采集时间戳",
      "description": "记录采集时间的毫秒时间戳字符串；无值时为空。",
      "prefill": "1789121807761"
    },
    "crawl_time": {
      "type": "string",
      "title": "采集时间",
      "description": "记录采集时间，接口未声明时区；无值时为空。",
      "prefill": "2026-09-11T18:16:47"
    },
    "created_at": {
      "type": "string",
      "title": "创建时间戳",
      "description": "商品记录创建时间的毫秒时间戳字符串；无值时为空。",
      "prefill": "1789121807761"
    },
    "image_url": {
      "type": "string",
      "title": "商品图片链接",
      "description": "商品主图链接；无值时为空。",
      "prefill": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/a6be9c262efc4e9e95cce5c93daa4ccf~tplv-fhlh96nyum-crop-webp:2000:2000.webp"
    },
    "keyword": {
      "type": "string",
      "title": "命中关键词",
      "description": "本条商品记录对应的搜索关键词；无值时为空。",
      "prefill": "milk"
    },
    "page_num": {
      "type": "string",
      "title": "结果页码",
      "description": "商品记录所在结果页码字符串；无值时为空。",
      "prefill": "1"
    },
    "platform_code": {
      "type": "string",
      "title": "平台编码",
      "description": "来源平台编码；无值时为空。",
      "prefill": "tiktokShop"
    },
    "price": {
      "type": "string",
      "title": "商品价格",
      "description": "商品价格的原始字符串，币种由来源平台决定；无值时为空。",
      "prefill": "41.54"
    },
    "product_id": {
      "type": "string",
      "title": "商品编号",
      "description": "TikTok Shop 商品的稳定唯一标识。",
      "prefill": "1729435358486827693"
    },
    "product_title": {
      "type": "string",
      "title": "商品标题",
      "description": "TikTok Shop 商品展示标题；无值时为空。",
      "prefill": "Micro Ingredients Whole Milk Powder, 4lbs, Made in USA"
    },
    "rank_index": {
      "type": "integer",
      "title": "搜索排名",
      "description": "商品在结果中的排名索引，从 0 开始；无值时为空。",
      "prefill": 0
    },
    "rating_count": {
      "type": "string",
      "title": "评价数量",
      "description": "商品评价数量的数字字符串；无值时为空。",
      "prefill": "3185"
    },
    "sale_count": {
      "type": "string",
      "title": "销量",
      "description": "商品销量的数字字符串；无值时为空。",
      "prefill": "23284"
    },
    "shop_id": {
      "type": "string",
      "title": "店铺编号",
      "description": "TikTok Shop 店铺的唯一标识；无值时为空。",
      "prefill": "7494949083499694765"
    },
    "shop_name": {
      "type": "string",
      "title": "店铺名称",
      "description": "商品所属店铺名称；无值时为空。",
      "prefill": "Micro Ingredients"
    },
    "status_code": {
      "type": "string",
      "title": "商品状态码",
      "description": "商品状态码原始值；无值时为空。"
    },
    "task_meta_item": {
      "type": "string",
      "title": "任务关键词",
      "description": "该条记录所属任务项的关键词。",
      "prefill": "milk"
    },
    "task_meta_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 配置
{
  "mcpServers": {
    "mona_kk__tiktok-shop-keyword-list": {
      "type": "http",
      "url": "https://mcp-v2.bazhuayu.com?pin=mona_kk/tiktok-shop-keyword-list",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}
查看我的 API Keys →

让 AI 自己完成配置

不想手动改配置？复制安装提示词，粘贴到任意 AI 客户端对话框，由它按自身方式完成接入（提示词会让 AI 向你索要 API Key，避免凭证留在对话记录或共享配置里）。

如需在同一个 MCP 连接里指定多个 App，前往 MCP 连接页（已为你指定本 App）。

价格

启动一次任务

每提交一次任务计费一次，与返回条数无关。

¥0.001/ 次
返回一条记录

按实际成功返回的数据条数计费，任务失败不计费。每 30 条为一个计费单位，不足 30 条按 30 条计。

¥0.018/ 30 条

多个计费事件按各自口径独立累计，具体以每一项说明为准；任务失败不计费。

查看余额

立即体验

填写参数直接运行，结果来自真实调用。

示例
参数按 input.schema 校验后提交
登录后返回，确认参数再提交运行。
¥0.018 / 30 条