tikhub-api-helper

TikHub API ヘルパー

ソーシャルメディアのデータを取得するために、TikHub API のエンドポイントを検索、特定、呼び出す際にユーザーを支援するスキルです。

クイックスタート

ユーザーが TikHub API について質問したり、ソーシャルメディアのデータを取得したいと依頼したりした場合：

1. API 検索スクリプトを使って関連する API を検索します
2. パラメーターとともに、利用可能な選択肢をユーザーに提示します
3. 適切なパラメーターで API を呼び出します
4. 整形した結果をユーザーに返します

利用可能なスクリプト

API 検索ツール — api_searcher.py

関連する TikHub API エンドポイントを検索、特定します。

# 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 クライアント — api_client.py

TikHub API エンドポイントに HTTP リクエストを送信します。

# 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://..."}'

対応プラットフォーム

プラットフォーム	タグ名	利用可能な API
TikTok Web	TikTok-Web-API	58 エンドポイント
TikTok App	TikTok-App-V3-API	76 エンドポイント
Douyin Web	Douyin-Web-API	76 エンドポイント
Douyin App	Douyin-App-V3-API	45 エンドポイント
Douyin Search	Douyin-Search-API	20 エンドポイント
Douyin Billboard	Douyin-Billboard-API	31 エンドポイント
Xiaohongshu Web	Xiaohongshu-Web-API	26 エンドポイント
Instagram	Instagram-V2-API	26 エンドポイント
YouTube	YouTube-Web-API	16 エンドポイント
Twitter	Twitter-Web-API	13 エンドポイント
Reddit	Reddit-APP-API	23 エンドポイント
Bilibili	Bilibili-Web-API	24 エンドポイント
Weibo	Weibo-Web-V2-API	33 エンドポイント
Zhihu	Zhihu-Web-API	32 エンドポイント

すべてのカテゴリを確認するには、python api_searcher.py tags を実行してください。

よくある使用例

ユーザープロフィールを取得する

# 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 リクエストでは、開発用のデフォルトトークンを使用します。本番環境では、ユーザーは次の手順を実行してください：

1. TikHub User から API トークンを取得します
2. TIKHUB_TOKEN 環境変数を設定します
3. または、api_client.py の DEFAULT_TOKEN を変更します

リクエスト形式：

{
  "Authorization": "Bearer YOUR_API_TOKEN"
}

ベース URL

• 中国国内のユーザー：https://api.tikhub.dev（GFW を回避します）
• その他の地域：https://api.tikhub.io

API クライアントは適切な URL を自動的に判別します。上書きするには、クライアントの use_china_domain パラメーターを変更してください。

レート制限

• QPS：エンドポイントごとに毎秒 10 リクエスト
• タイムアウト：30～60 秒
• 再試行：エラー時は最大 3 回

Claude 向けの手順

TikHub API についてユーザーを支援する際は、次の手順に従ってください：

1. ユーザーの目的を把握する — どのデータを、どのプラットフォームから取得したいのかを確認します
2. 関連する API を検索する — 適切なキーワードを指定して api_searcher.py を使用します
3. 選択肢を提示する — 該当する API と簡単な説明を示します
4. パラメーターを案内する — detail:OPERATION_ID を使って必須パラメーターを確認します
5. リクエストを送信する — ユーザーのパラメーターを指定して api_client.py を使用します
6. 結果を整形する — API のレスポンスを分かりやすく読みやすい形式で提示します

ワークフローの例

ユーザー：「TikTok ユーザーのプロフィールを取得したいです」

# 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

エラー処理

よくあるエラーと解決方法：

エラー	解決方法
401 Unauthorized	API トークンが有効か確認します
429 Too Many Requests	レート制限に達しました。再試行する前に待機してください
Connection error	ネットワークを確認します。中国本土にいる場合は中国向けドメインを試してください
Missing parameter	API の詳細で必須パラメーターを確認します

参考資料

• API ドキュメント全文：TikHub API Docs
• Apifox ドキュメント：docs.tikhub.io
• API ステータス：monitor.tikhub.io
• GitHub：github.com/TikHub