DouyinXingtuクリエイター分析API
APIの稼働状況
このAPIのステータスデータを一時的に取得できないため、最近の状態は不明です。停止しているという意味ではありません。
DouyinクリエイターのXingtu商用プロフィールを取得します。タイプとグレード、フォロワー数、平均再生数、コンテンツテーマ、EC対応フラグ、最低見積額（CNY）が含まれます。secUidやXingtu IDではなく、creator_searchで取得した表示されているdouyin_idを渡します。最低見積額は提示価格であり、成約額ではありません。
Douyin Xingtu creator analyticsは、クリエイターのプロフィールに表示されるDouyin IDを指定すると、Douyinの商用クリエイター提携プラットフォームであるXingtuから、そのクリエイターの商業活動に関する概要データを取得します。Xingtuのcreator_id、クリエイターのタイプとグレード、フォロワー数、Xingtuが報告する平均再生数、都市、省、性別、カテゴリ、コンテンツのテーマとタグ、Xingtuメンバーシップとeコマースのフラグ、表示されている最低見積額を返します。ブランドや代理店のチームは、起用前のクリエイター審査に活用しています。オーディエンスの規模、一般的な動画の再生数、価格の下限がわかります。
average_play_countはXingtu独自の数値です。Douyinの公開ページには再生数が表示されないため有用ですが、将来の成果を予測するものではありません。lowest_quote_cnyは人民元建ての見積額で、確定価格ではありません。is_xingtu_creatorは、そのアカウントがそもそもXingtuクリエイターかどうかを示します。cityはプラットフォーム上の表記言語のまま返され、正規化されません。
料金は1,000リクエストあたり$0.56（1回あたり$0.000556）です。失敗した呼び出しと空の結果には課金されません。 同期処理です。時間のかかるジョブでは、ボディに"mode": "async"を追加し、job_idを取得してポーリングしてください。
AIプロンプト
EveryInfraのDouyin Xingtuクリエイター分析エンドポイント（douyin/xingtu_creator_analytics）を使ったデータ収集スクリプトの作成を手伝ってください。
エンドポイントの仕組み：
- リクエスト：ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数EVERYINFRA_API_KEYから読み込み、ハードコードしないでください。
- リクエストボディでplatformにdouyin、actionにxingtu_creator_analyticsを指定し、パラメータはparamsの中に入れます。
- 必須パラメータ：
- douyin_id: 通常のcreator_searchアクションが返す、表示用のDouyinアカウントID（unique_id）で、xingtu_creator_analyticsとxingtu_rate_cardで必須です。xingtu_creator_searchはこの値を返しません。user_id（secUid）、Xingtuのcreator_id、ニックネームとは異なります。
- 1つのオブジェクトを返します。主なフィールド: creator_id、creator_type、follower_count、average_play_count、city、province、gender（アカウントに表示されている性別）、category_id、content_themes、tags、creator_grade、is_xingtu_creator。フィールドは全部で14個です。一覧はhttps://api.everyinfra.com/api/v1/social/catalog?platform=douyinを参照してください。.
- リクエストボディの例：
{
"platform": "douyin",
"action": "xingtu_creator_analytics",
"params": {
"douyin_id": "XiaoZhenlla"
}
}
- 料金：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 | はい | xingtu_creator_analytics | 機能の識別子です。値は固定です。 |
douyin_id | body.params | string | はい | - | 通常のcreator_searchアクションが返す、表示用のDouyinアカウントID（unique_id）で、xingtu_creator_analyticsとxingtu_rate_cardで必須です。xingtu_creator_searchはこの値を返しません。user_id（secUid）、Xingtuのcreator_id、ニックネームとは異なります。 |
コードサンプル
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": "xingtu_creator_analytics",
"params": {
"douyin_id": "XiaoZhenlla"
}
}'OpenAPI定義（JSON）サンプルは環境変数EVERYINFRA_API_KEYからAPIキーを読み込みます。コピーしたコードにAPIキーが含まれることはありません。
レスポンス例
このパラメータのサンプルレスポンスはまだありません。このプレビューはAPI定義に基づくレスポンスの構造とフィールドを示したもので、値は…で表しています。実際の呼び出し結果ではありません。
{
"id": "req_…",
"platform": "douyin",
"action": "xingtu_creator_analytics",
"results": {
"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": …
},
"billing": {
"charged": …,
"charged_usd": …,
"balance_after_usd": …,
…
},
"quota": { … }
}レスポンスフィールド
業務データはresultsに含まれます。この表はレコードに含まれうるフィールドの一覧です。プラットフォームに表示されない値を作り出すことはありません。
| フィールド | 意味 |
|---|---|
creator_id | プラットフォーム上の意味のまま |
creator_type | プラットフォーム上の意味のまま |
follower_count | フォロワー数です。nullは0ではなく、非公開であることを示します。 |
average_play_count | プラットフォーム上の意味のまま |
city | プラットフォームで使用されている言語の都市名です。正規化されていません。 |
province | プラットフォーム上の意味のまま |
gender | アカウントに表示されている性別。 |
category_id | プラットフォーム上の意味のまま |
content_themes | プラットフォーム上の意味のまま |
tags | タグの配列です。タグがない場合はnullではなく空の配列になります。 |
creator_grade | プラットフォーム上の意味のまま |
is_xingtu_creator | プラットフォーム上の意味のまま |
ecommerce_enabled | プラットフォーム上の意味のまま |
lowest_quote_cny | プラットフォーム上の意味のまま |
platform | 取得元プラットフォームの識別子で、リクエストのplatformと同じです（例：xiaohongshu、tiktok）。 |
FAQ
douyin_idはどこで確認できますか？
クリエイターのプロフィールに表示されるDouyin IDを使ってください。Douyin Creator search機能は、見つかったすべてのアカウントについてこのIDを返します。Xingtu creator searchの結果にはこのIDが含まれず、代わりにXingtuの商用IDと見積額が含まれるため、ここには渡せません。MS4wで始まるsecUidやニックネームも使えません。
creator_idとdouyin_idはどう違いますか？
douyin_idは入力として渡す公開ハンドルで、プロフィールに表示されるものです。creator_idは同じクリエイターに対するXingtu独自の固定IDで、ほかのDouyin機能が使うプロフィールIDでもハンドルでもありません。あとでXingtuのデータをプロフィール、オーディエンス、動画のデータと結合できるよう、両方を保存してください。
lowest_quote_cnyは実際のコラボレーション費用ですか？
いいえ。Xingtuがそのクリエイターについて表示している最低見積額で、取引価格ではなく掲載価格です。また、単位は検証されていないため、そのまま見積額として使わないでください。すべての見積区分について、精算に関する注記と受付可否を確認するには、同じdouyin_idでDouyin Xingtu creator rate card機能を使ってください。
エラーと課金
- 401
- キーが未指定か無効です。
- 402
- 残高が不足しています。先にチャージしてください。
- 422
- パラメータ名または値が無効です。エラーに含まれる候補を参考に修正してください。課金はされません。
- 429
- 1分あたりのリクエスト上限に達しました。Retry-Afterの指定に従って待ってから再試行してください。
- 503
- 処理を完了できませんでした。保留中の請求額は残高に戻されます。結果が不明な場合は、再試行する前に確認してください。
- 200（空）
- データがありません。課金はされません。