Douyin Topic Analysis

The Specific Problem

When creating content on Douyin (TikTok's Chinese version), creators struggle to quickly identify trending topics and potential viral angles from massive amounts of data. Manual browsing and analysis are inefficient, with information scattered across pages, lacking a systematic tool to integrate hot trends and search results, leading to time-consuming topic planning with suboptimal results.

Core Capabilities and Key Steps

This skill provides Douyin data analysis through the SocialDataX API, with core features including:
- Hot Search Retrieval: Use the douyin hot-search command to fetch the current Douyin hot search list directly, no keyword parameters needed, reflecting real-time platform heat signals.
- Search and Filtering: Conduct searches with douyin search --keyword to specify keywords or topics, supporting various filters:
- Sort types: e.g., --sort-type like_count_descending to sort by likes, --sort-type time_descending to sort by publish time.
- Publish time range: e.g., --publish-time-range week to limit to the past week, or --publish-time-range day for recent content.
- Duration range: e.g., --duration-range under_1_minute for short videos, --duration-range over_5_minutes for long videos.
- Content type: e.g., --content-type video to retrieve only video content, --content-type image for image-text posts.
- Pagination and Expansion: Use the --pages parameter to fetch multiple pages, or --max-items to limit entry count, supporting continuous analysis.
- Output Analysis: Returns JSON data containing titles, authors, links, content IDs, and metrics, facilitating review and decision-making.

Key steps:
1. Ensure the environment variable SOCIALDATAX_API_KEY is configured, obtained from the SocialDataX website.
2. Choose between hot search or search commands based on requirements, inputting keywords or topic directions (e.g., "short video planning").
3. Analyze the returned data.items field to extract traceable information (e.g., titles, authors, links), distinguishing between hot search and search results.
4. Based on results, suggest next actions like refining keywords, filtering specific accounts, or continuing pagination for deeper analysis.

Applicable Boundaries and Notes

• Read-only Operation: The skill is for data querying only, not performing interactions like login, posting, liking, commenting, or account modifications, ensuring a security boundary.
• API Dependency: Requires a valid SocialDataX API Key; insufficient balance will prompt a recharge link, avoiding repeated retries.
• Error Handling: For network errors or dependency issues (e.g., Node.js unavailable), check environment configuration; non-balance issues can be retried once.
• Data Limitations: Search results lack complete boundaries; for pagination, the next_page_token must be passed intact without truncation or rewriting.
• Output Suggestions: Prioritize outputting actionable samples and angles, retaining traceable fields like content IDs, links, publish times; for image-text results, use the images field.