ApifyTikTok ShopE-commerce

Search TikTok Shop products by keyword

apify.tiktok-shop.search.products

Scrape 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

Price: $0.008/resultPelo preço do provedor
Success rate: 85%Last 30 days · 40 calls
Latency p50: 34 sp95 80 s
Last verified: 26 de set. de 2026Verified working

POSThttps://toolswitch.dev/v1/tools/apify.tiktok-shop.search.products?memory=2048&timeout=90&maxItems=1&maxTotalChargeUsd=0.08

Preview

Try onlineEm breveProvider docs ↗

Uses platform quota
Synchronous response
Reads public data

Parâmetros

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

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Parâmetros de consulta
`memory`	inteiro	Opcional	MB of run memory. treg's key requires 2048, which fixes the actor-start charge; your own key may set any size	`2048`
`timeout`	inteiro	Opcional	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`	inteiro	Opcional	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`	número	Opcional	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`

Parâmetros de consulta
memoryinteiroOpcional
MB of run memory. treg's key requires 2048, which fixes the actor-start charge; your own key may set any size
Exemplo: 2048
timeoutinteiroOpcional
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
Exemplo: 90
maxItemsinteiroOpcional
optional row cap; pay-per-event actors that take the row count from their own input ignore it, so maxTotalChargeUsd is the spend limit
Exemplo: 100
maxTotalChargeUsdnúmeroOpcional
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
Exemplo: 0.5

Exemplos de código

Substitua $TOOLSWITCH_KEY pela chave criada no console.

Preview

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());

Esta API de gateway está em prévia; a URL e a autenticação podem mudar. Os parâmetros do exemplo são dados de amostra. As chamadas são cobradas a $0.008/result, incluindo a taxa de serviço.