EveryData · クリエイターインテリジェンス

Douyin Creator Intelligenceクリエイターを探す。成果を把握する。商品を調べる。

クリエイターの検索、プロフィールや投稿の確認、オーディエンス情報とXingtuの指標の比較、商品の調査を、個別のAPIで行えます。

タスク別にAPIを選ぶ

タスクごとに取得できるデータ、料金、パラメータを確認できます。

クリエイタープロフィール

1,000リクエストあたり$0.56
profile

公開されているアバター、Douyin ID、表示名、自己紹介、アカウントの各種集計値を取得します。

必須パラメータ: DouyinユーザーのsecUid文字列(通常はMS4wで始まります)で、ニックネームや短い数字のDouyin IDではありません。profileおよびuser_postsアクションでアカウントを特定するために使用します。検索結果のauthor_idフィールド、またはユーザープロフィールのURLから取得できます。 · 単一オブジェクト

レスポンスフィールドを表示 (24)

任意パラメータ: —

  • user_id
  • douyin_id
  • nickname
  • bio
  • url
  • follower_count
  • following_count
  • like_count
  • video_count
  • gender
  • ip_location
  • is_verified
  • avatar_url
  • uid
  • background_image_url
  • country
  • language
  • is_live
  • likes_given_count
  • has_shop
  • age
  • has_series
  • platform
  • verify_reason
APIを表示

公開投稿とエンゲージメント

1,000リクエストあたり$0.56
user_posts

公開投稿、投稿日時、エンゲージメント(いいね、コメント、シェア)を取得します。Douyinは再生数を公開していないため、playフィールドは常に0です。これは視聴者がいないことを意味するものではありません。人気度はエンゲージメントで判断してください。

必須パラメータ: DouyinユーザーのsecUid文字列(通常はMS4wで始まります)で、ニックネームや短い数字のDouyin IDではありません。profileおよびuser_postsアクションでアカウントを特定するために使用します。検索結果のauthor_idフィールド、またはユーザープロフィールのURLから取得できます。 · 1回あたりの最大件数 100 件

レスポンスフィールドを表示 (55)

任意パラメータ: user_postsのページトークンです。空の文字列page_token=""を送ると最新のページから始まり、その後は各レスポンスのnext_page_tokenを受け取ったとおりに渡します。他のパラメータは変えないでください。トークンの有効期間は24時間で、同じアカウントかつ同じパラメータでのみ使えます。最終ページにはnext_page_tokenがありません。各ページは新しい順に最大100件を含み、sinceの下限は適用されません。期間で絞る必要がある場合は、posted_atを使って自分の側で絞り込んでください。各ページは1回の呼び出しです。, profileおよびuser_postsアクションで、動画の公開日の下限をYYYY-MM-DD形式で指定します。アカウントの作成日ではなく、リクエストで取得する動画を絞り込みます。このパラメータを省略すると、日付による絞り込みは行われません。

  • next_page_token
  • id
  • url
  • text
  • media_type
  • video_url
  • like_count
  • comment_count
  • share_count
  • collect_count
  • view_count
  • author_name
  • author_id
  • author_douyin_id
  • author_uid
  • author_bio
  • author_avatar_url
  • author_follower_count
  • cover_image_url
  • video_width
  • video_height
  • duration_seconds
  • region
  • hashtags
  • posted_at
  • platform
  • image_urls
  • duration_sec
  • hashtag_ids
  • search_rank
  • author_is_verified
  • author_following_count
  • author_like_count
  • author_video_count
  • author_ip_location
  • title
  • music
  • download_count
  • forward_count
  • is_pinned
  • is_ad
  • video_tags
  • video_resolution
  • animated_cover_url
  • city
  • city_code
  • location
  • text_language
  • video_bitrates
  • download_url
  • has_watermark
  • video_url_expires_at
  • permissions
  • author_gender
  • author_age
APIを表示

クリエイター検索

1,000リクエストあたり$0.56
creator_search

キーワードでアカウントを検索し、対応しているフィルターを適用できます。

必須パラメータ: アカウント検索に使うクリエイターのニックネーム、Douyin ID、または関連する検索フレーズです。動画のsearchアクションは実行されず、本人との完全一致も保証されません。 · 1回あたりの最大件数 20 件

レスポンスフィールドを表示 (13)

任意パラメータ: creator_searchをアカウントのフォロワー数の範囲で絞り込みます。under_1k、1k_to_10k、10k_to_100k、100k_to_1m、over_1mのいずれかを指定します。省略すると範囲は制限されません。, creator_searchをアカウント区分で絞り込みます:general、business、verified_individual。購入者のカテゴリや法的な身元の証明ではありません。

  • user_id
  • douyin_id
  • nickname
  • url
  • avatar_url
  • follower_count
  • gender
  • is_verified
  • verify_reason
  • is_live
  • uid
  • source_keyword
  • platform
