Douyin Hashtag Detail Scraper

EN — Get details of a Douyin hashtag (challenge) by its numeric ch_id. Returns the rich ch_info object: name, description, total view count, total user count, share metadata, author info, and challenge flags. One run = one upstream call.

ZH — 抖音话题详情 — 通过 ch_id(话题 ID)抓取话题元数据。 返回完整的 ch_info:名称、描述、总播放量、总参与用户数、分享链接、作者信息、是否官方话题等。一次运行 = 一次上游请求。

Built for influencer research, trend analysis, brand monitoring, competitor benchmarking, and content ops workflows on Douyin (TikTok China) — China's #1 short-video platform with 750M+ daily active users.

5 free runs / day. No API key required — the Actor's built-in upstream key is already configured.

Input

Field	Type	Required	Default	Notes
chId	integer	yes	—	Douyin challenge id (numeric). Example: 1575791821492238.

A real-world example: ch_id 1575791821492238 = 深海 (Deep Sea) — 5.28 billion cumulative views.

{
  "chId": 1575791821492238
}

Output

The Actor pushes one item (the normalized ch_info) to the default dataset and writes a SUMMARY record to the default key-value store.

{
  "ch_id": 1575791821492238,
  "cha_name": "深海",
  "desc": "深海是一个挑战话题",
  "view_count": 5283529674,
  "user_count": 52345678,
  "is_challenge": true,
  "is_pgcshow": false,
  "share_info": {
    "share_title": "深海",
    "share_desc": "深海挑战话题",
    "share_url": "https://www.iesdouyin.com/share/challenge/1575791821492238"
  },
  "author": { /* creator profile when available */ },
  "rawData": { /* full upstream ch_info object */ }
}

How to find a chId

The chId is the numeric challenge id Douyin assigns to every hashtag. You can grab it from any public hashtag URL in three ways:

Option A — From a Douyin hashtag page URL (recommended)

Open any hashtag page in a desktop browser. The URL ends with the numeric ch_id:

https://www.douyin.com/challenge/1575791821492238
                                  └──────── chId ────────┘

Copy the trailing number → paste it into the input field.

Option B — From a share / short URL

When someone shares a hashtag link on mobile, Douyin rewrites it into a short form. Paste the short URL into the address bar of a desktop browser and hit Enter — it redirects to the canonical /challenge/<id> form, then grab the trailing number as in Option A.

https://v.douyin.com/iJxxxxxxx/   →   https://www.douyin.com/challenge/1575791821492238

Option C — From a video inside the hashtag

Open any video that belongs to a hashtag. The URL contains the aweme_id (video id) — but you also need the ch_id. Click the hashtag chip below the video description; it opens the canonical hashtag page, then grab the ch_id from the URL as in Option A.

Quick validation

After entering a chId, the upstream returns cha_name (the hashtag name). If cha_name is empty or null, the id is invalid — re-check the URL or pick another hashtag.

Common mistake

• ❌ Do not paste the share URL — only the trailing numeric id is accepted.
• ❌ Do not include ch_id= query-string form (ch_id=1575791821492238) — strip the ch_id= prefix.
• ✅ Correct: "chId": 1575791821492238
• ✅ Correct: "chId": "1575791821492238" (string form also accepted — both fields parse to integer internally)

Use it together with the other Douyin Actors

This Actor is part of the 5-Actor Douyin MVP set. Use it together with:

Where in the pipeline	Actor	Use it to
you are here	Douyin Hashtag Detail Scraper (you are here)	(this Actor)
before / step ①	../douyin-hashtag-search/README.md	keyword search → get topic_id (= ch_id) for any hashtag you want to look up
sister step ③	../douyin-hashtag-video-list/README.md	walk the full video list under the same ch_id
sister Actor	../douyin-hot-search-list/README.md	board-level trends — find the topic in mainstream before it gets saturated
sister Actor	../douyin-live-hot-search-list/README.md	live-stream specific trends

You are here: Douyin Hashtag Detail Scraper — run this on its own for the upstream use case described above, or chain it with the other 4 Actors for a full Douyin keyword → hashtag → videos → trends pipeline.

Use cases

Persona	Use it for
Influencer marketer	Discover a hashtag's total reach (view_count) before partnering with creators in that vertical
Brand manager	Monitor your brand-challenge's user_count and view_count to track momentum
Trend researcher	Map a challenge's metadata (cha_name, desc) to category and growth phase
Content ops	Extract share_url / share_title to drive cross-platform UGC programs
Competitor analyst	Pull challenge metadata for any ch_id you find in competitor video URLs

Why this Actor exists

Douyin's hashtag system is the primary discovery surface on the platform. Knowing a challenge's view_count and user_count is the first step in any influencer / brand / trend analysis workflow. This Actor is the step ① entry point of the 4-Actor Douyin MVP set.

Pricing

Free users are limited to 5 runs per day. Paid users (APIFY_USER_IS_PAYING=1) have unlimited runs. The Actor itself adds no markup — you pay the upstream provider per request plus the standard Apify compute unit cost.

Test locally

cd douyin-hashtag-detail
UPSTREAM_API_KEY=... UPSTREAM_BASE_URL=<your-upstream-base-url> npm test

• node test/unit.js — 3 unit assertions on normalize / extract / rank.
• node test/integration.js — 1 live call against a known ch_id.

Output schema

See .actor/output_schema.json for the full type schema, or read it at runtime via the Apify API.

License

MIT