kuaishou-account-works

Kuaishou Account Works Query

📝 Introduction

Kuaishou account works query tool, covering two complementary scenarios (Lindorm data source):

Account works list: Precisely match and query the works list of the account by Kuaishou account platform display id (kwaiId) or homepage link id (threeXId), returning in reverse chronological order by publish time.
Single work details: Precisely match and query the main content details of a single work by work ID (photoId), digging deep into viral performance data.

Title, play count, like count, comment count, favorite count, share count, repost count, video duration, cover and video link at a glance.

Feature Module	Capability Description	Core Value
Dual ID query (list)	Supports two account identifiers: kwaiId / threeXId	Query with either homepage link or platform id
Account works list	Precisely match all visible works of the account, in reverse chronological order by publish time	Pull the complete works library in one go, keep up with the latest content
photoId precise query (details)	Precisely match single work details by work ID	Dig deep into the complete data of a single work
Complete data dimensions	Plays/likes/comments/favorites/shares/reposts/duration	Comprehensively evaluate work performance
Author information	Nickname + follower count + avatar	Quickly understand the author's influence
Paginated browsing	Up to 50 items per page, supports browsing multiple pages	Never miss a single piece of content
Direct work access	Directly output cover and video URL	Quickly view/download the original video

🔍 Content creators — Break down the work structure of benchmark accounts, dig deep into single viral hits, and study viral patterns.
📊 Operations / Data analysis — Understand account update frequency and traffic trends, and precisely track single work performance.
🏢 Brands / MCNs — Screen the work performance of partner influencers, and evaluate the actual value of individual collaboration works.
🛒 E-commerce product selection — View the latest works of e-commerce accounts, and match promotion directions.

Visit Honghu Hub official website to learn more about the service
Go to the registration page to register an account
Newly registered users will receive free credits, and can immediately start using the API service
After registering and logging in, get the API Key in the personal center, in the format ak_xxxxxxxx

REDFOX_API_KEY Obtain from environment variables, format ak_xxxxxxxx
If not set, prompt the user to configure it themselves:export REDFOX_API_KEY=<你的apikey>; if the user does not know how to configure it, the Agent should proactively help the user set it up:
- macOS/Linux: Append export REDFOX_API_KEY=<值> to ~/.zshrc(zsh) or ~/.bashrc(bash), then source the corresponding file to make it take effect globally
- Windows: Use [Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<值>", "User") to set a user-level permanent environment variable (requires restarting the terminal to take effect)
- After configuration is complete, verify:echo $REDFOX_API_KEY(macOS/Linux) or echo %REDFOX_API_KEY%(Windows), to ensure it can also be read when switching to another skill

This skill supports two core scenarios:

Scenario A — Query the list of works by account: Query all works of an account via kwaiId or threeXId, obtain complete interaction data such as plays, likes, and comments, and display them in reverse chronological order by publish time
Scenario B — Query details of a single work: Precisely query the full text details of a single work via photoId, and dig deep into viral performance data

For detailed execution steps, parameter descriptions, and output formats, see references/core_workflow.md

Data is updated every morning at 06:00 (wide-area database snapshot).

Path	Purpose
scripts/search_ks_work.py	Account works list query script
scripts/search_ks_detail.py	Work details query script
`references/core_workflow.md`	Core execution flow and output specifications
README.md	Complete API descriptions and returned field documentation