Douyin Product Search Scraper

Search Douyin Shop (抖音商城) by product keyword and get one structured listing row per public product — title, price, sales when shown, shop, image, and haohuo.jinritemai.com detail URL. Built for China ecommerce research, affiliate selection, and MCP agents.

Referenced by: .actor/actor.json → "readme": "../README.md". User instruction: build Douyin product search scraper.

Best for

• Cross-border sellers researching Douyin Shop demand for Chinese keywords.
• Agencies comparing public price / sold labels across competing SKUs.
• Agents that need a keyword → product listing tool for China ecommerce.

Use this Actor when you have a product keyword and need Douyin Shop listings.

Do not use this Actor for Douyin video search (douyin-search-scraper), creator profiles (douyin-profile-scraper), video metadata (douyin-video-scraper), comments (douyin-comments-scraper), or global TikTok Shop (tiktok-shop-scraper). This SKU is China Douyin Shop only.

Workflow story

A China ecommerce analyst sets searchQueries to ["口红"] and maxResults to 5. The run opens Douyin web search on the goods tab, intercepts public product XHR after Camoufox warmup, and returns listing rows with productId, title, priceAmount, shopName, and detailUrl. A captcha-walled route finishes FAILED with UPSTREAM_FAILED and zero product-found charges. A keyword with no public goods matches finishes SUCCEEDED with VALID_EMPTY.

Input example

{
  "searchQueries": ["口红"],
  "maxResults": 5
}

Field	Type	Description
searchQueries	array (required)	Product keywords. Chinese works best. Max 20 unique.
maxResults	integer	Cap on unique rows this run (1–200, default 50).
proxyConfiguration	object	Optional. Default path is owner DataImpulse → Apify Residential Asia.

Output fields

One dataset item is one public Douyin Shop listing.

{
  "productId": "3821314999977115743",
  "promotionId": "3821317546850779275",
  "title": "兰蔻全新菁纯柔润丝缎唇膏196#朱砂橘 1.6g",
  "detailUrl": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3821314999977115743&origin_type=2631",
  "mainImage": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/example.jpg",
  "priceAmount": 59.0,
  "priceCents": 5900,
  "monthlySold": 1162,
  "shopName": "桢植专营店",
  "shopScore": 92,
  "searchKeyword": "口红",
  "searchPosition": 1,
  "scrapedAt": "2026-09-22T00:00:00.000Z",
  "provider": "camoufox"
}

Field availability varies. Affiliate commission, review ratio, and sales counters are included only when Douyin exposes them on the public listing payload. Advertised commission is not a revenue guarantee.

Pricing

Pay per event + platform usage pass-through:

• apify-actor-start: $0.00005
• product-found: $0.009 per pushed product row

Invalid input and fully blocked upstream runs do not charge product-found. See the Actor Pricing tab for live numbers.

API / MCP

curl -X POST "https://api.apify.com/v2/acts/khadinakbar~douyin-product-search-scraper/runs" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchQueries":["口红"],"maxResults":5}'

Agent prompt card:

Use khadinakbar/douyin-product-search-scraper with searchQueries set to one
Chinese Douyin Shop keyword (e.g. 口红) and maxResults at 5. Expect one row
per public product listing with title, price, shop, and detailUrl. Do not use
this for TikTok Shop or Douyin video search.

Best results

• Prefer Chinese product nouns over English brand-only queries.
• Keep maxResults small for cost-bounded probes.
• Owner DataImpulse CN residential is the primary unlock path; Apify Residential alone often hits Douyin's captcha interstitial on search.

Builder's note

Douyin signs web search XHR with msToken / a_bogus, so passive Camoufox intercept after homepage warmup is more reliable than forging signatures. ScrapeCreators and SociaVault have no Douyin routes; TikTok Shop provider routes are a different market and must not be wired here.

Honest limits

• Public web listing fields only. No login, no private inventory, no guaranteed affiliate fields.
• Search pages are more aggressively captcha-walled than /video/{id} detail pages.
• Not affiliated with Douyin or ByteDance.

Legal

Only scrape public Douyin Shop content you are allowed to process. Respect Douyin's terms, applicable privacy law (including PIPL where relevant), and your own compliance policy.