年齢別の内訳なしで、TikTokクリエイターのオーディエンス全体の性別比率を1つの集計値として返します。クォータ消費の大きいプレミアムなオーディエンス分析エンドポイントです。
/api/v1/audience/tiktok/gender_overallクォータ消費: このエンドポイントへの成功したリクエスト 1 件あたり、プランのクォータが 300 単位消費されます。
リクエストパラメータ
必須パラメータ
| 名前 | 位置 | 型 | 説明 |
|---|---|---|---|
unique_id | query | string | unique_id example: nike |
レスポンスフィールド
| 名前 | 型 | 説明 |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | Data |
お試し実行
クエリパラメータ
unique_id*cURL の例
curl -X GET "https://openapi.scdata.cc/api/v1/audience/tiktok/gender_overall?unique_id=nike" \-H "Authorization: YOUR_API_KEY"
レスポンス例 (200 application/json)
{"success": true,"code": 200,"message": "Request successful","data": {"female": "50.00%","male": "50.00%"}}
ユースケース
- 高速な事前フィルタ — 詳細分析の前に、オーディエンスの性別比が明らかにターゲット外のクリエイターを除外します。
- ポートフォリオの均衡 — 起用クリエイター群の合計リーチがキャンペーンの性別構成に合うよう調整します。