オーディエンス分析に基づき、YouTubeクリエイターのフォロワーの年齢層別割合を返します。オーディエンス分析エンドポイントはプレミアム扱いで、リクエストあたりのクォータ消費が大きくなります。
/api/v1/audience/youtube/ageクォータ消費: このエンドポイントへの成功したリクエスト 1 件あたり、プランのクォータが 300 単位消費されます。
リクエストパラメータ
必須パラメータ
| 名前 | 位置 | 型 | 説明 |
|---|---|---|---|
channel_id | query | string | Channel ID example: UCX6OQ3DkcsbYNE6H8uQQuVA |
レスポンスフィールド
| 名前 | 型 | 説明 |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | Data |
お試し実行
クエリパラメータ
channel_id*cURL の例
curl -X GET "https://openapi.scdata.cc/api/v1/audience/youtube/age?channel_id=UCX6OQ3DkcsbYNE6H8uQQuVA" \-H "Authorization: YOUR_API_KEY"
レスポンス例 (200 application/json)
{"success": true,"code": 200,"message": "Request successful","data": {"13-17": "20.04%","18-24": "29.06%","25-34": "24.27%","35-44": "10.16%","45-54": "8.28%","55-64": "4.62%","65+": "3.57%"}}
ユースケース
- デモグラ・ターゲティング — 自社製品のターゲット年齢層にオーディエンスが集中しているクリエイターだけを残します。
- コンプライアンス確認 — 年齢制限のある商品では、未成年オーディエンスの割合が高いクリエイターを除外します。