DouyinトレンドAPI

Q: 複数のボードを一度に取得できますか？

はい。boardsには単一の文字列または配列を指定でき、各件のboardがどのランキングから来たかを示します。結果を統合する前に、この値でグループ化してください。boardsを省略するか空の配列を送ると、hotspotランキングのみが返ります。

Q: トレンドの推移を追跡するにはどうすればよいですか？

定期的に呼び出し、すべての結果を呼び出し時刻とともに保存してください。sentence_idを使うと、スナップショットをまたいで同じトレンドワードのレコードを関連付けられます。max_rankはそのワードがこれまでに到達した最高順位を示します。is_pinnedはランキング上位に固定されたワードを示すので、順位の分析から除外するとよいでしょう。

POST

APIの稼働状況

このAPIのステータスデータを一時的に取得できないため、最近の状態は不明です。停止しているという意味ではありません。

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

Douyin Trendingは、1つ以上のDouyinランキングの現在の項目を読み取ります。内容は順位、トレンドワード、熱度、関連動画数、ランキング、カバー画像で、Douyinが表示している場合は、イベント日時、これまでの最高順位、関連投稿数とライブルーム数も含みます。Douyinで今何が見られているかがわかるため、コンテンツ企画、ニュースジャッキング、ブランド関連トピックの早期警戒、投稿スケジュールの調整に使えます。

ランキングはboardsで選びます。hotspot、seeding、entertainment、social、challengeから1つまたは複数を指定でき、省略するとhotspotランキングになります。キーワードは不要です。hot_valueはDouyin独自の熱度指標で、同じランキング内でのみ比較でき、hotspotランキングでは空のことがよくあります。rankは呼び出した時点の順位なので、定期的に呼び出して各スナップショットを保存すると、項目の推移を追えます。

料金は1,000リクエストあたり$0.56（1回あたり$0.000556）です。失敗した呼び出しと空の結果には課金されません。同期処理です。時間のかかるジョブでは、ボディに"mode": "async"を追加し、job_idを取得してポーリングしてください。

AIプロンプト

EveryInfraのDouyin トレンドエンドポイント（douyin/trending）を使ったデータ収集スクリプトの作成を手伝ってください。

エンドポイントの仕組み：
- リクエスト：ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数EVERYINFRA_API_KEYから読み込み、ハードコードしないでください。
- リクエストボディでplatformにdouyin、actionにtrendingを指定し、パラメータはparamsの中に入れます。
- 必須パラメータはありません。
- 任意パラメータ：
  - boards: trendingアクションで取得するランキングの種類を指定します。単一の文字列または文字列の配列で、hotspot、seeding、entertainment、social、challengeを渡します。省略するか空の配列を渡すと、hotspotになります。（指定可能な値：challenge / entertainment / hotspot / seeding / social）
  - limit: この呼び出しで返す最大行数で、1〜60の整数で指定します。省略するとデフォルト値が適用されます。また、返される行数がこれより少なくなる場合があります。最大値を超える値を指定すると、課金前に422が返されます。（デフォルト：20）
- レコードのリストを返します。各レコードの主なフィールド: rank（1から始まる順位です）、keyword（キーワードです）、hot_value（熱度値です）、video_count（動画数です）、board（エントリが属するランキングです）、image_url、event_time（トレンドイベントの発生時刻です）、sentence_id（トレンドフレーズのIDです（trending））、group_id（トレンドイベントのIDです（trending））、label（ランキングのエントリに付く数値のバッジコードです（trending））、word_type（トレンドフレーズの数値タイプコードです（trending））、article_count（トレンドに関連する画像投稿の数です（trending））。フィールドは全部で19個です。一覧はhttps://api.everyinfra.com/api/v1/social/catalog?platform=douyinを参照してください。.
- リクエストボディの例：
{
  "platform": "douyin",
  "action": "trending",
  "params": {}
}
- 料金：1,000リクエストあたり$0.56。失敗時および結果が空の場合は課金されません。
- 対象が数十〜数百件ある場合は、ボディに"mode": "async"を追加します。すぐにjob_idが返されるので、GET https://api.everyinfra.com/api/v1/jobs/{job_id}をポーリングして結果を取得します。
- 422の場合は、エラーに含まれる推奨パラメータ名と指定可能な値を使ってリクエストを修正します。429または503の場合は、Retry-Afterの指定に従って待ってから再試行します。

