Douyin Hot Search

This skill retrieves ranked topics from Douyin's five public boards, not the videos or image-text posts behind a topic. To find posts for a returned topic, pass its word to douyin-search. The upstream Douyin Hot Search Scraper documents the board names and topic fields; Frevana may reuse a recent snapshot for the same parameters.

Use the bundled Bash script for task creation, status polling, and JSON result retrieval. It requires bash, curl, jq, and either uuidgen or openssl when generating a client task ID. Read references/api.md for request fields and states.

Workflow

1. Use run for a complete task, or create, status, wait, and result for separate phases. Ask for a board only when the caller needs one; the API defaults to hotspot.
2. Treat creation as billable. Record the printed client_task_id. If the create request times out or its outcome is unclear, retry with the same ID and identical options; never generate a new task automatically.
3. Poll until status=READY and billing_status=BILLED. Stop on FAILED, TIMED_OUT, ABORTED, RESULT_EXPIRED, or TRIGGER_UNKNOWN.
4. Return the result JSON unchanged. Do not alter vendor fields or assume a particular item count.

Commands

Resolve {baseDir} to this skill's directory.