TikTok Shop 商品搜索 API 文档

按关键词搜索 TikTok Shop 商品，返回价格、累计销量、评分和卖家。

可用状态：已开放

该接口已进入 v1 网关、OpenAPI 和订阅权限目录，成功调用一次消耗 1 个计费单位。

POST /v1/tiktok/shop/products/search

下方请求和响应字段已与当前公开契约核对。

MCP 调用

项目	内容
MCP Code	`tiktok_shop_products_search`

快速调用

先创建 API 密钥，再将密钥写入服务端环境变量：

export ECOMMERCE_DATA_API_KEY="your_api_key"

curl --request POST \
  --url https://ecommercedataapi.com/v1/tiktok/shop/products/search \
  --header "Content-Type: application/json" \
  --header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
  --data '{
  "marketplace": "US",
  "keyword": "yoga pants"
}'

使用 AI CLI 接入

复制给 AI CLI

粘贴到 Codex、Claude Code、Gemini CLI 或其他编程智能体中直接完成接入。

请直接在当前代码库中接入 Ecommerce Data API 的「TikTok Shop 商品搜索」接口，不要只给示例代码。

接口文档：https://ecommercedataapi.com/zh/docs/tiktok/shop/product-search
请求接口：POST https://ecommercedataapi.com/v1/tiktok/shop/products/search
API 密钥环境变量：ECOMMERCE_DATA_API_KEY

请求示例：
{
  "marketplace": "US",
  "keyword": "yoga pants"
}

请按以下要求执行：
1. 先阅读接口文档，并检查当前项目使用的语言、框架、HTTP 客户端、目录结构和环境变量约定。
2. 优先复用项目现有的 API 客户端和错误处理方式；如果没有，再创建最小可复用的 Ecommerce Data API 客户端与该接口调用封装。
3. 从服务端环境变量 ECOMMERCE_DATA_API_KEY 读取密钥，发送 Content-Type: application/json 和 X-API-Key 请求头。绝不能把真实密钥写入源码、前端代码、日志、测试快照或 Git。
4. 如果环境变量不存在，提示我自行设置 ECOMMERCE_DATA_API_KEY；不要索取、输出或猜测真实密钥，并继续完成不依赖真实请求的代码与测试。
5. 根据接口文档实现请求与响应类型，处理非 2xx 响应、request_id、error.code、error.message 和 429 限流。
6. 添加一个符合当前项目习惯的最小调用示例或测试。如果密钥已配置且当前环境允许外部请求，再执行一次最小真实调用；否则使用 mock 或静态验证。
7. 运行相关格式化、类型检查和测试，最后汇报修改文件、调用方法、验证结果以及仍需我配置的环境变量。

还没有 API 密钥？创建 API 密钥

在 Postman 中打开当前请求

下载当前接口的预配置 Collection，再通过 Postman Import 导入。

下载当前接口配置

导入后在 Collection Variables 中填写 apiKey。创建 API 密钥

Node.js 示例

const response = await fetch(
  'https://ecommercedataapi.com/v1/tiktok/shop/products/search',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
    },
    body: JSON.stringify({
      marketplace: 'US',
      keyword: 'yoga pants',
    }),
  }
);

const result = await response.json();

if (!response.ok) {
  throw new Error(`${result.error?.code}: ${result.error?.message}`);
}

console.log(result.data);

Python 示例

import os
import requests

response = requests.post(
    "https://ecommercedataapi.com/v1/tiktok/shop/products/search",
    headers={
        "Content-Type": "application/json",
        "X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"],
    },
    json={
        "marketplace": "US",
        "keyword": "yoga pants",
    },
    timeout=30,
)

response.raise_for_status()
print(response.json()["data"])

请求参数

请求体直接发送下表字段，不要再包裹额外对象；未定义字段会被拒绝。

字段	类型	必填	说明	示例
`marketplace`	字符串	否	站点，可选 US、SG、MY。可用值(表 1.2):US、JP、UK、DE、FR、IT、ES、CA、IN、MX、BR、AU、AE	US
`keyword`	字符串	是	搜索关键词。	yoga pants
`cursor`	字符串	否	上一页响应里的 `next_cursor`，原样传入；第一页不传。	eyJvZmZzZXQiOjMwLCJwYWdlX3Rva2VuIjoiLi4uIn0

返回结构

字段	类型	说明
`request_id`	字符串	本次请求的唯一标识。
`data`	对象	接口业务数据。

下表字段位于 data 内。数组接口描述的是单个数组元素，分页接口描述的是 items[] 中的单条记录。

返回字段

字段	类型	说明	示例
`products.product_id`	字符串	商品 ID	1732307789426299610
`products.title`	字符串	商品标题	-
`products.price`	数字	主 SKU 当前售价	22.25
`products.original_price`	数字	划线原价	22.25
`products.currency`	字符串	币种	USD
`products.sold_count`	整数	商品页展示的累计销量	11725
`products.rating`	数字	平均评分，0–5	4.4
`products.review_count`	整数	评论数	744
`products.seller_id`	字符串	卖家 ID，可传给店铺商品接口	8647465511174509274
`products.shop_name`	字符串	店铺名称	Poping yoga
`products.image_url`	字符串	主图链接	-
`products.product_url`	字符串	商品页链接	-
`has_more`	布尔值	是否还有下一页	true
`next_cursor`	字符串	下一页游标，作为 `cursor` 传入；最后一页为 null	-

