A standardized data query framework to retrieve and analyze Douyin video, user, search, trends, and live data using the MaxHub API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install douyin-data-method
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install douyin-data-method using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Douyin Data Query Method (douyin-data-method)?
The Douyin Data Query Method is a highly structured framework designed to translate business questions into actionable, real-time social media intelligence. By utilizing Openclaw Skills integrated with the MaxHub API, developers and creators can easily programmatically query Douyin's vast ecosystem—covering video metrics, user profiles, trending search lists, Xingtu KOL statistics, brand search indices, and live streaming rooms.
Rather than navigating disparate documentation, this skill defines clear endpoint mapping patterns, parameter conventions, and fail-safe degradation routines. By standardizing the data flow from raw user intent to fully formatted tables and summaries, it empowers AI coding agents to automate sentiment tracking, competitive analysis, influencer research, and trend forecasting on Douyin (the Chinese counterpart of TikTok).
Douyin Data Query Method (douyin-data-method) Use Cases
- KOL & Influencer Evaluation: Evaluate whether a creator is worth partnering with by checking their profile data, fans portrait, video post history, and Xingtu service price quotes.
- Trend & Topic Discovery: Query real-time Douyin hot searches, rising trends, local city hot spots, and keyword rankings to capture trending topics early.
- Competitor Performance Monitoring: Search for competitive videos to extract detailed views, likes, comments, shares, and favorites.
- Brand Sentiment & Search Indexing: Measure keyword associations and brand search volume trends over designated intervals (minimum 7 days).
- Live Streaming Analysis: Extract active viewer counts, titles, and live host profiles directly via live room URLs.
How Douyin Data Query Method (douyin-data-method) Works
- Intent Recognition: The skill extracts the user's core question (e.g., "What is currently trending?" or "Analyze user profile") and maps it to a specific query domain (Hot search, Search, Video, User, Xingtu, Index, or Live).
- Endpoint Mapping: Matches the recognized intent to a precise API endpoint from the MaxHub dictionary, prioritizing newer versions (v4 > v3 > v2) but reserving fallback routes.
- Request & Authentication: Automatically formats and builds the HTTP request (GET or POST), attaching the necessary Bearer token authentication header and any query or body parameters.
- Fallback & Degradation: In case of transient server errors (500) or deprecated endpoints (404/410), the system dynamically downgrades the query up to 3 times to legacy, stable endpoints (e.g., v3 -> v2 -> v1).
- Data Formatting & Localization: Translates numeric units to localized formats (such as "1.2亿" for Chinese or "120M" for English) and outputs the results in a clear markdown structure based on the interaction mode (Browse, Analyze, or Compare).
Douyin Data Query Method (douyin-data-method) Setup
To configure this skill within your workspace, set up your MaxHub authentication credentials and configure the base API environment.
Prerequisites
Acquire an API Key from the MaxHub platform (https://www.aconfig.cn).
Environment Configuration
Define your API key as an environment variable so your Openclaw Skills agent can securely authorize requests:
export MAXHUB_API_KEY="your_maxhub_api_key_here"
Verification
Ensure the authentication key is loaded correctly with the following validation command:
[ -n "${MAXHUB_API_KEY:-}" ] && echo "Credentials: OK" || echo "Credentials: Missing"
Douyin Data Query Method (douyin-data-method) Data Schema & Taxonomy
This skill maps specific user intents to precise endpoint schemas across seven distinct domains. Developers should adhere to the exact endpoint paths listed below rather than dynamically splicing URLs.
Endpoint Reference Table
| Domain | Action / Intent | Method | Endpoint Path | Critical Parameters |
|---|---|---|---|---|
| Hot Search | Main Hot List | GET | /api/v1/douyin/web/fetch_hot_search_result |
None |
| Search | General Search | POST | /api/v1/douyin/search/fetch_general_search_v1 |
keyword (JSON body) |
| Video | Video Detail | GET | /api/v1/douyin/app/v3/fetch_one_video_v2 |
aweme_id |
| User | Profile Details | GET | /api/v1/douyin/app/v3/handler_user_profile_v4 |
sec_user_id |
| Xingtu | KOL Search | GET | /api/v1/douyin/xingtu/search_kol_v2 |
keyword |
| Index | Trend Search | POST | /api/v1/douyin/index/fetch_multi_keyword_hot_trend |
keyword_list, start_date, end_date |
| Live | Room Info | GET | /api/v1/douyin/app/v3/douyin_live_room |
live_room_url |
General Search POST Body Format
For search operations using POST, use the following standard JSON payload format:
{
"keyword": "example",
"cursor": 0,
"sort_type": "0",
"publish_time": "0",
"filter_duration": "0",
"content_type": "0",
"search_id": ""
}
Douyin Data Query Method (douyin-data-method) Advanced Features
- Intelligent Failover Matrix: Automatically intercepts
404or500server responses and executes a pre-defined degradation path, reducing developer operational friction. - Multi-Mode Interaction Engine: Supports distinct execution behaviors depending on semantic prompts (Browse for quick reports, Analyze for deep-dives, and Compare for side-by-side matrices).
- Asynchronous Parallelism: Runs multiple independent queries (such as matching multiple user IDs or comparing brand lines) concurrently to optimize latency.
- Xingtu KOL Converter: Seamlessly translates standard User IDs (
sec_user_idoruid) into targetkolIdvalues to fetch pricing metrics without manual lookup workflows.
SKILL.md
Loading
Related Openclaw Skills
Financial Audit Domain
A specialized financial risk analysis and audit reference library designed for A-share non-financial listed companies, integrating 50 indicators and 5 fraud red lines.
Medical Imaging and Interventional Diagnosis (9th Edition)
A comprehensive medical imaging and interventional radiology clinical decision-support and educational skill package for AI agents, containing 136 core competencies based on the authoritative 9th Edition Medical Imaging textbook.
Systematic Anatomy 10th Edition Skill Pack
An advanced Openclaw skill pack mapping 112 core anatomical proficiencies based on the authoritative People's Medical Publishing House Systematic Anatomy 10th Edition.
Medical Genetics 8th Edition Skill Pack
A highly specialized knowledge and analysis toolkit transforming complex clinical genetics and genomics principles into execution-ready AI tasks.
GuanShi Data Expert
An AI agent skill designed for automated data cleaning, statistical testing, financial modeling, and scenario simulation following the CRISP-DM methodology.
GuanShi Intelligence Expert
An automated AI intelligence agent designed to search, filter, extract, and cross-validate industry data to produce structured, high-confidence intelligence reports.
Featured*
