Docs
ダッシュボード

Xオーディエンスの行動を取得

46 件のエンドポイント • ベース: https://openapi.scdata.cc

エンドポイント

Xクリエイターのオーディエンスの行動指標（種類別の反応率、アクティブな時間帯、エンゲージメントの深さ）を返します。クォータ消費の大きいプレミアムなオーディエンス分析エンドポイントです。

GET/api/v1/audience/x/interactive_behavior

クォータ消費: このエンドポイントへの成功したリクエスト 1 件あたり、プランのクォータが 300 単位消費されます。

リクエストパラメータ

必須パラメータ

名前位置型説明
usernamequerystringX handle(username)
example: nasa

任意パラメータ

名前位置型説明
X-LanguageheaderstringLanguage code, supported: en, zh-CN, ja, ko
example: en

レスポンスフィールド

名前型説明
successbooleanSuccess
codeintegerCode
messagestringMessage
dataarray<object>Data
data[].rolestringRole
data[].valuestringValue
data[].demographicstringDemographics

お試し実行

https://openapi.scdata.cc/api/v1/audience/x/interactive_behavior
ダッシュボードのAPIキーを選択
リクエストを送信する前にAPIキーを入力してください。ダッシュボードを開く

クエリパラメータ

username*

cURL の例

bash
curl -X GET "https://openapi.scdata.cc/api/v1/audience/x/interactive_behavior?username=nasa" \
  -H "Authorization: YOUR_API_KEY"

レスポンス例 (200 application/json)

json
{
  "success": true,
  "code": 200,
  "message": "Request successful",
  "data": [
    {
      "role": "Viewer",
      "value": "60.00",
      "demographic": "Primarily young adults and teenagers who enjoy entertaining content."
    },
    {
      "role": "Content Creator",
      "value": "25.00",
      "demographic": "Individuals creating similar engaging videos or aspiring YouTubers."
    },
    {
      "role": "Brand Collaborator",
      "value": "15.00",
      "demographic": "Companies looking to partner for promotions and sponsorships in videos."
    }
  ]
}

ユースケース

  • エンゲージメント品質スコアリング — オーディエンスがコメントやシェアをするクリエイターを、ただスクロールされるだけのクリエイターより優先します。
  • 投稿時間の最適化 — クリエイターのオーディエンスが最も活発な時間帯にスポンサー投稿を予定します。

関連エンドポイント