Search TikTok Shop products by keyword
apify.tiktok-shop.search.productsScrape TikTok Shop products for a keyword across 10 storefronts (US, GB, VN, TH, PH, MY, SG, JP, MX, ID) — title, price, original_price, discount_percent, seller_name, rating, sold_count and full category_path per product
- 价格
- $0.008/result按供应商原价
- 成功率
- 85%近 30 天 · 40 次
- 延迟 p50
- 34 秒p95 80 秒
- 最后验证
- 2026年9月26日实测可用
POSThttps://toolswitch.dev/v1/tools/apify.tiktok-shop.search.products?memory=2048&timeout=90&maxItems=1&maxTotalChargeUsd=0.08预览- 可用平台额度调用
- 同步返回
- 读取公开数据
参数
the response is the dataset items array directly — no run envelope, no polling. Each row carries product_id, title, price, original_price, discount_percent, currency, seller_name, seller_id, rating, review_count, sold_count, category_path, product_url and image URLs. Cap every call with maxTotalChargeUsd, the spend limit Apify enforces; the body row limit sets how many rows run. The same actor also takes product_urls (per-product detail, billed product-detail) and category_urls (category browse); this entry is the keyword-search capability
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| 查询参数 | ||||
memory | 整数 | 可选 | MB of run memory. treg's key requires 2048, which fixes the actor-start charge; your own key may set any size | 2048 |
timeout | 整数 | 可选 | run timeout in seconds. treg's key requires 90 so the run and its rows arrive before any wait gives up; a larger pull should use your own key and the async web.scrape.job.* pair above | 90 |
maxItems | 整数 | 可选 | optional row cap; pay-per-event actors that take the row count from their own input ignore it, so maxTotalChargeUsd is the spend limit | 100 |
maxTotalChargeUsd | 数字 | 可选 | the spend cap Apify enforces on every event this run bills, in dollars. treg's key requires it, above 0 and at most 1, and holds it for the call | 0.5 |
- 查询参数
memory整数可选MB of run memory. treg's key requires 2048, which fixes the actor-start charge; your own key may set any size
示例：
2048timeout整数可选run timeout in seconds. treg's key requires 90 so the run and its rows arrive before any wait gives up; a larger pull should use your own key and the async web.scrape.job.* pair above
示例：
90maxItems整数可选optional row cap; pay-per-event actors that take the row count from their own input ignore it, so maxTotalChargeUsd is the spend limit
示例：
100maxTotalChargeUsd数字可选the spend cap Apify enforces on every event this run bills, in dollars. treg's key requires it, above 0 and at most 1, and holds it for the call
示例：
0.5
代码示例
将 $TOOLSWITCH_KEY 替换为你在控制台创建的密钥。
curl -X POST 'https://toolswitch.dev/v1/tools/apify.tiktok-shop.search.products?memory=2048&timeout=90&maxItems=1&maxTotalChargeUsd=0.08' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY" \
-H "Content-Type: application/json" \
--data-raw '{"region":"US","max_results":1,"search_terms":["phone case"],"scrape_product_details":false}'import os
import json
import requests
response = requests.request(
"POST",
"https://toolswitch.dev/v1/tools/apify.tiktok-shop.search.products?memory=2048&timeout=90&maxItems=1&maxTotalChargeUsd=0.08",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
json=json.loads("{\"region\":\"US\",\"max_results\":1,\"search_terms\":[\"phone case\"],\"scrape_product_details\":false}"),
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/apify.tiktok-shop.search.products?memory=2048&timeout=90&maxItems=1&maxTotalChargeUsd=0.08", {
method: "POST",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
"Content-Type": "application/json",
},
body: JSON.stringify(JSON.parse("{\"region\":\"US\",\"max_results\":1,\"search_terms\":[\"phone case\"],\"scrape_product_details\":false}")),
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());网关接口为预览版，地址与鉴权方式可能调整。 示例参数仅为样例数据。 调用按 $0.008/result 计费，已含服务费。