Douyin API

Douyinのsearchのパラメータはそれぞれどういう意味ですか？

検索語でDouyinの動画を検索します。キャプション、ハッシュタグ、いいね数、コメント数、シェア数、保存数、投稿者情報、署名付きの再生リンクを取得できます。Douyinは再生数を公開していません。そのためview_countは通常含まれないか0で、実際の再生数を示すことはありません。リーチはいいね数、コメント数、シェア数で判断してください。

keyword必須

動画検索アクションの検索キーワードで、文字列で渡します（例：latte art）。動画を検索するためのもので、アカウントのニックネームや動画IDではありません。

page_token任意

ページトークンです。ページングを開始するには空文字列page_token=""を送信し、次のページを取得するには前回のレスポンスのnext_page_tokenを受け取ったとおりそのまま渡します。その際、keyword、sort、publish_timeは変更しないでください。1ページの取得は1回の呼び出しで、Douyinの検索結果ページ単位で途中で切らずに返されます。各ページには少なくともlimit件の動画（デフォルト10件、最大50件。最終ページでは少なくなります）が含まれ、数件多くなることもよくあります。Douyinが前のページと重複して返す動画は除外されます。トークンの有効期限は24時間で、同じアカウントかつ同じパラメータでのみ使用できます。期限切れまたは条件が一致しないトークンは422を返すため、その場合は最初のページからやり直してください。最終ページのレスポンスにはnext_page_tokenが含まれません。page_tokenを指定しない場合は、最大limit件の動画を1回取得するだけで、next_page_tokenは返されません。

publish_time任意

動画の検索結果を公開時期で絞り込みます。指定できる値はunlimited（デフォルト）、one_day（過去24時間）、one_week（過去7日間）、half_year（過去6か月）です。

指定可能な値:half_yearone_dayone_weekunlimited

sort任意

動画の検索結果を並べ替えます。指定できる値はrelevance（デフォルト）、公開日が新しい順のnewest、いいね数が多い順のmost_likedです。旧バージョン互換のエイリアスとしてgeneral（relevanceに対応）とlatest（newestに対応）も使用できます。

指定可能な値:most_likednewestrelevance

Douyinのprofileのパラメータはそれぞれどういう意味ですか？

secUidでDouyinアカウントを検索します。ニックネーム、ハンドル、自己紹介、フォロワー数、いいね数、動画数、IP所在地、認証状態、ショップの有無を取得できます。user_idにはニックネームや短縮IDではなく、secUid（多くはMS4wで始まります）を渡します。動画はuser_postsで取得します。

user_id必須

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

Douyinオープンプラットフォーム：Open IDとUnion ID — Douyinオープンプラットフォームでは、Open IDを単一アプリ内のユーザー識別子、Union IDを開発者アカウント全体で使われる識別子と定義しています。このページのuser_idには、上記の説明どおりsecUidを指定してください。オープンプラットフォームの識別子を同等の入力としてそのまま渡さないでください。 · 確認日 2026-09-04

Douyinのuser_postsのパラメータはそれぞれどういう意味ですか？

Douyinアカウントが公開した動画を新しい順に追跡します。各動画にはキャプション、ハッシュタグ、長さ、エンゲージメント数、公開日時が含まれます。ページングは空のpage_tokenで開始します。各next_page_tokenは24時間以内に渡してください。sinceで公開日の下限を指定できます。

user_id必須

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

Douyinオープンプラットフォーム：Open IDとUnion ID — Douyinオープンプラットフォームでは、Open IDを単一アプリ内のユーザー識別子、Union IDを開発者アカウント全体で使われる識別子と定義しています。このページのuser_idには、上記の説明どおりsecUidを指定してください。オープンプラットフォームの識別子を同等の入力としてそのまま渡さないでください。 · 確認日 2026-09-04

page_token任意

user_postsのページトークンです。空の文字列page_token=""を送ると最新のページから始まり、その後は各レスポンスのnext_page_tokenを受け取ったとおりに渡します。他のパラメータは変えないでください。トークンの有効期間は24時間で、同じアカウントかつ同じパラメータでのみ使えます。最終ページにはnext_page_tokenがありません。各ページは新しい順に最大100件を含み、sinceの下限は適用されません。期間で絞る必要がある場合は、posted_atを使って自分の側で絞り込んでください。各ページは1回の呼び出しです。

since任意