APIを表示

フォロワーとオーディエンスの分布

1,000リクエストあたり$0.56
creator_audience

分布は1回のリクエストにつき1種類(性別、年齢、省、端末価格帯)を指定します。

必須パラメータ: DouyinクリエイターのsecUidで、通常はMS4wで始まります。オーディエンス分布やTGIシグナルのうち、利用可能なデータを取得するために使用します。ニックネーム、短いDouyin ID、購入者の識別子ではなく、クリエイター検索で返されたuser_idを使用してください。 · 単一オブジェクト

レスポンスフィールドを表示 (5)

任意パラメータ: creator_audienceで表示するフォロワー属性の軸を選択します:device_price_band(デフォルト)、gender、age、province。分布の値はパーセントではなく、0〜1の割合をそのまま小数で表したものです。TGIは別の指数として扱われます。このパラメータで個々のフォロワーのレコードや購入者データを取得することはできません。

  • user_id
  • audience_distribution
  • audience_tgi
  • dimension_code
  • platform
APIを表示

フォロワー推移

1,000リクエストあたり$0.56
creator_trend

取得可能なフォロワーの増減とトレンドの平均値を確認できます。

必須パラメータ: DouyinクリエイターのsecUidで、通常はMS4wで始まります。利用可能なフォロワー推移データを取得するために使用します。ニックネームや短い数値のDouyin IDではありません。 · 単一オブジェクト

レスポンスフィールドを表示 (5)

任意パラメータ: —

  • user_id
  • follower_trend
  • average_follower_count
  • dimension_code
  • platform
APIを表示

類似クリエイターとの比較

1,000リクエストあたり$0.56
creator_benchmark

期間平均とパーセンタイルを比較します。

必須パラメータ: DouyinクリエイターのsecUidで、通常はMS4wで始まります。利用可能なアカウントの平均値とパーセンタイルを取得するために使用します。ニックネームや短い数値のDouyin IDではありません。 · 単一オブジェクト

レスポンスフィールドを表示 (12)

任意パラメータ: —

  • user_id
  • average_post_count
  • average_comment_count
  • average_share_count
  • average_follower_growth
  • average_like_count
  • post_count_percentile
  • comment_count_percentile
  • share_count_percentile
  • follower_growth_percentile
  • like_count_percentile
  • platform
APIを表示

Xingtuクリエイター検索

1,000リクエストあたり$0.56
xingtu_creator_search

商業指数、30日間のレンジ、見積額を確認できます。Xingtuの詳細な照会にはdouyin_idを使用します。

必須パラメータ: xingtu_creator_search用のクリエイター検索フレーズです。返されるcreator_idは、このXingtu検索結果内のレコードの識別と比較に使います。xingtu_creator_analyticsやxingtu_rate_cardでは受け付けられず、これらには通常のcreator_searchが返すdouyin_idが必要です。商品キーワードや動画検索ではありません。 · 1回あたりの最大件数 20 件

レスポンスフィールドを表示 (29)

任意パラメータ: —

  • creator_id
  • user_id
  • nickname
  • follower_count
  • gender
  • city
  • province
  • creator_score
  • engagement_rate_30d
  • expected_play_count
  • expected_natural_play_count
  • interaction_median_30d
  • play_over_rate_30d
  • follower_growth_30d
  • follower_growth_rate_15d
  • content_themes
  • ecommerce_level
  • ecommerce_score
  • gmv_30d_range
  • gpm_30d_range
  • average_order_value_30d_range
  • commercial_index
  • conversion_index
  • spread_index
  • shopping_index
  • quote_1_20s_cny
  • quote_20_60s_cny
  • quote_60s_plus_cny
  • platform
APIを表示

Xingtuクリエイター分析

1,000リクエストあたり$0.56
xingtu_creator_analytics

douyin_idのカテゴリ、テーマ、公開されているパフォーマンス指標を確認できます。

必須パラメータ: 通常のcreator_searchアクションが返す、表示用のDouyinアカウントID(unique_id)で、xingtu_creator_analyticsとxingtu_rate_cardで必須です。xingtu_creator_searchはこの値を返しません。user_id(secUid)、Xingtuのcreator_id、ニックネームとは異なります。 · 単一オブジェクト

レスポンスフィールドを表示 (15)

任意パラメータ: —

  • creator_id
  • creator_type
  • follower_count
  • average_play_count
  • city
  • province
  • gender
  • category_id
  • content_themes
  • tags
  • creator_grade
  • is_xingtu_creator
  • ecommerce_enabled
  • lowest_quote_cny
  • platform
APIを表示

Xingtu料金表