コードを書く前に、必要な対象とその件数、必要なフィールド、希望する出力形式を私に質問してください。そのうえで、計画と概算費用を私に確認してください。

リクエストパラメータ

名前	場所	型	必須	デフォルト	説明
`Authorization`	header	`string`	はい	-	Bearerの後にAPIキーを続けます。APIキーはコンソールで作成してください。URLやコードリポジトリには絶対に含めないでください。
`platform`	body	`string`	はい	`douyin`	プラットフォームの識別子です。値は固定です。
`action`	body	`string`	はい	`trending`	機能の識別子です。値は固定です。
`boards`	body.params	`array`	いいえ	-	`trending`アクションで取得するランキングの種類を指定します。単一の文字列または文字列の配列で、`hotspot`、`seeding`、`entertainment`、`social`、`challenge`を渡します。省略するか空の配列を渡すと、`hotspot`になります。指定可能な値`challengeentertainmenthotspotseedingsocial`
`limit`	body.params	`integer (1–60)`	いいえ	`20`	この呼び出しで返す最大行数で、1〜60の整数で指定します。省略するとデフォルト値が適用されます。また、返される行数がこれより少なくなる場合があります。最大値を超える値を指定すると、課金前に422が返されます。

コードサンプル

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "douyin",
  "action": "trending",
  "params": {}
}'

OpenAPI定義（JSON）サンプルは環境変数EVERYINFRA_API_KEYからAPIキーを読み込みます。コピーしたコードにAPIキーが含まれることはありません。

レスポンス例

実際のレスポンス

October 24, 2026 at 18:28（UTC）に、上のコードサンプルのパラメータでこのAPIを呼び出して取得しました。resultsとcountはその呼び出しの実際のレスポンスから個人情報（名前、ハンドル、アバター、プロフィールリンク、連絡先）を削除したものです。リストは先頭の2件のみ掲載しています。id、billing、quotaは呼び出しごとに異なるため、構造のみを示しています。

json