profileおよびuser_postsアクションで、動画の公開日の下限をYYYY-MM-DD形式で指定します。アカウントの作成日ではなく、リクエストで取得する動画を絞り込みます。このパラメータを省略すると、日付による絞り込みは行われません。

Douyinのvideoのパラメータはそれぞれどういう意味ですか？

動画リンクから、Douyin動画1件のキャプション、ハッシュタグ、長さ、エンゲージメント数、投稿者プロフィール、BGM、公開日時を取得します。video_urlの再生リンクは署名付きで有効期限があるため、保存が必要な場合はすぐにダウンロードしてください。

url必須

対象のDouyin動画の完全なURLで、https://www.douyin.com/video/<video_id>の形式です。videoでは動画の詳細、commentsではコメント、comment_repliesでは1件のコメントへの返信（そのコメントが付いている動画を指定します）、transcriptでは音声の文字起こしを取得します。ユーザープロフィールや検索ページのURLは渡さないでください。

Douyinのcommentsのパラメータはそれぞれどういう意味ですか？

Douyin動画の視聴者コメントを取得します。いいね数、返信数、IP所在地、人気コメントフラグ、投稿者によるいいねフラグ、メンション、画像（ある場合）が含まれます。トップレベルのコメントをページ送りするには、next_page_tokenをpage_tokenとして渡します。

url必須

対象のDouyin動画の完全なURLで、https://www.douyin.com/video/<video_id>の形式です。videoでは動画の詳細、commentsではコメント、comment_repliesでは1件のコメントへの返信（そのコメントが付いている動画を指定します）、transcriptでは音声の文字起こしを取得します。ユーザープロフィールや検索ページのURLは渡さないでください。

page_token任意

user_postsとcommentsのページトークンです。ページングを始めるには空の文字列page_token=""を送り、その後は前回のレスポンスのnext_page_tokenを受け取ったとおりに渡すと次のページを取得できます。その際、他のパラメータはすべて変えないでください。トークンの有効期間は24時間で、同じアカウントかつ同じパラメータでのみ使えます。期限切れや不一致のトークンでは422が返るため、最初のページからやり直してください。最終ページのレスポンスにはnext_page_tokenがありません（pagination.has_moreはfalse）。user_postsの各ページは1回の呼び出しで、新しい順に最大100件を含み、sinceによる絞り込みは行われません（期間で絞る必要がある場合は、posted_atを使って自分の側で絞り込んでください）。commentsのページは最大50件のトップレベルコメントを含み、件数のブロック単位で課金されます。20件ごとに1回の呼び出しとして数えるため、50件のページは3回の呼び出しになり（limitを小さくするとその件数で数えます）、0件で返ったブロックは課金されません。page_tokenなしの場合は1回だけ取得します。user_postsは最新のまとまりを返し（sinceが適用されます）、commentsはリストの先頭部分のみを返信込みで返します。こちらも20件ごとに1回の呼び出しで、デフォルトは20件、limitをどれだけ大きくしても最大約50〜60件で、通常next_page_tokenはありません。

Douyinのcomment_repliesのパラメータはそれぞれどういう意味ですか？

Douyin動画のトップレベルコメント1件に付いた返信を一覧表示します。1回の呼び出しで最大100件を、20件ずつ読み込みます。各返信にはテキスト、いいね数、返信者、IP所在地、投稿者によるいいねフラグが含まれ、別の返信への返信である場合はreply_to_reply_idとreply_to_author_nameも含まれます。動画リンクと、commentsで取得したcomment_idを渡し、next_page_tokenでページ送りします。

url必須

対象のDouyin動画の完全なURLで、https://www.douyin.com/video/<video_id>の形式です。videoでは動画の詳細、commentsではコメント、comment_repliesでは1件のコメントへの返信（そのコメントが付いている動画を指定します）、transcriptでは音声の文字起こしを取得します。ユーザープロフィールや検索ページのURLは渡さないでください。

comment_id必須

返信を取得したいトップレベルコメントのIDで、数字のみです。commentsの行のidから取得します。返信があるのはreply_countが0より大きいコメントのみです。comment_repliesで、同じ動画のurlと組み合わせて使用します。動画IDや返信IDではありません。

page_token任意

