tiktok-creative-center/
creator-cards

Creator Marketplace IDを最大20件指定して、TikTok Creator Marketplaceのクリエイターカードを取得できます。フォロワーの年齢・性別・国・端末の割合、再生数の中央値、エンゲージメント率、開始料金が含まれます。

TikTok Creator Marketplace API

最大20クリエイター
オーディエンスの属性
開始料金
結果1件あたり0.5クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

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を集め、そのカードを読み取ります。

  1. TikTok Creative Center Top Videos を実行し、評価したいクリエイターの creator_id をコピーします。
  2. {"creator_ids": ["7011198409688219653", "7070293872819044358"]} を /v1/tiktok-creative-center/creator-cards に POST します。
  3. 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 とあわせて読み、クリエイターの提示する出発点の金額として扱ってください。最終的な料金は案件ごとに決まります。

TikTok Creator Marketplace API 以外に別の種類の公開TikTok Creative Centerデータが必要な場合は、これらのAPIをご利用ください。

他のプラットフォームを見る

TikTok Creative Centerのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

TikTok Creator Marketplace API — よくある質問

TikTok Creator Marketplace APIは、Creator Marketplace IDを指定して、最大20人のクリエイターのTikTok Creator Marketplaceカードを取得するためのプログラムインターフェースです。フォロワーの年齢・性別・国・端末の内訳、再生数の中央値、エンゲージメント率と成長率、開始料金、クリエイターの情報を返します。

Top Videos の行に creator_id として返るCreator Marketplace IDで、5〜32桁の数字です。通常のTikTokユーザーIDではカードを特定できず、それ以外の形式は400エラーで拒否されます。

TikTokのCreator Marketplaceに参加してプロフィールを設定しているクリエイターです。年齢やフォロワー数のしきい値など、参加条件はTikTokが決めていて、案件によっても異なります。カードのないIDはスキップされ、課金されません。すべてのIDがスキップされた場合はタスクが失敗し、クレジットは返却されます。返されたカードは1枚につき0.5クレジットです。

クリエイターのフォロワーの4つの切り口で、18-24 や 55+ のようなラベルの年齢層、性別、国、スマートフォンのブランドがあり、各項目に0〜1の割合が付きます。国には country_code とサンプルのフォロワー数も入ります。

starting_price には、クリエイターがスポンサー動画の開始価格として掲載している金額と通貨が入ります。これは出発点の金額で、開始料金はクリエイター自身が設定し、最終的な価格は案件ごとに決まります。

できません。照会はCreator Marketplace IDで行います。候補は TikTok Creative Center Top Videos から探してください。チャートの全行に creator_id が付いています。

TikTok側では不要です。照会はSocQのAPIキーだけで実行でき、ブランドアカウントやパートナー承認は関係しません。