analyzing-tiktok-hashtag-performance

TikTok ハッシュタグのパフォーマンスを分析する

TikTok のハッシュタグページをスクレイピングし、パフォーマンス上位の動画、エンゲージメントデータ、クリエイター情報を取得します。複数のハッシュタグを並べて比較し、特定のコンテンツカテゴリーで最もリーチを獲得できるものを特定します。

前提条件

• APIFY_TOKEN 環境変数が設定されていること
• 任意：Apify MCP サーバーがインストールされていること

入力

パラメーター	型	必須	デフォルト	備考
startUrls	array	任意	[]	TikTok の URL — ユーザープロフィール、ハッシュタグ、音楽ページ、検索、場所
keywords	array	任意	[]	投稿を検索するキーワード／検索語
sortType	string	任意	RELEVANCE	キーワード検索結果の並べ替え順：RELEVANCE、MOST_LIKED、DATE_POSTED
location	string	任意	—	地域で絞り込むための ISO 3166-1 alpha-2 国コード（例：US、GB）
maxItems	number	任意	無制限	実行全体で返す投稿の最大数
includeSearchKeywords	boolean	任意	false	各投稿に一致した検索キーワードのフィールドを追加します
customMapFunction	string	任意	—	各出力オブジェクトを変換する JavaScript 関数

ワークフロー

Progress:
- [ ] Step 1: Define hashtags to analyze
- [ ] Step 2: Run tiktok-scraper for each hashtag
- [ ] Step 3: Calculate hashtag-level metrics
- [ ] Step 4: Identify top content and creators
- [ ] Step 5: Deliver strategy recommendations

ステップ 1：パラメーターを確認する

ユーザーに以下を尋ねます：

• 分析するハッシュタグ — 最大 10 個（# は付けない）
• ハッシュタグごとの投稿数（デフォルト：30 — 信頼性の高い統計に十分な数です）
• 目的 — 投稿に使うハッシュタグの選定、競合他社のハッシュタグ戦略の監査、または一般的な調査

ユーザーがまだハッシュタグを提示しておらず、おすすめを求めている場合は、以下を尋ねます：

• コンテンツのニッチ分野（例：「フィットネス」「料理」「個人向けファイナンス」）
• 次に、以下を組み合わせて生成します：メガハッシュタグ（1 億回以上の再生）2 個、中規模（1,000 万～1 億回）3 個、ニッチ（100 万～1,000 万回）3 個、マイクロ（100 万回未満）2 個

ステップ 2：ハッシュタグごとに Actor を実行する

推奨 — run_actor.js（待機、出力、ファイル保存を自動で処理します）：

# Quick answer (prints table to chat)
node scripts/run_actor.js \
  --actor "apidojo~tiktok-scraper" \
  --input '{"param": "value"}'

# Save as CSV
node scripts/run_actor.js \
  --actor "apidojo~tiktok-scraper" \
  --input '{"param": "value"}' \
  --output YYYY-MM-DD_results.csv --format csv

# Save as JSON
node scripts/run_actor.js \
  --actor "apidojo~tiktok-scraper" \
  --input '{"param": "value"}' \
  --output YYYY-MM-DD_results.json --format json

APIFY_TOKEN は環境または .env ファイルに設定する必要があります。

Apify MCP が利用可能な場合：

Tool: apify:run-actor
Actor: "apidojo~tiktok-scraper"
Input:
{
  "keywords": ["[hashtag1]", "[hashtag2]", "[hashtag3]"],
  "shouldDownloadCovers": false
}

REST API による代替方法：

curl -X POST \
  "https://api.apify.com/v2/acts/apidojo~tiktok-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "keywords": ["[hashtag1]", "[hashtag2]", "[hashtag3]"]
  }'

SUCCEEDED になるまで待ちます。データセットを取得します。

ステップ 3：ハッシュタグの指標を計算する

各ハッシュタグについて、動画の結果から以下を算出します：

total_views_sampled = sum(video.playCount)
avg_views_per_video = total_views_sampled / num_videos
avg_likes_per_video = sum(video.diggCount) / num_videos
avg_comments_per_video = sum(video.commentCount) / num_videos
engagement_rate = (avg_likes + avg_comments) / avg_views * 100
competition_level = num_videos_per_day (estimate from timestamps)

利用可能な場合は、challengeInfo.stats.videoCount をハッシュタグの規模を示す指標として使用します。

ステップ 4：人気のコンテンツとクリエイターを特定する

各ハッシュタグについて、以下を提示します：

• 再生回数上位 3 本の動画（クリエイターのハンドル名と動画 URL を含む）
• ハッシュタグの人気コンテンツに頻繁に登場する上位 3 人のクリエイター
• 人気動画に共通するコンテンツ形式（説明文／キャプションに基づく）

ステップ 5：出力を整形する

出力形式

# TikTok Hashtag Performance Analysis
Hashtags analyzed: [N] | Posts sampled per hashtag: [30] | Date: [DATE]

## Hashtag Comparison Table

| Hashtag | Avg Views | Avg Likes | Eng. Rate | Competition | Verdict |
|---------|-----------|-----------|-----------|-------------|---------|
| #[name] | [N]       | [N]       | [X.X%]    | [Low/Med/High] | [Use / Test / Avoid] |

## Detailed Breakdown

### #[hashtag1]
- Avg views per post: [N]
- Engagement rate: [X.X%]
- Competition level: [Low / Medium / High] — approx [N] new posts/day
- Top video: "[creator]" — [N] views | [url]
- Dominant content format: [e.g., tutorial, reaction, storytelling]
- **Recommendation:** [Use as primary / Layer with broader tags / Avoid — too saturated]

### #[hashtag2]
[same structure]

## Recommended Hashtag Strategy
For maximum reach on [CONTENT NICHE], use this combination:
- Primary (1-2 hashtags): [#hashtag] — broad reach driver
- Secondary (2-3 hashtags): [#hashtag] — niche relevance
- Micro (1-2 hashtags): [#hashtag] — community engagement

## Top Creators in These Hashtags
[Creators who appear most in top-performing content across all analyzed hashtags]
1. @[handle] — [N] top videos found | [N] followers

トラブルシューティング

再生回数が極端に少ない： ハッシュタグのスペルが間違っているか、作られたばかりの可能性があります。スペルを確認し、別の表記も試してください。 結果がすべて同じように見える： メガハッシュタグ（#fyp、#foryou）では、オーガニックなコンテンツではなく、アルゴリズムによっておすすめされたコンテンツが表示されます。より有益な傾向を把握するには、ニッチなハッシュタグを使用してください。 エンゲージメント率が高すぎる、または低すぎるように見える： エンゲージメント率はコンテンツの種類によって大きく異なります。公平に比較するには、同じコンテンツ形式の中で比較してください。