comment_repliesのページトークンです。空の文字列page_token=""を送ると最初の返信から始まり、その後は各レスポンスのnext_page_tokenを受け取ったとおりに渡します。他のパラメータは変えないでください。トークンの有効期間は24時間で、同じアカウントかつ同じパラメータでのみ使えます。最終ページのレスポンスにはnext_page_tokenがありません。各ページは最大20件の返信を含み、件数のブロック単位で課金されます。20件ごとに1回の呼び出しとして数え、0件で返ったブロックは課金されません。

Douyinのtrendingのパラメータはそれぞれどういう意味ですか？

Douyinのトレンドランキングで人気キーワードを確認します。各キーワードには順位、ヒートスコア、関連する動画数・記事数・ライブルーム数、ラベル、最高順位が含まれます。ランキングはboardsで選択します（デフォルトはhotspot）。hot_valueはDouyin独自のスコアで、同じランキング内でのみ比較できます。

boards任意

trendingアクションで取得するランキングの種類を指定します。単一の文字列または文字列の配列で、hotspot、seeding、entertainment、social、challengeを渡します。省略するか空の配列を渡すと、hotspotになります。

指定可能な値:challengeentertainmenthotspotseedingsocial

Douyinのtranscriptのパラメータはそれぞれどういう意味ですか？

Douyin動画内の発話を、文単位のタイムスタンプ付きでテキストに変換します。タイトル、公開日時、エンゲージメント数、投稿者、音声トラックのリンクも取得できます。すべての動画に認識可能な発話が含まれるわけではなく、テキストは翻訳されません。

url必須

対象のDouyin動画の完全なURLで、https://www.douyin.com/video/<video_id>の形式です。videoでは動画の詳細、commentsではコメント、comment_repliesでは1件のコメントへの返信（そのコメントが付いている動画を指定します）、transcriptでは音声の文字起こしを取得します。ユーザープロフィールや検索ページのURLは渡さないでください。

Douyinのcreator_searchのパラメータはそれぞれどういう意味ですか？

ニックネーム、ハンドル、フレーズでDouyinのクリエイターアカウントを検索します。フォロワー数、性別、認証状態、ライブ配信状態に加え、後続の呼び出しに使うsecUidを取得できます。follower_rangeとuser_typeで絞り込めます。一致した結果は候補であり、本人と確定したものではありません。

keyword必須

アカウント検索に使うクリエイターのニックネーム、Douyin ID、または関連する検索フレーズです。動画のsearchアクションは実行されず、本人との完全一致も保証されません。

follower_range任意

creator_searchをアカウントのフォロワー数の範囲で絞り込みます。under_1k、1k_to_10k、10k_to_100k、100k_to_1m、over_1mのいずれかを指定します。省略すると範囲は制限されません。

指定可能な値:100k_to_1m10k_to_100k1k_to_10kover_1munder_1k

user_type任意

creator_searchをアカウント区分で絞り込みます：general、business、verified_individual。購入者のカテゴリや法的な身元の証明ではありません。

指定可能な値:businessgeneralverified_individual

Douyinのcreator_audienceのパラメータはそれぞれどういう意味ですか？

Douyinクリエイターのフォロワーを、端末の価格帯、性別、年齢、省のいずれかで分類し、各区分の割合とTGI指数を返します。割合はパーセントではなく0〜1の小数です。区分は購入者の記録や個人を表すものではありません。

user_id必須

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

dimension任意

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

指定可能な値:agedevice_price_bandgenderprovince

Douyinのcreator_trendのパラメータはそれぞれどういう意味ですか？

Douyinクリエイターのフォロワー数の推移を日付付きの時系列データとして追跡し、期間内の平均フォロワー数も返します。クリエイターのsecUidをuser_idに渡します。時系列データだけでは、増加の要因はわかりません。

user_id必須

DouyinクリエイターのsecUidで、通常はMS4wで始まります。利用可能なフォロワー推移データを取得するために使用します。ニックネームや短い数値のDouyin IDではありません。

Douyinのcreator_benchmarkのパラメータはそれぞれどういう意味ですか？

Douyinクリエイターを類似アカウントと比較します。平均投稿数、いいね数、コメント数、シェア数、フォロワー増加数のそれぞれにパーセンタイル順位が付きます。これらはアカウントの相対的な指標であり、売上やコンバージョン、因果関係を示すものではありません。

user_id必須

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

Douyinのxingtu_creator_searchのパラメータはそれぞれどういう意味ですか？

