Douyinデータ API
Douyin のプロフィール・動画・コメント・ハッシュタグ・音楽・ライブ配信・急上昇ボードを、正規化 JSON を返す 1 つの REST インターフェースで。
- 14 個のケイパビリティファミリー
- 14 本のドキュメント済みエンドポイント
ケイパビリティファミリー別エンドポイント一覧
アカウント識別：プロフィール取得。紹介文・認証・オーディエンス項目を正規化 JSON で返します。
| メソッド | パス | ケイパビリティ |
|---|---|---|
| GET | /v1/douyin/users/{username} | douyin.profile |
単一コンテンツ取得：1 件の投稿と、紐づくコメント・いいね・メディアを正規化して返します。
| メソッド | パス | ケイパビリティ |
|---|---|---|
| GET | /v1/douyin/posts/{id} | douyin.post |
投稿・アクティビティフィード：アカウント・ハッシュタグ・音楽ページの投稿を順に返します。
| メソッド | パス | ケイパビリティ |
|---|---|---|
| GET | /v1/douyin/users/{username}/posts | douyin.user_posts |
単一コンテンツ取得：1 件の投稿と、紐づくコメント・いいね・メディアを正規化して返します。
| メソッド | パス | ケイパビリティ |
|---|---|---|
| GET | /v1/douyin/posts/{id}/comments | douyin.comments |
単一コンテンツ取得：1 件の投稿と、紐づくコメント・いいね・メディアを正規化して返します。
| メソッド | パス | ケイパビリティ |
|---|---|---|
| GET | /v1/douyin/posts/{id}/comments/{comment_id}/replies | douyin.comment_replies |
リレーショングラフ：フォロワー・フォローリストをページング付きの正規化 JSON で返します。
| メソッド | パス | ケイパビリティ |
|---|---|---|
| GET | /v1/douyin/users/{username}/followers | douyin.user_followers |
リレーショングラフ：フォロワー・フォローリストをページング付きの正規化 JSON で返します。
| メソッド | パス | ケイパビリティ |
|---|---|---|
| GET | /v1/douyin/users/{username}/following | douyin.user_following |
ハッシュタグとトピック：タグのメタデータと、そのタグ付きのコンテンツ。
| メソッド | パス | ケイパビリティ |
|---|---|---|
| GET | /v1/douyin/hashtags/{tag} | douyin.hashtag |
投稿・アクティビティフィード：アカウント・ハッシュタグ・音楽ページの投稿を順に返します。
| メソッド | パス | ケイパビリティ |
|---|---|---|
| GET | /v1/douyin/hashtags/{tag}/posts | douyin.hashtag_posts |
単一コンテンツ取得：1 件の投稿と、紐づくコメント・いいね・メディアを正規化して返します。
| メソッド | パス | ケイパビリティ |
|---|---|---|
| GET | /v1/douyin/musics/{id} | douyin.music |
投稿・アクティビティフィード：アカウント・ハッシュタグ・音楽ページの投稿を順に返します。
| メソッド | パス | ケイパビリティ |
|---|---|---|
| GET | /v1/douyin/musics/{id}/posts | douyin.music_posts |
単一コンテンツ取得：1 件の投稿と、紐づくコメント・いいね・メディアを正規化して返します。
| メソッド | パス | ケイパビリティ |
|---|---|---|
| GET | /v1/douyin/live/{id} | douyin.live_room |
検索とトレンド：投稿・アカウントのキーワード検索、急上昇リスト、トレンドトピック。
| メソッド | パス | ケイパビリティ |
|---|---|---|
| GET | /v1/douyin/hot-search | douyin.hot_search |
単一コンテンツ取得：1 件の投稿と、紐づくコメント・いいね・メディアを正規化して返します。
| メソッド | パス | ケイパビリティ |
|---|---|---|
| GET | /v1/douyin/download/{id} | douyin.download |
よくある質問
Douyinデータ API について
Douyinデータ API とは？
Douyinデータ API は、Douyin向けの FetchPI の読み取りインターフェースです。文書化された REST エンドポイントが、公開されているDouyinデータを構造化 JSON で返します。ページを解析したりプラットフォーム専用のスクレイパーを維持したりする代わりに、エンドポイントを呼べば、安定したフィールド名を持つ正規化レスポンスが得られます。そのスキーマ形状はすべての FetchPI プラットフォームで共通です。14 本すべてのドキュメント済みエンドポイントはケイパビリティファミリーに属し、それぞれにリファレンスページ・パラメータ表・例が用意されています。
Douyinデータ API でどんなデータが取得できますか？
API は上の表に載っているDouyinのケイパビリティファミリーをカバーします。14 ファミリー・14 エンドポイントで、それぞれのパラメータとレスポンススキーマが文書化されています。典型的な用途は、プロフィールの補完、投稿とコメントの収集、フォローグラフの分析、キーワード監視、トレンド追跡です。ファミリーが返す正確なフィールドはそのケイパビリティページに文書化されており、契約にないデータ型を API が約束することはありません。
Douyinで現在公開されているケイパビリティファミリー：
- profile
- post
- user_posts
- comments
- comment_replies
- user_followers
- user_following
- hashtag
- hashtag_posts
- music
- music_posts
- live_room
- hot_search
- download
Douyinデータ API の使い方
ゼロから最初のレスポンスまで、3 ステップです。
ステップ 1 — 無料アカウントを作成
コンソールで登録します。ワークスペースは自動でプロビジョニングされ、登録時には最初の呼び出しに使える無料クレジットが付きます。
ステップ 2 — API キーを取得
コンソールでキーを作成し、すべてのリクエストで標準の Authorization: Bearer ヘッダーとして送ります。
ステップ 3 — エンドポイントを呼ぶ
GET /v1/douyin/users/{username} のような文書化済みエンドポイントから始め、レスポンスから正規化 JSON を読み取ります。下のコピー＆ペースト例は契約のデモ値を使っています。
curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
"https://fetchpi.com/v1/douyin/users/newdev"データ鮮度の仕組み
すべてのエンドポイントが、データ API 共通の鮮度パラメータを受け付けます。cache は上流に触れず保存済みスナップショットから応答し、live はより新しいデータを取得して追加クレジットがかかる場合があり、max_age は許容するデータの最大経過秒数を指定します。レスポンスの meta ブロックは各応答を生んだモード・経過時間・提供レイヤーを報告するので、下流システムは鮮度を推測ではなく事実で扱えます。API が約束しないのは上流のリアルタイム状態です。meta ブロックが、実際に何を得たかの正直な報告です。
自作スクレイパーとDouyinデータ API の比較
自作のDouyinスクレイパーは、うまくいく場合もその所有者です。ページ構造は変わり、ボット対策は強化され、パーサーの修正はすべてあなたのロードマップに載ります。データ API はその保守を契約に変えます。文書化されたリクエスト／レスポンススキーマ、見つからない場合やレート制限のための公開済みエラーコード、そしてすべての FetchPI プラットフォームで再利用される 1 つの統合形状です。範囲は両側で正直です。API が扱うのは公開データのみ、アカウントの認証情報は求めず、Douyinの公式製品でもありません。
Douyinデータに FetchPI が選ばれる理由
宣伝文句ではなく、統合の中で現れる 3 つの理由です。
- 1 つの正規化スキーマ — Douyinのレスポンスは他のすべての FetchPI プラットフォームと同じフィールド構造を使うので、マルチプラットフォームのパイプラインは 1 回だけパースします。
- 透明な鮮度 — すべてのレスポンスが鮮度モード・経過時間・提供レイヤーを報告します。リクエストごとに cache か live かを選び、それに応じて支払います。
- 従量課金 — 公開済みのケイパビリティ単価によるリクエスト単位のクレジット。シート課金も定額プランもなく、meta ブロックが各呼び出しの消費を報告します。
費用と制限
課金はリクエスト単位のクレジットです。各ケイパビリティに公開済みの単価があり、キャッシュ回答はライブ取得より安く、チャージはセルフサービスです。エンドポイントにはレート制限があり、制限された呼び出しは黙って失敗するのではなく、文書化された RATE_LIMIT_EXCEEDED エラーを返します。レスポンスの meta ブロックは消費クレジットを報告します。現在の各ケイパビリティの単価は料金ページに、エラーコードとレート制限の完全なリファレンスはドキュメントにあります。