TikTok Creator Marketplace
TikTok Creator Marketplaceのカードは、ブランドが有料案件でクリエイターを検討するときに見るプロフィールで、プロフィール文とフォロワー数に加え、フォロワーの年齢・性別・国・端末の構成、再生数の中央値、エンゲージメント率と成長率、スポンサー動画の開始料金がまとめられています。このカードがあれば、ブランドは1つの画面で、オーディエンスの適合度、標準的な成果、価格を比べてクリエイターを選べます。
TikTok Creator Marketplace API の主な機能
- 4つの切り口のオーディエンスaudience はフォロワーを年齢層、性別、国、スマートフォンのブランドで分け、各項目は0〜1の割合です。
- 成果のベンチマークmetrics には followers_count、median_views、engagement_rate、followers_growth_rate、six_second_view_rate が入ります。
- 掲載されている開始料金starting_price は、クリエイターがスポンサー動画に掲載している金額と通貨を、計算に使える数値で返します。
- 1リクエストで最大20クリエイターcreator_ids に1〜20個のCreator Marketplace IDを指定すると、カードのあるクリエイターごとに1枚ずつ返ります。
- 全カードに本人情報username、name、プロフィール文の text、avatar_url、region、tiktok_user_id、url、recent_video_ids により、Marketplace IDを実在のアカウントに結びつけられます。
TikTok Creator Marketplace API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
creator_ids | 必須 | Creator Marketplace IDを1〜20個指定します(TikTok Creative Center Top Videos の結果にある creator_id の値など)。 |
TikTok Creator Marketplace API の使い方
Top VideosからクリエイターIDを集め、そのカードを読み取ります。
- TikTok Creative Center Top Videos を実行し、評価したいクリエイターの creator_id をコピーします。
- {"creator_ids": ["7011198409688219653", "7070293872819044358"]} を /v1/tiktok-creative-center/creator-cards に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングし、results.items からクリエイターごとに1枚のカードを読み取ります。
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/creator-cards" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"creator_ids":["7011198409688219653","7070293872819044358"]}'
# audience.ages, genders, countries and devices are shares from 0 to 1.TikTok Creator Marketplace API の主なユースケース
- オーディエンス適合度のスクリーニング: 候補の audience.ages、genders、countries を、届けたい顧客像と比べ、フォロワーが合わない市場にいるクリエイターを外します。
- 再生単価の比較: フォロワー数ではなく、starting_price.amount を median_views で割って、各クリエイターの掲載料金で何が買えるかを比べます。
- 勢いのランキング: 候補を engagement_rate と followers_growth_rate で並べ替え、反応がよく、なおフォロワーが増えているクリエイターを見つけます。
TikTok Creator Marketplace API 活用のヒント
- IDは Top Videos の行の creator_id フィールドから取ってください。author.id のようなTikTokユーザーIDはカードに一致せず、スキップされます。
- 各オーディエンスの切り口は、合計が1よりわずかに小さくなることがある割合のリストとして扱い、位置ではなくラベルで項目を突き合わせてください。
- starting_price.amount は currency とあわせて読み、クリエイターの提示する出発点の金額として扱ってください。最終的な料金は案件ごとに決まります。
関連API
TikTok Creator Marketplace API 以外に別の種類の公開TikTok Creative Centerデータが必要な場合は、これらのAPIをご利用ください。
- TikTok Creative Center Top Ads API — 成果の高い広告をキーワードと期間で閲覧し、キャプション、CTR、いいね数、広告動画を返します。
- TikTok Creative Center Ad Analysis API — トップ広告1件を、クリックスルーと視聴維持率のカーブで1秒ごとに分析します。
- TikTok Creative Center Trending Hashtags API — 国別のトレンドハッシュタグのランキングを、投稿数、再生数、人気度カーブとともに取得します。
- TikTok Creative Center Hashtag Insights API — トレンドハッシュタグ1つについて、人気度カーブ、上位の国、サンプル動画を詳しく調べます。
- TikTok Creative Center Top Videos API — 国別の成果の高い動画のチャートを、再生数とエンゲージメント率とともに取得します。