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

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

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

Douyinクリエイターワークスペースを開く →すべてのAPIを見る

タスク別にAPIを選ぶ

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

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

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

profile

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

必須パラメータ: user_id · 単一オブジェクト

レスポンスフィールドを表示 (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です。これは視聴者がいないことを意味するものではありません。人気度はエンゲージメントで判断してください。

必須パラメータ: user_id · 1回あたりの最大件数 100 件

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

任意パラメータ: page_token, since

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

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

必須パラメータ: keyword · 1回あたりの最大件数 20 件

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

任意パラメータ: follower_range, user_type

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種類（性別、年齢、省、端末価格帯）を指定します。

必須パラメータ: user_id · 単一オブジェクト

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

任意パラメータ: dimension

user_id
audience_distribution
audience_tgi
dimension_code
platform

APIを表示

フォロワー推移

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

creator_trend

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

必須パラメータ: user_id · 単一オブジェクト

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

任意パラメータ: —

user_id
follower_trend
average_follower_count
dimension_code
platform

APIを表示

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

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

creator_benchmark

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

必須パラメータ: user_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を使用します。

必須パラメータ: keyword · 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のカテゴリ、テーマ、公開されているパフォーマンス指標を確認できます。

必須パラメータ: douyin_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

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

必須パラメータ: douyin_id · 単一オブジェクト

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

任意パラメータ: —

creator_id
rate_tiers
platform

APIを表示

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

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

xingtu_creator_rankings

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

必須パラメータ: industry, ranking_type, time_window · 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日間の売上、コミッションデータを検索します。

必須パラメータ: keyword · 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_id · 単一オブジェクト

レスポンスフィールドを表示 (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を検索します。

必須パラメータ: keyword · 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種類の対象データについて、提供状況と範囲を確認できます。

取得不可

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

グループ	対象データ	現在の状況	確認範囲
クリエイター詳細	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は、それぞれ異なる識別子です。選択したアクションで必要な識別子を正確に使用してください。
各アクションで必要な識別子を使用してください。最新のフィールド、提供状況、課金ルールはマーケットプレイスで確認してください。

Douyinクリエイターワークスペースを開くドキュメント