1,000リクエストあたり$0.56
xingtu_rate_card

動画の長さ別に分類された料金区分を確認できます。

必須パラメータ: 通常のcreator_searchアクションが返す、表示用のDouyinアカウントID(unique_id)で、xingtu_creator_analyticsとxingtu_rate_cardで必須です。xingtu_creator_searchはこの値を返しません。user_id(secUid)、Xingtuのcreator_id、ニックネームとは異なります。 · 単一オブジェクト

レスポンスフィールドを表示 (3)

任意パラメータ: —

  • creator_id
  • rate_tiers
  • platform
APIを表示

Xingtuクリエイターランキング

1,000リクエストあたり$0.56
xingtu_creator_rankings

業種、ランキング、期間を選ぶと、ランキングのスコアと範囲を確認できます。

必須パラメータ: Xingtuクリエイターランキングの業種を選びます。apparel_accessories、automotive、beauty、electronics、food_beverage、household_goods、mother_baby_petsのいずれかです。これはランキングのフィルターで、クリエイターが付けたタグではありません。, Xingtuのランキングを選びます。all_top、head_tier、paid_ad_performers、rising_stars、sales_champions、top_creators、viral_driversのいずれかです。ランキング名によって、順位が予測や結果の保証になるわけではありません。, Xingtuのランキングのスナップショットを選択します:latest_weekly、latest_monthly、all_history_weekly、all_history_monthly。返されるランキングの対象範囲を決めるもので、任意の日付範囲は指定できません。 · 1回あたりの最大件数 5 件

レスポンスフィールドを表示 (28)

任意パラメータ: —

  • creator_id
  • user_id
  • url
  • nickname
  • avatar_url
  • gender
  • city
  • province
  • follower_count
  • cpm_cny
  • completed_order_range
  • repurchase_rate_range
  • item_order_rate
  • average_view_count
  • industry
  • rank
  • previous_rank
  • ranking_score
  • is_new
  • ranking_board
  • period_days
  • snapshot_date
  • industry_tags
  • primary_tag
  • industry_id
  • top_videos
  • source_kind
  • platform
APIを表示

クリエイターとは独立した商品検索

1,000リクエストあたり$13.33
product_search

キーワードで商品、ショップ、30日間の売上、コミッションデータを検索します。

必須パラメータ: Douyinの商品検索キーワードです。検索結果は独立した商品プールであり、指定したクリエイターがその商品を宣伝または販売したことを示すものではありません。 · 1回あたりの最大件数 5 件

レスポンスフィールドを表示 (27)

任意パラメータ: —

  • product_id
  • promotion_id
  • title
  • url
  • image_url
  • white_image_url
  • price_cny
  • price_cny_minor
  • price_label
  • monthly_sales
  • good_review_ratio
  • sales_trend
  • category_path
  • category_ids
  • category_depth
  • shop_id
  • shop_name
  • shop_logo_url
  • shop_score
  • commission_rate_percent
  • commission_cny
  • cooperating_creator_count
  • tags
  • source_keyword
  • search_rank
  • recommend_reason
  • platform
APIを表示

商品詳細と画像ギャラリー

1,000リクエストあたり$13.33
product_detail

数値のproduct_idを指定して、1つの商品の画像カルーセル、詳細画像、バリエーション、ショップ、公開されている販売数のスナップショットを取得します。

必須パラメータ: product_searchまたはlive_product_searchが返す数値のDouyin商品IDです。SKU ID、プロモーションID、タイトル、URLではありません。 · 単一オブジェクト

レスポンスフィールドを表示 (18)

任意パラメータ: —

  • product_id
  • title
  • price_cny
  • discount_price_cny
  • sales_text
  • sold_count
  • shop_id
  • shop_name
  • shop_avatar_url
  • image_url
  • main_image_urls
  • detail_image_urls
  • assurances
  • shipping_fee_text
  • shipping_estimate_text
  • variant_groups
  • on_sale
  • platform
APIを表示

配信中のライブ商品検索

1,000リクエストあたり$0.56
live_product_search

キーワードで配信中のライブ商品とそのlive_room_idを検索します。

必須パラメータ: Douyin Mallの商品検索キーワードです。リクエスト時点でライブタグとライブルームIDが付いている商品のみが返されます。検索結果は、特定のクリエイターがライブ配信で販売した商品の記録ではありません。 · 1回あたりの最大件数 3 件

レスポンスフィールドを表示 (10)

任意パラメータ: —

  • product_id
  • sku_id
  • title
  • image_url
  • price_cny
  • shop_id
  • live_room_id
  • is_live_product
  • source_keyword
  • platform
APIを表示

各アクションにはカタログ記載の料金と課金ルールが適用されます。商品の金額は元の通貨のまま返されます。

データの対応範囲

