TikTok shop search API tiktok_shop_product_search
tiktok_shop_product_search is the Finewisdom TikTok shop search API (method tiktok_shop_product_search). ¥0.2 CNY per successful call, 20 free calls on signup, billed only on success.
Parameters
| Parameter | Description | Required |
|---|---|---|
search_word | Search keyword | required |
offset | Pagination offset (0 on the first page) | optional |
page_token | Page token (pass page_token from load_more_params) | optional |
region | Country/site code: ID/JP/MX/MY/PH/SG/TH/VN (default MY) | optional |
Request example
Replace the token with yours. All parameters go in the query string.
GET https://finewisdom.top/api?token=fw_xxx&method=tiktok_shop_product_search&search_word={search_word}&offset={offset}&page_token={page_token}®ion={region}
Python
import requests
resp = requests.get(
"https://finewisdom.top/api",
params={"token": "fw_xxx", "method": "tiktok_shop_product_search", "search_word": "...", "offset": "...", "page_token": "...", "region": "..."},
timeout=60,
)
payload = resp.json()
if payload.get("status") == "success":
data = payload["data"]
else:
print(payload["message"]) # failed calls are not charged
Response envelope
Every call returns the same envelope. Billing only happens when status is success.
{
"status": "success",
"message": "...",
"data": { ... }
}
Only the envelope is shown. Fields inside data depend on the platform response — inspect one real call before writing a parser.
A token is generated when you sign up in the console (format fw_xxx). Never commit it to a repo or write it to logs.
Pricing & rate limit
¥0.2 CNY per successful call. Failed calls, timeouts and empty results are never charged. Rate limit: 1 request/second/IP (HTTP 429 beyond that).
New accounts get 20 free calls. Balance never expires.
FAQ
No. Calls returning status=error or api_error are not charged, and any pre-authorised amount is refunded automatically. Only status=success counts as a billable call.
¥0.2 CNY per successful call. No subscription, no minimum spend. Each page of results is a separate call.
Pass offset with the cursor returned by the previous page (omit it for the first page). Social endpoints paginate by cursor; e-commerce endpoints usually use page. Do not mix the two.