Scrumballの評価モデルがInstagramクリエイターに付与したティアと、その根拠となる構成スコアを返します。クォータ消費の大きいプレミアムなオーディエンス分析エンドポイントです。
/api/v1/audience/instagram/rating_tierクォータ消費: このエンドポイントへの成功したリクエスト 1 件あたり、プランのクォータが 300 単位消費されます。
リクエストパラメータ
必須パラメータ
| 名前 | 位置 | 型 | 説明 |
|---|---|---|---|
username | query | string | username example: nike |
レスポンスフィールド
| 名前 | 型 | 説明 |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | - |
data.rating_tier | string | Rating tier (HIGH / MEDIUM / LOW) |
お試し実行
クエリパラメータ
username*cURL の例
curl -X GET "https://openapi.scdata.cc/api/v1/audience/instagram/rating_tier?username=nike" \-H "Authorization: YOUR_API_KEY"
レスポンス例 (200 application/json)
{"success": true,"code": 200,"message": "Request successful","data": {"rating_tier": "HIGH"}}
ユースケース
- 候補の順位付け — 長いクリエイターリストをティア順に並べ、最有力候補から確認します。
- ティア別報酬体系 — ティアを、段階的な提携料金の客観的な基準として使います。