tikhub-social-media

# TikHub Social Media Data Query ## Setup (Required) Set your API key before using this skill: ```bash export TIKHUB_API_KEY="<your-tikhub-api-key>" ``` Get your API key at: https://tikhub.io (register → dashboard → API Keys) Optional proxy (if TikHub API is blocked in your network): ```bash export TIKHUB_PROXY="http://your-proxy:port" ``` ## Authentication - **Base URL**: `https://api.tikhub.io` - **Auth Header**: `Authorization: Bearer <TIKHUB_API_KEY>` - All responses: unified `ResponseModel` → `{code, message, data, cache_url, ...}` - Check balance: `GET /api/v1/tikhub/user/get_user_info` ## Helper Script Use `scripts/tikhub_query.py` for all API calls: ```bash python3 scripts/tikhub_query.py <endpoint_path> [param=value ...] [--method POST] [--body '{}'] ``` Examples: ```bash # Search Douyin videos python3 scripts/tikhub_query.py /api/v1/douyin/web/fetch_search keyword=宁德时代 # Get TikTok user profile python3 scripts/tikhub_query.py /api/v1/tiktok/web/fetch_user_profile secUid=MS4wLjABAAAA... # Search Xiaohongshu notes python3 scripts/tikhub_query.py /api/v1/xiaohongshu/web/get_note_by_keyword keyword=CATL # Get Instagram user info python3 scripts/tikhub_query.py /api/v1/instagram/v1/fetch_user_info username=cataborrecycling # Search Twitter python3 scripts/tikhub_query.py /api/v1/twitter/web/fetch_search_timeline keyword="CATL battery" # Search YouTube python3 scripts/tikhub_query.py /api/v1/youtube/web/search_videos keyword="CATL solid state battery" # Get Weibo hot search python3 scripts/tikhub_query.py /api/v1/weibo/web/fetch_hot_search # Hybrid parse any video URL python3 scripts/tikhub_query.py /api/v1/hybrid/video_data url=https://v.douyin.com/xxx ``` ## Platform Quick Reference ### Endpoint Naming Convention All endpoints follow: `/api/v1/{platform}/{source}/{action}` - `platform`: douyin, tiktok, xiaohongshu, instagram, youtube, twitter, weibo, kuaishou, bilibili, etc. - `source`: web, app, app/v3, web_v2, etc. - `action`: fetch_user_profile, fetch_one_video, fetch_search, etc. ### Core Actions (available on most platforms) | Action Pattern | Purpose | |---|---| | `fetch_user_profile` / `fetch_user_info` | Get user/account details | | `fetch_user_post` / `fetch_user_posts` | Get user's posts/videos | | `fetch_one_video` / `fetch_post_detail` | Get single post/video by ID | | `fetch_search` / `search` | Keyword search | | `fetch_post_comments` / `fetch_comments` | Get comments on a post | | `fetch_user_fans` / `fetch_user_followers` | Follower list | | `fetch_user_follow` / `fetch_user_followings` | Following list | | `fetch_trending` / `fetch_hot_search` | Trending/hot topics | ### Platform → Preferred API Version | Platform | Preferred Prefix | Notes | |---|---|---| | 抖音 Douyin | `/api/v1/douyin/web/` or `/api/v1/douyin/app/v3/` | Web for search, App V3 for details | | 抖音搜索 | `/api/v1/douyin/search/` | Dedicated search APIs (latest) | | 抖音创作者 | `/api/v1/douyin/creator_v2/` | Requires creator cookie | | 抖音热榜 | `/api/v1/douyin/billboard/` | Hot lists, trending | | 抖音星图 | `/api/v1/douyin/xingtu_v2/` | KOL marketplace data | | TikTok | `/api/v1/tiktok/web/` or `/api/v1/tiktok/app/v3/` | Web for search, App V3 for details | | 小红书 XHS | `/api/v1/xiaohongshu/app_v2/` | Most stable, recommended | | Instagram | `/api/v1/instagram/v1/` | Prefer V1, V2/V3 as fallback | | YouTube | `/api/v1/youtube/web/` | V2 for additional features | | Twitter/X | `/api/v1/twitter/web/` | Search, user, posts, trending | | Threads | `/api/v1/threads/web/` | User, posts, search | | Reddit | `/api/v1/reddit/app/` | Full featured app API | | LinkedIn | `/api/v1/linkedin/web/` | Profiles, posts, search | | 微博 Weibo | `/api/v1/weibo/web_v2/` | V2 recommended | | 快手 Kuaishou | `/api/v1/kuaishou/web/` or `/api/v1/kuaishou/app/` | | | B站 Bilibili | `/api/v1/bilibili/web/` | | | 微信公众号 | `/api/v1/wechat_mp/web/` | Article extraction | | 微信视频号 | `/api/v1/wechat_channels/` | Requires special params | | 知乎 Zhihu | `/api/v1/zhihu/web/` | Q&A, articles, search | | 今日头条 | `/api/v1/toutiao/web/` or `/api/v1/toutiao/app/` | | | Lemon8 | `/api/v1/lemon8/app/` | | ### Pagination Most list endpoints support cursor-based pagination: - `cursor` / `max_cursor` / `offset` / `after` — pass from previous response - `count` / `page_size` — items per page (typically 10-30) - Response includes `has_more`, `cursor`, `next_cursor` etc. ### Hybrid Video Parser Parse any video URL from supported platforms automatically: ``` GET /api/v1/hybrid/video_data?url=<any_video_url> ``` Supports: Douyin, TikTok, Xiaohongshu, Kuaishou, Bilibili, Weibo, etc. ## Detailed Platform References For full endpoint lists per platform, read the corresponding reference file: - **references/douyin.md** — Douyin (Web + App + Search + Billboard + Creator + Xingtu) - **references/tiktok.md** — TikTok (Web + App + Creator + Analytics + Ads + Shop) - **references/xiaohongshu.md** — Xiaohongshu (App V2 + Web V2) - **references/instagram.md** — Instagram (V1 + V2 + V3) - **references/youtube.md** — YouTube (Web + V2) - **references/twitter-threads.md** — Twitter/X + Threads - **references/reddit-linkedin.md** — Reddit + LinkedIn - **references/chinese-platforms.md** — Weibo, Kuaishou, Bilibili, WeChat, Zhihu, Toutiao, etc. Only read the relevant reference file when you need endpoint details for a specific platform. ## Cost Awareness - Most endpoints: $0.001-$0.005 per call - Some premium endpoints (Instagram, creator analytics): up to $0.01 - Always prefer cached results when `cache_url` is returned - Batch operations where available (e.g., Reddit batch post details) - Check balance before bulk operations: `GET /api/v1/tikhub/user/get_user_info`