{
  "id": "req_…",
  "platform": "douyin",
  "action": "trending",
  "results": [
    {
      "rank": 1,
      "keyword": "渡船之上 信仰如磐",
      "video_count": 1,
      "board": "hotspot",
      "event_time": "2026-10-25 02:34:26",
      "sentence_id": "2711825",
      "label": 0,
      "word_type": 14,
      "is_pinned": true,
      "platform": "douyin"
    },
    {
      "rank": 2,
      "keyword": "中超成都蓉城0:1大连英博",
      "hot_value": 11367047,
      "video_count": 12,
      "board": "hotspot",
      "image_url": "https://p5-ex-gddgtc-sign.douyinpic.com/tos-cn-i-dy/782a03e57ee24eb7b51eac3c0ee20e5e~noop.jpeg?lk3s=bfd515bb&x-expires=1792886400&x-signature=TFoV42oMHa89HkqBwV3AKbDx6sI%3D&from=3218412987",
      "event_time": "2026-10-24T07:01:06.000Z",
      "sentence_id": "2711309",
      "group_id": "7699487992537503010",
      "label": 3,
      "word_type": 1,
      "article_count": 0,
      "is_pinned": false,
      "max_rank": 1,
      "live_room_count": 0,
      "topic_view_count": 59034929,
      "sentence_tag": 5000,
      "label_icon_url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/vjl_avo_upfbvk/ljhwZthlaukjlkulzlp/hotspot_detail_page/3.png",
      "platform": "douyin"
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

レスポンスフィールド

業務データはresultsに含まれます。この表はレコードに含まれうるフィールドの一覧です。プラットフォームに表示されない値を作り出すことはありません。

フィールド	意味
`rank`	1から始まる順位です。trendingではトレンド順位、xingtu_creator_rankingsではXingtuランキングでの順位、billboard_search_hotでは検索ランキングでの順位、search_suggestではDouyinの検索ボックスでの候補の表示位置です。
`keyword`	キーワードです。trendingではトレンドのフレーズ、billboard_search_hotでは検索語、search_suggestでは検索候補です。
`hot_value`	熱度値です。Douyin独自の指標で、同じランキング・同じ期間内でのみ比較できます。trendingではエントリの熱度（ホットスポットランキングでは空のことが多い）、Hot Spot Treasureの動画ランキングではランキングの熱度スコアで、行は高い順に並びます。billboard_search_hotでは期間内のその語の検索熱度です。
`video_count`	動画数です。profileとbillboard_account_searchではアカウントの動画数、trendingではエントリに関連する動画数です。
`board`	エントリが属するランキングです。
`image_url`	画像のリンクです。複数の画像を返す機能では、image_urls配列が返される場合があります。
`event_time`	トレンドイベントの発生時刻です。
`sentence_id`	トレンドフレーズのIDです（trending）。
`group_id`	トレンドイベントのIDです（trending）。一部のエントリでは空です。
`label`	ランキングのエントリに付く数値のバッジコードです（trending）。「人気」「新着」「急上昇」などを表し、0はバッジなしを意味します。
`word_type`	トレンドフレーズの数値タイプコードです（trending）。
`article_count`	トレンドに関連する画像投稿の数です（trending）。
`is_pinned`	アイテムが固定表示されているかどうかです（投稿の行では投稿者のプロフィール上に固定表示され、trendingではランキング上に固定表示されます）。
`max_rank`	トレンドがランキングで到達した最高順位です（trending）。
`live_room_count`	トレンドに関連するライブルームの数です（trending）。
`topic_view_count`	プラットフォーム上の意味のまま
`sentence_tag`	プラットフォーム上の意味のまま
`label_icon_url`	プラットフォーム上の意味のまま
`related_music_id`	プラットフォーム上の意味のまま
`platform`	取得元プラットフォームの識別子で、リクエストのplatformと同じです（例：xiaohongshu、tiktok）。

FAQ

複数のボードを一度に取得できますか？

はい。boardsには単一の文字列または配列を指定でき、各件のboardがどのランキングから来たかを示します。結果を統合する前に、この値でグループ化してください。boardsを省略するか空の配列を送ると、hotspotランキングのみが返ります。

ボード間で`hot_value`を比較できますか？

いいえ。これはDouyin独自の熱度指標で、同じランキング内でのみ意味を持ちます。hotspotの件では空のことがよくあります。ランキング間で比較するには、rankか、video_countやarticle_countなどの関連コンテンツ数を使ってください。

トレンドの推移を追跡するにはどうすればよいですか？

定期的に呼び出し、すべての結果を呼び出し時刻とともに保存してください。sentence_idを使うと、スナップショットをまたいで同じトレンドワードのレコードを関連付けられます。max_rankはそのワードがこれまでに到達した最高順位を示します。is_pinnedはランキング上位に固定されたワードを示すので、順位の分析から除外するとよいでしょう。

エラーと課金

401: キーが未指定か無効です。
402: 残高が不足しています。先にチャージしてください。
422: パラメータ名または値が無効です。エラーに含まれる候補を参考に修正してください。課金はされません。
429: 1分あたりのリクエスト上限に達しました。Retry-Afterの指定に従って待ってから再試行してください。
503: 処理を完了できませんでした。保留中の請求額は残高に戻されます。結果が不明な場合は、再試行する前に確認してください。
200（空）: データがありません。課金はされません。

エラー