TikTokクリエイターのスポンサーコンテンツから検出したブランドを、出現頻度と最終出現時期とともに返します。クォータ消費の大きい分析エンドポイントです(下記の注記を参照)。
GET
/api/v1/tiktok/user/brandsクォータ消費: このエンドポイントへの成功したリクエスト 1 件あたり、プランのクォータが 300 単位消費されます。
プラットフォーム共通パス
/api/v1/{platform}/user/brands利用可能なプラットフォーム
リクエストパラメータ
必須パラメータ
| 名前 | 位置 | 型 | 説明 |
|---|---|---|---|
unique_id | query | string | unique_id example: nike |
任意パラメータ
| 名前 | 位置 | 型 | 説明 |
|---|---|---|---|
page | query | integer | Page number |
page_size | query | integer | Items per page |
レスポンスフィールド
| 名前 | 型 | 説明 |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | - |
data.items | array<object> | Items |
data.total | integer | Total |
data.page | integer | Page |
data.page_size | integer | Page Size |
data.total_pages | integer | Total Pages |
お試し実行
https://openapi.scdata.cc/api/v1/tiktok/user/brands
ダッシュボードのAPIキーを選択
リクエストを送信する前にAPIキーを入力してください。ダッシュボードを開く
クエリパラメータ
unique_id*pagepage_sizecURL の例
bash
curl -X GET "https://openapi.scdata.cc/api/v1/tiktok/user/brands?unique_id=nike" \-H "Authorization: YOUR_API_KEY"
レスポンス例 (200 application/json)
json
{"success": true,"code": 200,"message": "Request successful","data": {"items": [{"brand_name": "string","collaboration_count": 0,"last_collaboration_at": "string","engagement_rate": "string","total_view_count": 0,"total_like_count": 0,"total_comment_count": 0,"videos": [{"video_id": "string","title": "string","description": "string","cover_url": "string","video_url": "string","publish_at": "string","view_count": 0,"like_count": 0,"comment_count": 0,"engagement_rate": 0}]}],"total": 0,"page": 0,"page_size": 0,"total_pages": 0}}
ユースケース
- 競合コンフリクト確認 — キャンペーンに招く前に、クリエイターが最近直接の競合を宣伝していないかを確認します。
- 実績ベースの選定 — 自社カテゴリのブランドと提携実績のあるクリエイターを優先します。