Douyin Search

This skill searches Douyin posts, including videos and image-text results, rather than returning ranked hot-search boards. A hot-board topic's word can be used as a keyword here. The upstream Douyin Search Scraper documents the result fields and search filters. This Frevana skill exposes keyword and filter options; its default is 10 results per keyword, and its JSON result may contain Frevana URLs in place of recognized temporary media URLs. The upstream Actor's optional MP4, cover, and slideshow download switches are not exposed by this Frevana script.

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 all filters and task states.

Workflow

1. Require one to fifty keywords. Default to 10 videos per keyword and keep the number of unique keywords multiplied by max_results_per_query at most 1999. Use run for a complete task, or create, status, wait, and result for separate phases.
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. The server archives recognized media to Frevana S3; do not rewrite or reorder result items.

Result links

For a video result, use the fields in the returned JSON according to the user's intent: