TikTokクリエイターのオーディエンスのデバイス種別・OS別の割合を返します。クォータ消費の大きいプレミアムなオーディエンス分析エンドポイントです。
/api/v1/audience/tiktok/deviceクォータ消費: このエンドポイントへの成功したリクエスト 1 件あたり、プランのクォータが 300 単位消費されます。
リクエストパラメータ
必須パラメータ
| 名前 | 位置 | 型 | 説明 |
|---|---|---|---|
unique_id | query | string | unique_id example: nike |
レスポンスフィールド
| 名前 | 型 | 説明 |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | array<object> | Data |
data[].name | string | Device |
data[].value | string | Value |
お試し実行
クエリパラメータ
unique_id*cURL の例
curl -X GET "https://openapi.scdata.cc/api/v1/audience/tiktok/device?unique_id=nike" \-H "Authorization: YOUR_API_KEY"
レスポンス例 (200 application/json)
{"success": true,"code": 200,"message": "Request successful","data": [{"name": "ios","value": "0.4365"},{"name": "android","value": "0.5635"}]}
ユースケース
- アプリインストール施策 — 宣伝するアプリに合わせて、iOSまたはAndroidのオーディエンスが多いクリエイターを選びます。
- ハードウェア製品の適合 — アクセサリーやデバイス専用製品を、その機器を持つオーディエンスに合わせます。