Finewisdom API Hub
Home › API Reference › Douyin › douyin_product_keyword_search

Douyin product search API douyin_product_keyword_search

douyin_product_keyword_search is the Finewisdom Douyin product search API (method douyin_product_keyword_search). ¥0.3 CNY per successful call, 20 free calls on signup, billed only on success.

Get 20 free callscatalog.jsonMCP

Parameters

ParameterDescriptionRequired
keywordSearch keywordrequired
pagePage numberoptional
countItems per pageoptional

Request example

Replace the token with yours. All parameters go in the query string.

GET https://finewisdom.top/api?token=fw_xxx&method=douyin_product_keyword_search&keyword={keyword}&page={page}&count={count}

Python

import requests

resp = requests.get(
    "https://finewisdom.top/api",
    params={"token": "fw_xxx", "method": "douyin_product_keyword_search", "keyword": "...", "page": "...", "count": "..."},
    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.3 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

Do failed calls cost anything?

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.

How much does one call cost?

¥0.3 CNY per successful call. No subscription, no minimum spend. Each page of results is a separate call.

More Douyin endpoints

douyin_author_info¥0.1Douyin author infodouyin_author_search¥0.1Douyin author searchdouyin_keyword_search¥0.1Douyin keyword searchdouyin_product_comments¥0.2Douyin product commentsdouyin_product_detail¥0.3Douyin product detaildouyin_product_detail_v2¥0.2Douyin product detail v2douyin_product_detail_v3¥0.3Douyin product detail v3douyin_shop_search¥0.3Douyin shop searchdouyin_video_comments¥0.2Douyin video commentsdouyin_video_detail¥0.1Douyin video detaildouyin_video_like_count¥0.1Douyin video like countdouyin_video_play_count¥0.1Douyin video play count