返回示例

{
  "request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
  "data": {
    "products": [
      {
        "product_id": "1732307789426299610",
        "title": "【Black Friday】Women's Solid-Color Yoga Pants, Comfortable Casual Activewear for Daily Wear, Exercise, Gym Workouts, and Outdoor Activities",
        "price": 22.25,
        "original_price": 22.25,
        "currency": "USD",
        "sold_count": 11725,
        "rating": 4.4,
        "review_count": 744,
        "seller_id": "8647465511174509274",
        "shop_name": "Poping yoga",
        "image_url": "https://p19-oec-general.ttcdn-us.com/tos-maliva-i-o3syd03w52-us/b50bedd5cf9c44aa994730320d391a17~tplv-fhlh96nyum-crop-webp:1350:1800.webp",
        "product_url": "https://shop.tiktok.com/us/pdp/womens-solid-color-sporty-yoga-pants-comfortable-leggings/1732307789426299610"
      },
      {
        "product_id": "1731795774080652206",
        "title": "YEOREO Women's Ease Everyday Active Leggings - High Waist, No Front Seam, Buttery Fabric, V-Back Contour, Booty Lifting, Wide Straight Leg, 29\"/31.5\"/33\"/35\" Inseam for Gym Yoga",
        "price": 32.99,
        "original_price": 32.99,
        "currency": "USD",
        "sold_count": 242102,
        "rating": 4.6,
        "review_count": 19770,
        "seller_id": "7495567402787376046",
        "shop_name": "YEOREO",
        "image_url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/18828332a34240f28849fa3173a3649f~tplv-fhlh96nyum-crop-webp:1800:1800.webp",
        "product_url": "https://shop.tiktok.com/us/pdp/womens-high-waisted-straight-leg-leggings-ultra-soft-breathable/1731795774080652206"
      }
    ],
    "has_more": true,
    "next_cursor": "eyJvZmZzZXQiOjMwLCJwYWdlX3Rva2VuIjoiLi4uIn0"
  }
}

错误响应、请求追踪和限流头说明见错误与限流。

可用状态：已开放

该接口已进入 v1 网关、OpenAPI 和订阅权限目录，成功调用一次消耗 1 个计费单位。

POST /v1/tiktok/shop/products/search

下方请求和响应字段已与当前公开契约核对。

MCP 调用

项目	内容
MCP Code	`tiktok_shop_products_search`

快速调用

先创建 API 密钥，再将密钥写入服务端环境变量：

export ECOMMERCE_DATA_API_KEY="your_api_key"

curl --request POST \
  --url https://ecommercedataapi.com/v1/tiktok/shop/products/search \
  --header "Content-Type: application/json" \
  --header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
  --data '{
  "marketplace": "US",
  "keyword": "yoga pants"
}'

使用 AI CLI 接入

复制给 AI CLI

粘贴到 Codex、Claude Code、Gemini CLI 或其他编程智能体中直接完成接入。

请直接在当前代码库中接入 Ecommerce Data API 的「TikTok Shop 商品搜索」接口，不要只给示例代码。

接口文档：https://ecommercedataapi.com/zh/docs/tiktok/shop/product-search
请求接口：POST https://ecommercedataapi.com/v1/tiktok/shop/products/search
API 密钥环境变量：ECOMMERCE_DATA_API_KEY

请求示例：
{
  "marketplace": "US",
  "keyword": "yoga pants"
}

请按以下要求执行：
1. 先阅读接口文档，并检查当前项目使用的语言、框架、HTTP 客户端、目录结构和环境变量约定。
2. 优先复用项目现有的 API 客户端和错误处理方式；如果没有，再创建最小可复用的 Ecommerce Data API 客户端与该接口调用封装。
3. 从服务端环境变量 ECOMMERCE_DATA_API_KEY 读取密钥，发送 Content-Type: application/json 和 X-API-Key 请求头。绝不能把真实密钥写入源码、前端代码、日志、测试快照或 Git。
4. 如果环境变量不存在，提示我自行设置 ECOMMERCE_DATA_API_KEY；不要索取、输出或猜测真实密钥，并继续完成不依赖真实请求的代码与测试。
5. 根据接口文档实现请求与响应类型，处理非 2xx 响应、request_id、error.code、error.message 和 429 限流。
6. 添加一个符合当前项目习惯的最小调用示例或测试。如果密钥已配置且当前环境允许外部请求，再执行一次最小真实调用；否则使用 mock 或静态验证。
7. 运行相关格式化、类型检查和测试，最后汇报修改文件、调用方法、验证结果以及仍需我配置的环境变量。

还没有 API 密钥？创建 API 密钥

在 Postman 中打开当前请求

下载当前接口的预配置 Collection，再通过 Postman Import 导入。

下载当前接口配置

导入后在 Collection Variables 中填写 apiKey。创建 API 密钥

