douyin-video-search

Extracts structured Douyin video search results with author, stats, hashtags, and download URLs.

5.5k|269|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/browser-act/skills --skill douyin-video-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: douyin-video-search
Source: https://github.com/browser-act/skills/tree/main/solutions/video-platforms/douyin-video-search
Command: npx skills add https://github.com/browser-act/skills --skill douyin-video-search

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Manually collecting Douyin video data for keyword research, KOL analysis, or content monitoring is slow and error-prone. This Skill automates keyword-based video search on douyin.com and returns clean, structured data for every result.

Core Features & Use Cases

  • Keyword Video Search: Calls Douyin's web search API from an authenticated browser session and returns video ID, title, author, profile URL, cover, description, hashtags, download URL, likes, comments, shares, and publish time.
  • Filtering and Sorting: Supports sorting by comprehensive relevance, most liked, or latest, plus date filters for 1 day, 7 days, 6 months, or 1 year.
  • Paginated Batch Collection: Handles offset-based pagination with resumable state (next_offset, next_search_id) for large-scale collection across multiple keywords.
  • Use Case: A marketing analyst researching AI-related content trends on Douyin can search a keyword, filter to the past week sorted by likes, and collect hundreds of videos with creator info and engagement stats for analysis.

Quick Start

Log in to Douyin in the browser, then ask the agent to search Douyin for videos about your keyword sorted by most likes from the past week.

Frequently Asked Questions about douyin-video-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Douyin videos by keyword and get structured data?

Navigate to the Douyin search page for your keyword, then run the search-videos.py script which generates JavaScript calling Douyin's web search API. It returns JSON with video ID, author, stats, hashtags, and download URL per result.

How to scrape Douyin search results with date and like filters?

Pass --sort-type (0 comprehensive, 1 most liked, 2 latest) and --publish-time (1, 7, 180, or 365 days) to the script. These map to Douyin's filter panel options and are applied server-side by the search API.

Does Douyin video search require a login session?

Yes, an active logged-in Douyin session in the browser is required. The API returns status_code 2483 when unauthenticated or the session expires, in which case you must re-verify login and retry.

How do I paginate through all Douyin search results?

Start with offset 0, then use next_offset and next_search_id from each response for subsequent pages. Pagination ends when has_more is 0 or count is 0; add 1-2 second delays between requests to avoid rate limits.

Why does the Douyin search API return an error or empty results?

Most errors come from expired session cookies, indicated by status_code 2483 or an error flag in the output. Re-navigate to douyin.com to refresh the session, then retry the request.

Can I get the actual MP4 file from Douyin search results?

The download_url field is a redirect URL under /aweme/v1/play/, not the final file. Follow the redirect to reach the CDN-hosted MP4 URL for the actual video file.