キーワードでDouyinのXingtuクリエイター記録を検索します。エンゲージメント率、予想再生数、フォロワー増加数、コマーススコア、GMVの範囲（正確なGMVではありません）、バリュー指数、動画の長さ別の見積額（CNY）を取得できます。creator_idはこれらの行を比較するためだけのものです。分析と料金表にはcreator_searchで取得したdouyin_idが必要です。

keyword必須

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

Douyinのxingtu_creator_analyticsのパラメータはそれぞれどういう意味ですか？

DouyinクリエイターのXingtu商用プロフィールを取得します。タイプとグレード、フォロワー数、平均再生数、コンテンツテーマ、EC対応フラグ、最低見積額（CNY）が含まれます。secUidやXingtu IDではなく、creator_searchで取得した表示されているdouyin_idを渡します。最低見積額は提示価格であり、成約額ではありません。

douyin_id必須

通常のcreator_searchアクションが返す、表示用のDouyinアカウントID（unique_id）で、xingtu_creator_analyticsとxingtu_rate_cardで必須です。xingtu_creator_searchはこの値を返しません。user_id（secUid）、Xingtuのcreator_id、ニックネームとは異なります。

Douyinのxingtu_rate_cardのパラメータはそれぞれどういう意味ですか？

DouyinクリエイターがXingtuに掲載している料金プランを確認できます。各プランには形式、現在の見積額と元の見積額、精算に関する注記、動画タイプ、受付状況が含まれます。creator_searchで取得したdouyin_idを使います。これらは掲載料金であり、合意済みの取引や最終的な精算額ではありません。

douyin_id必須

通常のcreator_searchアクションが返す、表示用のDouyinアカウントID（unique_id）で、xingtu_creator_analyticsとxingtu_rate_cardで必須です。xingtu_creator_searchはこの値を返しません。user_id（secUid）、Xingtuのcreator_id、ニックネームとは異なります。

Douyinのxingtu_creator_rankingsのパラメータはそれぞれどういう意味ですか？

Douyin Xingtuのランキングからクリエイターを最大5人取得します。ランキングは業界、ランキングの種類、期間で選択します。順位、前回の順位、スコア、CPM、案件数の範囲を取得できます。順位とスコアは、返されたランキングと期間の中でのみ比較できます。案件数とリピートの範囲は正確な合計値ではありません。

industry必須

Xingtuクリエイターランキングの業種を選びます。apparel_accessories、automotive、beauty、electronics、food_beverage、household_goods、mother_baby_petsのいずれかです。これはランキングのフィルターで、クリエイターが付けたタグではありません。

指定可能な値:apparel_accessoriesautomotivebeautyelectronicsfood_beveragehousehold_goodsmother_baby_pets

ranking_type必須

Xingtuのランキングを選びます。all_top、head_tier、paid_ad_performers、rising_stars、sales_champions、top_creators、viral_driversのいずれかです。ランキング名によって、順位が予測や結果の保証になるわけではありません。

指定可能な値:all_tophead_tierpaid_ad_performersrising_starssales_championstop_creatorsviral_drivers

time_window必須

Xingtuのランキングのスナップショットを選択します：latest_weekly、latest_monthly、all_history_weekly、all_history_monthly。返されるランキングの対象範囲を決めるもので、任意の日付範囲は指定できません。

指定可能な値:all_history_monthlyall_history_weeklylatest_monthlylatest_weekly

Douyinのproduct_searchのパラメータはそれぞれどういう意味ですか？

キーワードでDouyin Mallの商品を最大5件検索します。価格（CNY）、30日間の販売数、高評価率、ショップ、コミッション率、提携クリエイター数を取得できます。提携クリエイター数は、特定のクリエイターがその商品を販売したことを示すものではありません。メインのソースが利用できない場合は、バックアップのソースから商品ID、タイトル、リンク、画像、価格（CNY）、ショップIDのみが返されます。その場合、販売数、評価率、ショップ名、カテゴリ、コミッション、クリエイター関連のフィールドは含まれません。0.1元以下の誘導価格は除外されます。

keyword必須

Douyinの商品検索キーワードです。検索結果は独立した商品プールであり、指定したクリエイターがその商品を宣伝または販売したことを示すものではありません。

Douyinのproduct_detailのパラメータはそれぞれどういう意味ですか？

数値IDを指定して、Douyin Mallの商品1件を取得します。表示価格と割引価格（CNY）、販売数、ショップ、画像、保証内容、配送に関する注記、バリエーション、販売状況を取得できます。product_idはproduct_searchまたはlive_product_searchから取得してください。SKUやプロモーションIDは使えません。