Node.js 示例

const response = await fetch(
  'https://ecommercedataapi.com/v1/tiktok/shop/products/search',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
    },
    body: JSON.stringify({
      marketplace: 'US',
      keyword: 'yoga pants',
    }),
  }
);

const result = await response.json();

if (!response.ok) {
  throw new Error(`${result.error?.code}: ${result.error?.message}`);
}

console.log(result.data);

Python 示例

import os
import requests

response = requests.post(
    "https://ecommercedataapi.com/v1/tiktok/shop/products/search",
    headers={
        "Content-Type": "application/json",
        "X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"],
    },
    json={
        "marketplace": "US",
        "keyword": "yoga pants",
    },
    timeout=30,
)

response.raise_for_status()
print(response.json()["data"])

请求参数

请求体直接发送下表字段，不要再包裹额外对象；未定义字段会被拒绝。

字段	类型	必填	说明	示例
`marketplace`	字符串	否	站点，可选 US、SG、MY。可用值(表 1.2):US、JP、UK、DE、FR、IT、ES、CA、IN、MX、BR、AU、AE	US
`keyword`	字符串	是	搜索关键词。	yoga pants
`cursor`	字符串	否	上一页响应里的 `next_cursor`，原样传入；第一页不传。	eyJvZmZzZXQiOjMwLCJwYWdlX3Rva2VuIjoiLi4uIn0

返回结构

字段	类型	说明
`request_id`	字符串	本次请求的唯一标识。
`data`	对象	接口业务数据。

下表字段位于 data 内。数组接口描述的是单个数组元素，分页接口描述的是 items[] 中的单条记录。

返回字段

字段	类型	说明	示例
`products.product_id`	字符串	商品 ID	1732307789426299610
`products.title`	字符串	商品标题	-
`products.price`	数字	主 SKU 当前售价	22.25
`products.original_price`	数字	划线原价	22.25
`products.currency`	字符串	币种	USD
`products.sold_count`	整数	商品页展示的累计销量	11725
`products.rating`	数字	平均评分，0–5	4.4
`products.review_count`	整数	评论数	744
`products.seller_id`	字符串	卖家 ID，可传给店铺商品接口	8647465511174509274
`products.shop_name`	字符串	店铺名称	Poping yoga
`products.image_url`	字符串	主图链接	-
`products.product_url`	字符串	商品页链接	-
`has_more`	布尔值	是否还有下一页	true
`next_cursor`	字符串	下一页游标，作为 `cursor` 传入；最后一页为 null	-

返回示例

{
  "request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
  "data": {
    "products": [
      {
        "product_id": "1732307789426299610",
        "title": "【Black Friday】Women's Solid-Color Yoga Pants, Comfortable Casual Activewear for Daily Wear, Exercise, Gym Workouts, and Outdoor Activities",
        "price": 22.25,
        "original_price": 22.25,
        "currency": "USD",
        "sold_count": 11725,
        "rating": 4.4,
        "review_count": 744,
        "seller_id": "8647465511174509274",
        "shop_name": "Poping yoga",
        "image_url": "https://p19-oec-general.ttcdn-us.com/tos-maliva-i-o3syd03w52-us/b50bedd5cf9c44aa994730320d391a17~tplv-fhlh96nyum-crop-webp:1350:1800.webp",
        "product_url": "https://shop.tiktok.com/us/pdp/womens-solid-color-sporty-yoga-pants-comfortable-leggings/1732307789426299610"
      },
      {
        "product_id": "1731795774080652206",
        "title": "YEOREO Women's Ease Everyday Active Leggings - High Waist, No Front Seam, Buttery Fabric, V-Back Contour, Booty Lifting, Wide Straight Leg, 29\"/31.5\"/33\"/35\" Inseam for Gym Yoga",
        "price": 32.99,
        "original_price": 32.99,
        "currency": "USD",
        "sold_count": 242102,
        "rating": 4.6,
        "review_count": 19770,
        "seller_id": "7495567402787376046",
        "shop_name": "YEOREO",
        "image_url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/18828332a34240f28849fa3173a3649f~tplv-fhlh96nyum-crop-webp:1800:1800.webp",
        "product_url": "https://shop.tiktok.com/us/pdp/womens-high-waisted-straight-leg-leggings-ultra-soft-breathable/1731795774080652206"
      }
    ],
    "has_more": true,
    "next_cursor": "eyJvZmZzZXQiOjMwLCJwYWdlX3Rva2VuIjoiLi4uIn0"
  }
}

错误响应、请求追踪和限流头说明见错误与限流。

TikTok Shop 商品搜索

API 数据样例

MCP 调用

快速调用

使用 AI CLI 接入

复制给 AI CLI

在 Postman 中打开当前请求

Node.js 示例

Python 示例

请求参数

返回结构

返回字段

返回示例

本页内容

TikTok Shop 商品搜索

API 数据样例

MCP 调用

快速调用

使用 AI CLI 接入

复制给 AI CLI

在 Postman 中打开当前请求

Node.js 示例

Python 示例

请求参数

返回结构

返回字段

返回示例

本页内容