TikTok Shop 搜索 API
按关键词在 15 个国家搜索 TikTok Shop 商品:每个商品的价格、销量、评分和卖家信息,统一在一个标准化响应中返回。
US$0.95/千次请求,按请求付费,无需订阅。
Results for "phone case"
MagSafe Compatible Clear Phone Case with Card Holder, Shockproof
★ 4.6 · 84,200 sold
Silicone Phone Case with Ring Holder, Drop Protection
★ 4.4 · 31,500 sold
Leather Wallet Phone Case, Detachable Strap
★ 4.8 · 9,860 sold
{"productId": "1729511239487602341","title": "MagSafe Compatible Clear Phone Case with Card Holder, Shockproof","price": 12.99,"originalPrice": 19.99,"currency": "USD","rating": 4.6,"soldCount": 84200,"shopName": "CaseCraft Official Store",... 还有 5 个字段}
价格与服务商
TikTok Shop 搜索 API 价格:一个 API,4 个可互换的服务商
最便宜的服务商优先响应。如果它失败,下一个会在同一次调用中接手。
试一试
一个请求获取 TikTok Shop 搜索
这个示例展示了 17 个字段中的 16 个。查看全部字段
{
"found": true,
"data": {
"items": [
{
"productId": "1729511239487602341",
"title": "MagSafe Compatible Clear Phone Case with Card Holder, Shockproof",
"price": 12.99,
"originalPrice": 19.99,
"currency": "USD",
"rating": 4.6,
"soldCount": 84200,
"shopName": "CaseCraft Official Store",
"sellerId": "7398201134587690001",
"reviewCount": 6412,
"discountPct": 35,
"url": "https://www.tiktok.com/shop/pdp/magsafe-compatible-clear-phone-case-with-card-holder-shockproof/1729511239487602341",
"image": "https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/casecraft-clear-magsafe~tplv-o3syd03w52-origin-webp.image"
},
{
"productId": "1729511239487602358",
"title": "Silicone Phone Case with Ring Holder, Drop Protection",
"price": 9.49,
"originalPrice": 14.99,
"currency": "USD",
"rating": 4.4,
"soldCount": 31500,
"shopName": "GripGuard Store",
"sellerId": "7398201134587690088",
"reviewCount": 2107,
"discountPct": 37,
"url": "https://www.tiktok.com/shop/pdp/silicone-phone-case-with-ring-holder-drop-protection/1729511239487602358",
"image": "https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/gripguard-silicone-ring~tplv-o3syd03w52-origin-webp.image"
},
{
"productId": "1729511239487602372",
"title": "Leather Wallet Phone Case, Detachable Strap",
"price": 16.99,
"originalPrice": 16.99,
"currency": "USD",
"rating": 4.8,
"soldCount": 9860,
"shopName": "Wander Leather Co",
"sellerId": "7398201134587690123",
"reviewCount": 843,
"url": "https://www.tiktok.com/shop/pdp/leather-wallet-phone-case-detachable-strap/1729511239487602372",
"image": "https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/wander-leather-wallet~tplv-o3syd03w52-origin-webp.image"
}
]
}
}完整的参数与响应参考:这个接口的每个字段、类型和示例。
参考
一个请求,一种响应结构。
你发送的每个字段和收到的每个字段,都附有真实示例。
最近验证于 2026-11-14 · 可用率和延迟按 30d 统计
请求体
JSON,POST 到这个接口。
- querystring
phone case
TikTok Shop 商品的搜索关键词(例如 wireless earbuds)。
- countryenum
US
要搜索的 TikTok Shop 市场的国家代码(例如 US)。
- limitinteger
3
最多返回的商品数量,仅在 US 搜索中生效,上限 30。其他国家或更大的值会返回 TikTok Shop 针对该查询给出的全部商品,通常约 30 个,偶尔超过 50 个。两种情况下每次调用价格相同。
- requireFieldsarray
可选;省略时路由不变,由最便宜的数据源处理。列出本次请求必须能返回的输出字段,例如 `currency`,请求就只会由能返回全部这些字段的数据源处理。未列出的字段,只要处理请求的数据源有,仍会照常返回。这可能提高你的价格:最便宜的数据源无法返回某个列出的字段时,会改由更贵的数据源处理,并按它的价格报价和扣费。如果某个商品确实没有某个列出的字段,该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回,请求会作为无效输入被拒绝,不扣费。
响应
JSON,每个字段一个示例值。
Product records matching the search query: id, title, price, sales count, rating, seller, and product URL. Populated whenever the provider has data for the entity.
- currencystring可设为必填
USD
ISO currency name, e.g. USD.
- discountPctnumber
35
Discount off the original price as a percentage, e.g. 10 for 10% off. Omitted when the product is not discounted.
- imagestring
https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/casecraft-clear-magsafe~tplv-o3syd03w52-origin-webp.image
Product image URL.
- originalPricenumber
19.99
Pre-discount list price. Omitted when the product is not on sale.
- pricenumber
12.99
Current sale price.
- productIdstring
1729511239487602341
TikTok Shop product id. Populated whenever the provider has data for the entity.
- ratingnumber
4.6
Average review score. Omitted when the product has no rating yet.
- reviewCountinteger可设为必填
6412
Number of reviews. Omitted when the lane that served this request does not report it.
- sellerIdstring
7398201134587690001
TikTok Shop seller id, for joining to the seller's other products.
- shopNamestring
CaseCraft Official Store
Seller shop name.
- soldCountinteger
84200
Units sold.
- titlestring
MagSafe Compatible Clear Phone Case with Card Holder, Shockproof
Product title. Populated whenever the provider has data for the entity.
- urlstring
https://www.tiktok.com/shop/pdp/magsafe-compatible-clear-phone-case-with-card-holder-shockproof/1729511239487602341
Canonical product detail page URL. Populated whenever the provider has data for the entity.
- foundboolean
true
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
你在出售这个 API?查看你的接口必须返回的完整数据结构。
常见问题
关于 TikTok Shop 搜索 API
AnyAPI 的 TikTok Shop 搜索 API 只需一次 POST 请求 /v1/run/tiktok_shop.search,就以统一格式的 JSON 返回 TikTok Shop 数据。按关键词在 15 个国家搜索 TikTok Shop 商品:每个商品的价格、销量、评分和卖家信息,统一在一个标准化响应中返回。AnyAPI 会在 4 个数据源之间路由每个请求,某个数据源失败时自动切换。费用:每千次请求 US$0.95 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 TikTok Shop 搜索 API 调用中有 99.9% 成功,响应时间中位数为 2.6 秒,共测量 61,338 次调用。