product_id必須

product_searchまたはlive_product_searchが返す数値のDouyin商品IDです。SKU ID、プロモーションID、タイトル、URLではありません。

Douyinのlive_product_searchのパラメータはそれぞれどういう意味ですか？

キーワードで現在ライブ配信中に販売されているDouyinの商品を最大3件検索します。SKU、タイトル、価格（CNY）、ショップ、ライブルームIDを取得できます。ルームIDが示すのは、この検索で見つかったライブ配信のみです。過去のライブ販売実績との関連を示すものではありません。

keyword必須

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

Douyinのhashtag_searchのパラメータはそれぞれどういう意味ですか？

名前にkeywordを含むDouyinのハッシュタグを、ヒート指数の高い順に検索します。各ハッシュタグには数値ID、ヒート指数、中国時間で直近7日間（丸1日単位）に集まった動画数、いいね数、再生数が含まれ、各行に集計期間の日付が付きます。1回の呼び出しで最大200件、デフォルトは20件です。累計値が必要な場合はhashtag_idをhashtag_detailに渡します。

keyword必須

Douyinのハッシュタグ名から探すキーワードです（例：food）。中国語のキーワードのほうが多くのハッシュタグに一致する傾向があります。検索対象はハッシュタグで、動画は検索しません。

Douyinのhashtag_detailのパラメータはそれぞれどういう意味ですか？

hashtag_searchで取得した数値のhashtag_idを指定して、Douyinのハッシュタグ1件を取得します。名前、作成以来の総再生数、参加ユーザー数、作成日時、共有リンクを取得できます。合計値はハッシュタグ全体を対象としたプラットフォーム上の集計で、特定期間の値ではありません。

hashtag_id必須

hashtag_detailで使用するDouyinハッシュタグの数値ID（例：1767586897793101）で、hashtag_searchの行のhashtag_idから取得します。ハッシュタグ名や#nameを渡すと、課金前に拒否されます。

Douyinのbillboard_video_hotのパラメータはそれぞれどういう意味ですか？

Douyin独自のトレンドツールであるHot Spot Treasureの動画ランキングを読み取ります。総合ランキング、フォロワー増加数上位、高評価率上位のいずれかを、直近1時間、1日、3日、7日から選べます。各作品には再生数、高評価数、高評価率、獲得フォロワー数、フォロワー増加率、熱度スコア、投稿者のフォロワー数が含まれ、熱度の高い順に並びます。1ページ最大50件ですが、Douyinが一部の作品を除外するため、ページの件数は少なくなることが多く、件数が少なくても最終ページとは限りません。各件に順位は含まれません。

board任意

billboard_video_hotのランキングです。all（デフォルト）は総合ランキング、follower_growthは再生数に対する獲得フォロワー数が最も多い作品のランキング、like_rateは高評価率が最も高い作品のランキングです。

指定可能な値:allfollower_growthlike_rate

keyword任意

任意です。この語句に関連する作品のみに絞り込みます（例：food）。ランキング全体を取得する場合は省略します。

page_token任意

ページトークンです。最初のページでは省略し、以降は前回のレスポンスのnext_page_tokenを受け取ったとおりそのまま渡します。その他のパラメータは変更しないでください。各ページには最大50件の作品が含まれ、1ページの取得は1回の呼び出しです。Douyinが一部の作品を除外するため、1ページが50件未満になることはよくあり、件数が少なくても最終ページとは限りません。トークンの有効期限は24時間で、最終ページにはnext_page_tokenがありません（1つのランキングにつき最大約1,000件）。

time_window任意

集計期間です。1h（直近1時間）、1d（直近24時間、デフォルト）、3d、7dから選択します。

指定可能な値:1d1h3d7d

Douyinのbillboard_low_fan_explosionのパラメータはそれぞれどういう意味ですか？

Hot Spot Treasureの低フォロワーヒットランキングから、小規模アカウントのヒット作品を見つけられます。各件で投稿者のフォロワー数と、作品の再生数、高評価数、高評価率、新規フォロワー数を並べて示すので、小規模アカウントがどこまで伸びたかがわかります。任意のkeywordと、1時間〜7日の期間で絞り込めます。1ページ最大50件でページの件数は一定でないため、next_page_tokenがなくなるまでページングを続けてください。

keyword任意

任意です。この語句に関連する作品のみに絞り込みます（例：food）。ランキング全体を取得する場合は省略します。

