给 AI

商品搜索 API

2 个平台的 2 个接口返回同一种 Product（商品）对象。按关键词搜索商品。每次调用 $0.0020 到 $0.0200，按接口各自的标价；失败不收费。

在 Playground 里跑一次看怎么调登录后运行，用你自己的余额。

平台2 个平台

接口2 个接口每个平台一个

价格$0.0020 起一次。失败不收费

返回Product（商品）一页 20 到 60 条，带翻下一页的游标

各平台的商品搜索接口

每个接口一行：叫什么，一次返回多少，一次多少钱。

平台接口一页返回价格

TikTokTikTok Shop 商品搜索GET/v1/tiktok/shop/products/search60商品列表$0.0020

小红书小红书商品搜索GET/v1/xiaohongshu/shop/products/search20商品列表$0.0200

价格是现行价格。失败和结果不确定的调用不收费。看实时状态 →

Product（商品）对象

上面每个接口返回的都是这些字段，名字和类型都一样。

看这个对象的页面 →

id文本编号，可原样传给取商品详情和取商品评价的接口

url链接能直接打开的链接

title文本商品标题

description文本商品详情里的文字说明

price金额现价；有多个规格时是最低的那一档

original_price金额打折前的价格；没有折扣时为 null

currency文本价格的货币，ISO 4217 代码

images链接列表商品图片地址

rating数字买家评分，满分 5

metrics.sold整数已售件数

metrics.reviews整数评价数

shop.id文本店铺编号

shop.name文本店铺名

哪个平台有哪个字段

接口给不了的字段，每次返回都会写在 meta.unavailable 里，所以缺字段不会是意外。

平台urldescriptionratingmetrics.reviews

TikTok

小红书

同一次调用，换一个平台

同样的参数名，同样的翻页，同样的返回。变的只有路径。

cURLTypeScriptPython命令行

# TikTok
curl -G "https://api.dataxapi.com/v1/tiktok/shop/products/search" \
  --data-urlencode "query=yoga mat" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

# 小红书：只改一个词
curl -G "https://api.dataxapi.com/v1/xiaohongshu/shop/products/search" \
  --data-urlencode "query=防晒霜" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

// TikTok
import { DataXAPI } from "@dataxapi/sdk";

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.tiktok.shop.products.search({ query: "yoga mat" });
console.log(result.data.items);

// 小红书：只改一个词
const other = await dx.xiaohongshu.shop.products.search({ query: "防晒霜" });
console.log(other.data.items);

# TikTok
from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.tiktok.shop.products.search(query="yoga mat")
print(result["data"]["items"])

# 小红书：只改一个词
other = dx.xiaohongshu.shop.products.search(query="防晒霜")
print(other["data"]["items"])

# TikTok
dataxapi call tiktok.shop.products.search 'query=yoga mat'

# 小红书：只改一个词
dataxapi call xiaohongshu.shop.products.search 'query=防晒霜'

200 · application/json · 扣 $0.0020

{
  "code": "ok",
  "request_id": "56d10893-6768-479f-b127-a8e6ee077873",
  "data": {
    "items": [
      {
        "id": "1750923004242032614",
        "url": "https://shop.tiktok.com/view/product/1750923004242032614",
        "title": "Yoga mat: a beginner's guide in 8 minutes",
        "price": "18.99",
        "original_price": "19.99",
        "currency": "USD",
        "images": [
          "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068/93dde11aaaba8ca57d1f~c5_720x720.jpeg"
        ],
        "rating": 4.6,
        "metrics": { "sold": 1232 },
        "shop": { "id": "1719706733287275062", "name": "Pine & Oak Home" }
      },
      // … 另有 22 条
    ]
  },
  "page": {
    "next_cursor": null,
    "cursor_expires_at": null,
    "has_more": false,
    "returned": 23
  },
  "warnings": [],
  "meta": {
    "capability": "tiktok.shop.products.search",
    "result_status": "complete",
    "fetched_at": "2026-10-12T21:46:03.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "description": "capability",
      "metrics.reviews": "capability"
    },
    "billing": {
      "amount": "0.002",
      "currency": "USD",
      "balance_after": "9.998"
    }
  }
}