// Search and query TikHub APIs for TikTok, Douyin, Xiaohongshu, Lemon8, Instagram, YouTube, Twitter, Reddit, and more. Use when user asks about needs to fetch data from social media platforms. Supports both English and Chinese queries.
Conduct deep research on any topic using parallel subagents and web tools (web_search, web_fetch, playwright). Use for queries that require comprehensive research from multiple perspectives.
Add citations to research reports. Use after deep-research completes to add proper source citations.
| name | tikhub-api-helper |
| description | Search and query TikHub APIs for TikTok, Douyin, Xiaohongshu, Lemon8, Instagram, YouTube, Twitter, Reddit, and more. Use when user asks about needs to fetch data from social media platforms. Supports both English and Chinese queries. |
A skill to help users search, find, and call TikHub API endpoints for social media data.
When a user asks about TikHub API or wants to fetch social media data:
api_searcher.pySearch and find relevant TikHub API endpoints.
# Search by keyword
python api_searcher.py "user profile"
python api_searcher.py "视频评论"
python api_searcher.py "trending"
# List all APIs for a specific tag/category
python api_searcher.py tag:TikTok-Web-API
python api_searcher.py tag:Douyin-App-V3-API
# List popular/common APIs
python api_searcher.py popular
# List all available tags/categories
python api_searcher.py tags
# Get detailed info for a specific API
python api_searcher.py detail:tiktok_web_fetch_user_profile_get
api_client.pyMake HTTP requests to TikHub API endpoints.
# Health check (no authentication required)
python api_client.py GET /api/v1/health/check
# Get user profile
python api_client.py GET /api/v1/tiktok/web/fetch_user_profile "sec_user_id=MS4wLjABAAAA..."
# Search for videos
python api_client.py GET /api/v1/tiktok/web/fetch_search_video "keyword=gaming"
# POST request with JSON body
python api_client.py POST /api/v1/tiktok/web/generate_xgnarly '{"url": "https://..."}'
| Platform | Tag Name | APIs Available |
|---|---|---|
| TikTok Web | TikTok-Web-API | 58 endpoints |
| TikTok App | TikTok-App-V3-API | 76 endpoints |
| Douyin Web | Douyin-Web-API | 76 endpoints |
| Douyin App | Douyin-App-V3-API | 45 endpoints |
| Douyin Search | Douyin-Search-API | 20 endpoints |
| Douyin Billboard | Douyin-Billboard-API | 31 endpoints |
| Xiaohongshu Web | Xiaohongshu-Web-API | 26 endpoints |
Instagram-V2-API | 26 endpoints | |
| YouTube | YouTube-Web-API | 16 endpoints |
Twitter-Web-API | 13 endpoints | |
Reddit-APP-API | 23 endpoints | |
| Bilibili | Bilibili-Web-API | 24 endpoints |
Weibo-Web-V2-API | 33 endpoints | |
| Zhihu | Zhihu-Web-API | 32 endpoints |
Use python api_searcher.py tags to see all categories.
# TikTok user profile
python api_searcher.py "fetch user profile tiktok"
python api_client.py GET /api/v1/tiktok/web/fetch_user_profile "sec_user_id=USER_ID"
# TikTok video details
python api_searcher.py "fetch post detail"
python api_client.py GET /api/v1/tiktok/web/fetch_post_detail "post_id=POST_ID"
# Search for videos/users
python api_searcher.py "search video"
python api_client.py GET /api/v1/tiktok/web/fetch_search_video "keyword=YOUR_KEYWORD"
# Get video comments
python api_searcher.py "fetch comment"
python api_client.py GET /api/v1/tiktok/web/fetch_post_comment "post_id=POST_ID"
API requests use a default token for development. For production use, users should:
TIKHUB_TOKEN environment variableDEFAULT_TOKEN in api_client.pyRequest format:
{
"Authorization": "Bearer YOUR_API_TOKEN"
}
https://api.tikhub.dev (bypasses GFW)https://api.tikhub.ioThe API client auto-detects the appropriate URL. To override, modify the use_china_domain parameter in the client.
When helping users with TikHub API:
api_searcher.py with appropriate keywordsdetail:OPERATION_IDapi_client.py with the user's parametersUser: "I want to get a TikTok user's profile"
# Step 1: Search for the relevant API
python api_searcher.py "tiktok user profile"
# Step 2: Show results and confirm endpoint
# Found: GET /api/v1/tiktok/web/fetch_user_profile
# Step 3: Get detailed parameter info
python api_searcher.py detail:tiktok_web_fetch_user_profile_get
# Step 4: Make the API call with user's parameters
python api_client.py GET /api/v1/tiktok/web/fetch_user_profile "sec_user_id=MS4wLjABAAAA..."
# Step 5: Format and present results
Common errors and solutions:
| Error | Solution |
|---|---|
401 Unauthorized | Check API token is valid |
429 Too Many Requests | Rate limit exceeded, wait before retry |
Connection error | Check network, try China domain if in mainland China |
Missing parameter | Check API details for required parameters |