page_token任意

ページトークンです。最初のページでは省略し、以降は前回のレスポンスのnext_page_tokenを受け取ったとおりそのまま渡します。その他のパラメータは変更しないでください。各ページには最大50件の作品が含まれ、1ページの取得は1回の呼び出しです。Douyinが一部の作品を除外するため、1ページが50件未満になることはよくあり、件数が少なくても最終ページとは限りません。トークンの有効期限は24時間で、最終ページにはnext_page_tokenがありません（1つのランキングにつき最大約1,000件）。

time_window任意

集計期間です。1h（直近1時間）、1d（直近24時間、デフォルト）、3d、7dから選択します。

指定可能な値:1d1h3d7d

Douyinのbillboard_high_completionのパラメータはそれぞれどういう意味ですか？

Hot Spot Treasureの高視聴完了率ランキングから、視聴者が最後まで見ているDouyin作品を確認できます。各作品について長さ、再生数、高評価数、高評価率、熱度スコア、カバー画像、署名付き再生リンクを取得できますが、視聴完了率そのものは返りません。期間は1時間〜7日から選び、任意でkeywordを指定できます。1ページ最大50件（少ないことも多くあります）で、next_page_tokenでページングします。

keyword任意

任意です。この語句に関連する作品のみに絞り込みます（例：food）。ランキング全体を取得する場合は省略します。

page_token任意

ページトークンです。最初のページでは省略し、以降は前回のレスポンスのnext_page_tokenを受け取ったとおりそのまま渡します。その他のパラメータは変更しないでください。各ページには最大50件の作品が含まれ、1ページの取得は1回の呼び出しです。Douyinが一部の作品を除外するため、1ページが50件未満になることはよくあり、件数が少なくても最終ページとは限りません。トークンの有効期限は24時間で、最終ページにはnext_page_tokenがありません（1つのランキングにつき最大約1,000件）。

time_window任意

集計期間です。1h（直近1時間）、1d（直近24時間、デフォルト）、3d、7dから選択します。

指定可能な値:1d1h3d7d

Douyinのbillboard_search_hotのパラメータはそれぞれどういう意味ですか？

Hot Spot Treasureの検索ランキングから、Douyinで伸びている検索語を見つけられます。各検索語には順位、選択した期間の検索熱度、最大14日分の日別熱度の推移が含まれます。必要に応じて、keywordを含む検索語だけに絞り込めます。1ページ50件で、next_page_tokenで次のページを取得します。熱度はDouyin独自のスコアで、検索回数ではありません。

keyword任意

任意です。この語句を含む検索ワードのみに絞り込みます（例：food）。検索ランキング全体を取得する場合は省略します。

page_token任意

ページトークンです。最初のページ（上位50件の検索ワード）では省略し、以降は前回のレスポンスのnext_page_tokenを受け取ったとおりそのまま渡します。その他のパラメータは変更しないでください。各ページには最大50件の検索ワードが含まれ、1ページの取得は1回の呼び出しです。トークンの有効期限は24時間で、最終ページにはnext_page_tokenがありません。

time_window任意

検索人気度の集計期間です。1h、1d（デフォルト）、3d、7dから選択します。

指定可能な値:1d1h3d7d

Douyinのbillboard_account_searchのパラメータはそれぞれどういう意味ですか？

Hot Spot Treasureを通じて、keywordに関連するDouyinアカウントを探します。各アカウントのフォロワー数、いいね数、動画数を取得できます。返されるuser_idは、profileとuser_postsで使えるsecUidです。1ページあたり約30件（数件少ない場合もあります）で、next_page_tokenで次のページを取得します。結果は関連アカウントであり、ランキングではありません。

keyword必須

関連するDouyinアカウントを探すための語句です（例：food）。各アカウントはフォロワー数、いいね数、動画数とともに返されます。

page_token任意

ページトークンです。最初のページでは省略し、以降は前回のレスポンスのnext_page_tokenを受け取ったとおりそのまま渡します。各ページには最大30件のアカウントが含まれ（最終ページでなくても1〜2件少ないことがあります）、1ページの取得は1回の呼び出しです。トークンの有効期限は24時間で、最終ページにはnext_page_tokenがありません。

Douyinのmusic_searchのパラメータはそれぞれどういう意味ですか？

