クリエイタープロフィール
1,000リクエストあたり$0.56profile公開されているアバター、Douyin ID、表示名、自己紹介、アカウントの各種集計値を取得します。
必須パラメータ: DouyinユーザーのsecUid文字列(通常はMS4wで始まります)で、ニックネームや短い数字のDouyin IDではありません。profileおよびuser_postsアクションでアカウントを特定するために使用します。検索結果のauthor_idフィールド、またはユーザープロフィールのURLから取得できます。 · 単一オブジェクト
レスポンスフィールドを表示 (24)
任意パラメータ: —
user_iddouyin_idnicknamebiourlfollower_countfollowing_countlike_countvideo_countgenderip_locationis_verifiedavatar_urluidbackground_image_urlcountrylanguageis_livelikes_given_counthas_shopagehas_seriesplatformverify_reason
APIを表示公開投稿とエンゲージメント
1,000リクエストあたり$0.56user_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_tokenidurltextmedia_typevideo_urllike_countcomment_countshare_countcollect_countview_countauthor_nameauthor_idauthor_douyin_idauthor_uidauthor_bioauthor_avatar_urlauthor_follower_countcover_image_urlvideo_widthvideo_heightduration_secondsregionhashtagsposted_atplatformimage_urlsduration_sechashtag_idssearch_rankauthor_is_verifiedauthor_following_countauthor_like_countauthor_video_countauthor_ip_locationtitlemusicdownload_countforward_countis_pinnedis_advideo_tagsvideo_resolutionanimated_cover_urlcitycity_codelocationtext_languagevideo_bitratesdownload_urlhas_watermarkvideo_url_expires_atpermissionsauthor_genderauthor_age
APIを表示クリエイター検索
1,000リクエストあたり$0.56creator_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_iddouyin_idnicknameurlavatar_urlfollower_countgenderis_verifiedverify_reasonis_liveuidsource_keywordplatform
APIを表示フォロワーとオーディエンスの分布
1,000リクエストあたり$0.56creator_audience分布は1回のリクエストにつき1種類(性別、年齢、省、端末価格帯)を指定します。
必須パラメータ: DouyinクリエイターのsecUidで、通常はMS4wで始まります。オーディエンス分布やTGIシグナルのうち、利用可能なデータを取得するために使用します。ニックネーム、短いDouyin ID、購入者の識別子ではなく、クリエイター検索で返されたuser_idを使用してください。 · 単一オブジェクト
レスポンスフィールドを表示 (5)
任意パラメータ: creator_audienceで表示するフォロワー属性の軸を選択します:device_price_band(デフォルト)、gender、age、province。分布の値はパーセントではなく、0〜1の割合をそのまま小数で表したものです。TGIは別の指数として扱われます。このパラメータで個々のフォロワーのレコードや購入者データを取得することはできません。
user_idaudience_distributionaudience_tgidimension_codeplatform
APIを表示フォロワー推移
1,000リクエストあたり$0.56creator_trend取得可能なフォロワーの増減とトレンドの平均値を確認できます。
必須パラメータ: DouyinクリエイターのsecUidで、通常はMS4wで始まります。利用可能なフォロワー推移データを取得するために使用します。ニックネームや短い数値のDouyin IDではありません。 · 単一オブジェクト
レスポンスフィールドを表示 (5)
任意パラメータ: —
user_idfollower_trendaverage_follower_countdimension_codeplatform
APIを表示類似クリエイターとの比較
1,000リクエストあたり$0.56creator_benchmark期間平均とパーセンタイルを比較します。
必須パラメータ: DouyinクリエイターのsecUidで、通常はMS4wで始まります。利用可能なアカウントの平均値とパーセンタイルを取得するために使用します。ニックネームや短い数値のDouyin IDではありません。 · 単一オブジェクト
レスポンスフィールドを表示 (12)
任意パラメータ: —
user_idaverage_post_countaverage_comment_countaverage_share_countaverage_follower_growthaverage_like_countpost_count_percentilecomment_count_percentileshare_count_percentilefollower_growth_percentilelike_count_percentileplatform
APIを表示Xingtuクリエイター検索
1,000リクエストあたり$0.56xingtu_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_iduser_idnicknamefollower_countgendercityprovincecreator_scoreengagement_rate_30dexpected_play_countexpected_natural_play_countinteraction_median_30dplay_over_rate_30dfollower_growth_30dfollower_growth_rate_15dcontent_themesecommerce_levelecommerce_scoregmv_30d_rangegpm_30d_rangeaverage_order_value_30d_rangecommercial_indexconversion_indexspread_indexshopping_indexquote_1_20s_cnyquote_20_60s_cnyquote_60s_plus_cnyplatform
APIを表示Xingtuクリエイター分析
1,000リクエストあたり$0.56xingtu_creator_analyticsdouyin_idのカテゴリ、テーマ、公開されているパフォーマンス指標を確認できます。
必須パラメータ: 通常のcreator_searchアクションが返す、表示用のDouyinアカウントID(unique_id)で、xingtu_creator_analyticsとxingtu_rate_cardで必須です。xingtu_creator_searchはこの値を返しません。user_id(secUid)、Xingtuのcreator_id、ニックネームとは異なります。 · 単一オブジェクト
レスポンスフィールドを表示 (15)
任意パラメータ: —
creator_idcreator_typefollower_countaverage_play_countcityprovincegendercategory_idcontent_themestagscreator_gradeis_xingtu_creatorecommerce_enabledlowest_quote_cnyplatform
APIを表示Xingtu料金表
1,000リクエストあたり$0.56xingtu_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_idrate_tiersplatform
APIを表示Xingtuクリエイターランキング
1,000リクエストあたり$0.56xingtu_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_iduser_idurlnicknameavatar_urlgendercityprovincefollower_countcpm_cnycompleted_order_rangerepurchase_rate_rangeitem_order_rateaverage_view_countindustryrankprevious_rankranking_scoreis_newranking_boardperiod_dayssnapshot_dateindustry_tagsprimary_tagindustry_idtop_videossource_kindplatform
APIを表示クリエイターとは独立した商品検索
1,000リクエストあたり$13.33product_searchキーワードで商品、ショップ、30日間の売上、コミッションデータを検索します。
必須パラメータ: Douyinの商品検索キーワードです。検索結果は独立した商品プールであり、指定したクリエイターがその商品を宣伝または販売したことを示すものではありません。 · 1回あたりの最大件数 5 件
レスポンスフィールドを表示 (27)
任意パラメータ: —
product_idpromotion_idtitleurlimage_urlwhite_image_urlprice_cnyprice_cny_minorprice_labelmonthly_salesgood_review_ratiosales_trendcategory_pathcategory_idscategory_depthshop_idshop_nameshop_logo_urlshop_scorecommission_rate_percentcommission_cnycooperating_creator_counttagssource_keywordsearch_rankrecommend_reasonplatform
APIを表示商品詳細と画像ギャラリー
1,000リクエストあたり$13.33product_detail数値のproduct_idを指定して、1つの商品の画像カルーセル、詳細画像、バリエーション、ショップ、公開されている販売数のスナップショットを取得します。
必須パラメータ: product_searchまたはlive_product_searchが返す数値のDouyin商品IDです。SKU ID、プロモーションID、タイトル、URLではありません。 · 単一オブジェクト
レスポンスフィールドを表示 (18)
任意パラメータ: —
product_idtitleprice_cnydiscount_price_cnysales_textsold_countshop_idshop_nameshop_avatar_urlimage_urlmain_image_urlsdetail_image_urlsassurancesshipping_fee_textshipping_estimate_textvariant_groupson_saleplatform
APIを表示配信中のライブ商品検索
1,000リクエストあたり$0.56live_product_searchキーワードで配信中のライブ商品とそのlive_room_idを検索します。
必須パラメータ: Douyin Mallの商品検索キーワードです。リクエスト時点でライブタグとライブルームIDが付いている商品のみが返されます。検索結果は、特定のクリエイターがライブ配信で販売した商品の記録ではありません。 · 1回あたりの最大件数 3 件
レスポンスフィールドを表示 (10)
任意パラメータ: —
product_idsku_idtitleimage_urlprice_cnyshop_idlive_room_idis_live_productsource_keywordplatform
APIを表示