全27種類の対象データについて、提供状況と範囲を確認できます。

データに関する注意事項

クリエイター、Xingtu、商品の結果はそれぞれ別のビューです。クリエイターと商品の過去の紐付け、正確なGMVやROI、取引における購入者のプロフィールは含まれません。

直接取得一部対応取得不可

クリエイター詳細

Avatar

直接取得

公開されているアバターのURLを返します。

Douyin ID

直接取得

内部ユーザーIDやXingtuクリエイターIDとは区別して扱います。

表示名とプロフィール文

直接取得

公開されている表示名とプロフィール文を返します。

フォロワー数、いいね数、投稿数

直接取得

アカウントで公開されている各合計値を返します。

オーディエンス

性別

直接取得

フォロワーまたはオーディエンスの分布を返します。

年齢

直接取得

返される年齢層ごとに表示します。

地域

直接取得

現在返される省単位のグループごとに表示します。

デバイス、興味・関心、関連アカウント

一部対応

デバイスの価格帯に対応しています。興味・関心と関連アカウントは現在取得できません。

販売実績

過去にプロモーションした商品

取得不可

クリエイターと商品の過去の紐付けは取得できません。

過去にプロモーションしたカテゴリ

取得不可

過去にプロモーションしたカテゴリのデータは取得できません。

クリエイターの平均注文単価

一部対応

30日間のレンジのみを保持しており、確定済みの正確な平均注文単価ではありません。

カテゴリの平均注文単価

取得不可

クリエイターのカテゴリ別精算データは取得できません。

コマース実績

30日間のEC GMV

一部対応

正確な金額ではなく、取得元が提供する金額帯を返します。

コンバージョンとROI

一部対応

関連する指数とレンジを返します。注文単位のROIは取得できません。

商品情報

メイン画像、白背景画像、ギャラリー画像

直接取得

商品検索ではメイン画像と白背景画像を、商品詳細では画像カルーセルと縦長の詳細画像を返します。画像の枚数は商品によって異なります。

商品URLとID

直接取得

商品検索結果からIDとリンクを返します。

商品名と価格

直接取得

表示されている商品価格を返します。SKUごとの価格は含まれない場合があります。

4階層のカテゴリパス

一部対応

取得可能な階層までカテゴリを返します。検証したサンプルでは3階層でした。

ブランド

取得不可

構造化されたブランドフィールドは取得できません。

販売数

直接取得

30日間の販売数の推移と、収集時点で公開されている販売数のスナップショットを返します。

売上またはGMV

取得不可

商品の売上またはGMVのフィールドは取得できません。

ショップ、評価、コミッション

直接取得

取得可能な場合は、ショップ、評価、コミッション、提携クリエイターのフィールドを返します。

購入者プロフィール

購入者の性別

取得不可

取引を行った購入者の性別は取得できません。

購入者の年齢

取得不可

取引を行った購入者について、信頼できるデータはありません。

購入者の所在地

取得不可

取引を行った購入者について、信頼できるデータはありません。

ライブコマース

現在配信中のライブルームの商品

一部対応

キーワードで現在ライブ配信中の商品を検索し、live_room_id を返します。指定したクリエイターの全商品を一覧で返すものではありません。

データの紐付け

クリエイターと商品の過去の紐付け

取得不可

クリエイターと商品の過去の紐付けデータは取得できません。

API呼び出し

platform=douyin と選択したアクションを指定して POST /api/v1/social を呼び出してください。パラメータとレスポンスフィールドはAPIカードで確認できます。

douyin_creator.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"douyin","action":"product_search","params":{"keyword":"口紅","limit":5}}'

商品検索リクエストの例

呼び出しのヒント

  • Xingtuランキング、単独商品検索、現在のライブ商品検索には、それぞれ個別の件数上限があります。異なる呼び出しの結果を合算した件数に、1回あたりの上限を適用しないでください。
  • 商品詳細は、1回の呼び出しにつき数値の product_id を1つ受け付けます。SKU ID、プロモーションID、タイトルではなく、商品検索または現在のライブ商品検索で返されたIDを使用してください。
  • 現在のライブ商品検索では、現在配信中のライブで扱われている商品だけが対象です。キーワードと、カタログでサポートされている limit を送信してください。指定したクリエイターで絞り込むための公開パラメータはありません。
  • user_id、douyin_id、Xingtuのcreator_idは、それぞれ異なる識別子です。選択したアクションで必要な識別子を正確に使用してください。
  • 各アクションで必要な識別子を使用してください。最新のフィールド、提供状況、課金ルールはマーケットプレイスで確認してください。

自社の訪問統計は常に有効です。Google Analyticsは「アナリティクスを許可」を選んだ場合にのみ読み込まれます。 プライバシーポリシー