曲名、アーティスト名、サウンド名でDouyinの音楽ライブラリを検索します。各楽曲にはタイトル、アーティスト、長さ、使用作品数、カバー画像、再生リンク、歌詞リンク（ある場合）、タグが含まれます。1ページあたり10件で、next_page_tokenで次のページを取得します。Douyinにある楽曲であっても、商用利用が認められているとは限りません。

keyword必須

曲名、アーティスト名またはサウンド名です（例：Jay Chou）。動画ではなく、Douyinの音楽ライブラリを検索します。

page_token任意

ページトークンです。最初のページでは省略し、以降は前回のレスポンスのnext_page_tokenを受け取ったとおりそのまま渡してください。1ページあたり最大10曲で、1ページが1回の呼び出しになります。トークンの有効期限は24時間で、最後のページにはnext_page_tokenがありません。

Douyinのsearch_suggestのパラメータはそれぞれどういう意味ですか？

keywordに対してDouyinの検索ボックスに表示されるオートコンプリート候補を、Douyinの表示順で、1から始まるrank付きで取得します。1回の呼び出しで最大10件ですが、Douyinが表示するのは通常5件程度で、ページングはありません。候補に検索ボリュームは含まれません。

keyword必須

Douyinの検索ボックスに入力するテキストです（例：artificial intelligence）。候補はDouyinでの表示順で返されます。

Douyinのbillboard_rise_listのパラメータはそれぞれどういう意味ですか？

Hot Spot Treasureの急上昇ランキングから、Douyinで最も勢いよく伸びているトレンドを把握できます。各トレンドには順位と上昇幅、タイトル、ID、熱度、関連動画数、カテゴリ、作成日時、1時間ごとの熱度の推移が含まれます。必要に応じて、keywordを含むトレンドだけに絞り込めます。1ページ50件で、next_page_tokenで次のページを取得します。

keyword任意

任意です。この語句を含むトレンドのみに絞り込みます（例：game）。急上昇ランキング全体を取得する場合は省略します。

page_token任意

ページトークンです。最初のページ（上位50件のトレンド）では省略し、以降は前回のレスポンスのnext_page_tokenを受け取ったとおりそのまま渡します。その他のパラメータは変更しないでください。各ページには最大50件のトレンドが含まれ、1ページの取得は1回の呼び出しです。トークンの有効期限は24時間で、最終ページにはnext_page_tokenがありません。

Douyinのbillboard_challenge_hotのパラメータはそれぞれどういう意味ですか？

Douyin独自のトレンドツールであるHot Spot Treasureのチャレンジランキングを読み取ります。1回の呼び出しで、ランキング全体の50件のトレンドを取得できます。各トレンドには順位、タイトル、ID、熱度、関連動画数、作成日時、約10分ごとにサンプリングされた熱度の推移が含まれます。limitは件数を減らす方向にしか使えず、ページングはありません。

このアクションには固有のパラメータがありません。プラットフォームとアクションの識別子のみを送信してください。

Douyinのbillboard_topic_hotのパラメータはそれぞれどういう意味ですか？

Hot Spot Treasureのハッシュタグランキングから、直近1時間、1日、3日、7日で盛り上がっているDouyinのハッシュタグを確認できます。各ハッシュタグには順位、hashtag_detailに使える数値ID、名前、熱度、累計の再生数と作品数、作品あたりの平均再生数、カバー画像、最大14日分の日別熱度が含まれます。1ページ50件で、next_page_tokenで次のページを取得します。

keyword任意

任意です。名前にこの語句を含むハッシュタグのみに絞り込みます（例：food）。ハッシュタグランキング全体を取得する場合は省略します。

page_token任意

ページトークンです。最初のページ（上位50件のハッシュタグ）では省略し、以降は前回のレスポンスのnext_page_tokenを受け取ったとおりそのまま渡します。その他のパラメータは変更しないでください。各ページには最大50件のハッシュタグが含まれ、1ページの取得は1回の呼び出しです。トークンの有効期限は24時間で、最終ページにはnext_page_tokenがありません（1つのランキングにつき最大約1,000件のハッシュタグ）。

time_window任意

ハッシュタグ人気度の集計期間です。1h、1d（デフォルト）、3d、7dから選択します。

指定可能な値:1d1h3d7d

Douyinのmusic_detailのパラメータはそれぞれどういう意味ですか？

music_searchで取得した数値のmusic_id、またはdouyin.com/musicのリンクを指定して、Douyinの楽曲1件を取得します。タイトル、アーティスト、長さ、使用作品数、カバー画像、再生リンク、歌詞リンク（ある場合）を取得できます。曲名で検索する場合はmusic_searchを使います。

