TikTok Shop API
TikTok Shop 搜索 API
按关键词在 15 个国家搜索 TikTok Shop 商品:每个商品的价格、销量、评分和卖家信息,统一在一个标准化响应中返回。
POST/v1/run/tiktok_shop.search
可用率
100.00%
30d · 15,904 次调用
请求数
15,904
30d · 按周,近 12 周
响应时间
3.0s
中位数 · 30d
服务商网络
按流量排序的服务商
试一试
发出你的第一个请求
requireFieldsarray可选;省略时路由不变,由最便宜的数据源处理。列出本次请求必须能返回的输出字段,例如 `currency`,请求就只会由能返回全部这些字段的数据源处理。未列出的字段,只要处理请求的数据源有,仍会照常返回。这可能提高你的价格:最便宜的数据源无法返回某个列出的字段时,会改由更贵的数据源处理,并按它的价格报价和扣费。如果某个商品确实没有某个列出的字段,该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回,请求会作为无效输入被拒绝,不扣费。
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
"data": {
"items": [
{
"currency": "USD",
"discountPct": 12500,
"image": "https://example.com/image.jpg",
"originalPrice": 19.99,
"price": 19.99,
"productId": "a1b2c3d4",
"rating": 4.6,
"reviewCount": 12500,
"sellerId": "a1b2c3d4",
"shopName": "Example title",
"soldCount": 12500,
"title": "Example title",
"url": "https://example.com/page"
}
]
},
"found": true,
"reason": "not_found"
}响应类型定义
interface TiktokShopSearchResponse {
data: {
items: {
currency?: string;
discountPct?: number;
image?: string;
originalPrice?: number;
price?: number;
productId: string;
rating?: number;
reviewCount?: number;
sellerId?: string;
shopName?: string;
soldCount?: number;
title: string;
url?: string;
}[];
} | null;
found: boolean;
reason?: "not_found";
}完整的参数与响应参考:这个接口的每个字段、类型和示例。
参考
请求、响应与价格
最近验证于 2026-09-29 · 可用率和延迟按 30d 统计POST /v1/run/tiktok_shop.search
curl -X POST https://api.getanyapi.com/v1/run/tiktok_shop.search \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"limit":3,"query":"phone case"}'| 字段 | 类型 | 示例值 |
|---|---|---|
| 请求体 | ||
| query | string | "phone case"TikTok Shop 商品的搜索关键词(例如 wireless earbuds)。 |
| country | enum | 要搜索的 TikTok Shop 市场的国家代码(例如 US)。 |
| limit | integer | 3最多返回的商品数量,仅在 US 搜索中生效,上限 30。其他国家或更大的值会返回 TikTok Shop 针对该查询给出的全部商品,通常约 30 个,偶尔超过 50 个。两种情况下每次调用价格相同。 |
| requireFields | array | 可选;省略时路由不变,由最便宜的数据源处理。列出本次请求必须能返回的输出字段,例如 `currency`,请求就只会由能返回全部这些字段的数据源处理。未列出的字段,只要处理请求的数据源有,仍会照常返回。这可能提高你的价格:最便宜的数据源无法返回某个列出的字段时,会改由更贵的数据源处理,并按它的价格报价和扣费。如果某个商品确实没有某个列出的字段,该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回,请求会作为无效输入被拒绝,不扣费。 |
| 响应 | ||
| data | object | |
| data.items | object[] | 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. |
| data.items[].currency可设为必填 | string | ISO currency name, e.g. USD. |
| data.items[].discountPct | number | Discount off the original price as a percentage, e.g. 10 for 10% off. Omitted when the product is not discounted. |
| data.items[].image | string | Product image URL. |
| data.items[].originalPrice | number | Pre-discount list price. Omitted when the product is not on sale. |
| data.items[].price | number | Current sale price. |
| data.items[].productId | string | TikTok Shop product id. Populated whenever the provider has data for the entity. |
| data.items[].rating | number | Average review score. Omitted when the product has no rating yet. |
| data.items[].reviewCount可设为必填 | integer | Number of reviews. Omitted when the lane that served this request does not report it. |
| data.items[].sellerId | string | TikTok Shop seller id, for joining to the seller's other products. |
| data.items[].shopName | string | Seller shop name. |
| data.items[].soldCount | integer | Units sold. |
| data.items[].title | string | Product title. Populated whenever the provider has data for the entity. |
| data.items[].url | string | Canonical product detail page URL. Populated whenever the provider has data for the entity. |
| found | boolean | |
| 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. |
| 价格 | ||
| 每次请求价格 | USD | US$0.00095 |
| 价格(/千次请求) | USD | US$0.95 |
常见问题
关于 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 调用中有 100.0% 成功,响应时间中位数为 3.0 秒,共测量 15,904 次调用。
费用:每千次请求 US$0.95 起,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。
按关键词在 15 个国家搜索 TikTok Shop 商品:每个商品的价格、销量、评分和卖家信息,统一在一个标准化响应中返回。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。
过去 30 天,通过 AnyAPI 发起的 TikTok Shop 搜索 API 调用中有 100.0% 成功,响应时间中位数为 3.0 秒,共测量 15,904 次调用。这些是 AnyAPI 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。