music_id必須

数値のDouyin音楽ID（例：7699717253151558410）で、music_searchの行のidから取得します。douyin.com/music/<ID>形式のリンクも受け付けます。

Douyinのxingtu_conversion_abilityのパラメータはそれぞれどういう意味ですか？

Douyinクリエイター1人のXingtu案件動画について、Xingtuが表示する直近7日、30日、90日間のコンバージョン指標を取得します。関連動画数、再生数の中央値、コンポーネントのクリック数とクリック率、CPC、GPM、平均販売数、プロモーション商品とそのカテゴリが含まれます。ほとんどの値は500-1000のようなXingtu独自の表記による範囲で、「10%以上」のような上限のない値は中国語で表記されます。数値があるのは期間内にXingtu案件があるクリエイターのみで、それ以外は空の結果が返されます。空の結果は課金されません。

douyin_id必須

クリエイターの表示用Douyin ID（creator_searchで取得できるunique_id）、またはxingtu_creator_searchが返す19桁のXingtu creator_idです。Xingtuに登録されていないクリエイターの場合は空の結果となり、課金されません。

time_window任意

Xingtuの数値の集計期間です。7d、30d（デフォルト）、90dから選択し、今日から遡って集計します。xingtu_creator_rankingsのランキング期間とは異なります。

指定可能な値:30d7d90d

Douyinのxingtu_link_structureのパラメータはそれぞれどういう意味ですか？

Xingtuが1人のDouyinクリエイターとつながりがあるとみなすユーザー数を、Xingtuの4つのレベル別に確認できます。各レベルには人数、全体に占める割合、同じ業界のクリエイターの中央値が含まれます。さらに、合計人数、Xingtuクリエイター内での順位（total_rank_top_percent、0〜1、小さいほど上位）、Xingtuのリンクタイプラベル（中国語、シーディングまたは拡散を表します）も取得できます。

douyin_id必須

クリエイターの表示用Douyin ID（creator_searchで取得できるunique_id）、またはxingtu_creator_searchが返す19桁のXingtu creator_idです。Xingtuに登録されていないクリエイターの場合は空の結果となり、課金されません。

Douyinのxingtu_recommended_videosのパラメータはそれぞれどういう意味ですか？

DouyinクリエイターのXingtuページにある4つの動画グループ（代表作、最新動画、Xingtu案件の上位動画、個人投稿の上位動画）を一覧表示します。各動画に含まれるのはID、リンク、再生数、投稿日時のみです。動画がないグループは除外されます。

douyin_id必須

クリエイターの表示用Douyin ID（creator_searchで取得できるunique_id）、またはxingtu_creator_searchが返す19桁のXingtu creator_idです。Xingtuに登録されていないクリエイターの場合は空の結果となり、課金されません。

Douyinのxingtu_touch_distributionのパラメータはそれぞれどういう意味ですか？

Douyinクリエイターとつながりのあるユーザーが、どのコンテンツカテゴリから来たかを、Xingtuの集計に基づいて確認できます。結果は最大3階層のツリーで、通常は個人コンテンツとXingtuコンテンツの区分、カテゴリ、サブカテゴリの順に分かれ、それぞれに人数が付きます。

douyin_id必須

クリエイターの表示用Douyin ID（creator_searchで取得できるunique_id）、またはxingtu_creator_searchが返す19桁のXingtu creator_idです。Xingtuに登録されていないクリエイターの場合は空の結果となり、課金されません。

Douyinのxingtu_video_performanceのパラメータはそれぞれどういう意味ですか？

Douyinクリエイターの個人投稿動画とXingtu案件動画を、エンゲージメント率、再生数の中央値、完全視聴率で比較します。各指標には、クリエイターの値、プラットフォーム全体の平均、パーセンタイル（そのクリエイターが上回るクリエイターの割合、0〜1）が含まれます。また、最新の個人投稿動画とXingtu案件動画をそれぞれ最大約15件、タイトル、再生数、いいね数、コメント数、シェア数、長さとあわせて取得できます。

douyin_id必須

クリエイターの表示用Douyin ID（creator_searchで取得できるunique_id）、またはxingtu_creator_searchが返す19桁のXingtu creator_idです。Xingtuに登録されていないクリエイターの場合は空の結果となり、課金されません。