Returns the tier assigned to a X creator by Scrumball's rating model, together with the component scores behind it. Premium audience insight endpoint with a higher quota cost.
GET
/api/v1/audience/x/rating_tierQuota usage: Each successful request to this endpoint deducts 300 quota units from your plan.
Request Parameters
Required Parameters
| Name | In | Type | Description |
|---|---|---|---|
username | query | string | X handle(username) example: nasa |
Response Fields
| Name | Type | Description |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | - |
data.rating_tier | string | Rating tier (HIGH / MEDIUM / LOW) |
Try It
https://openapi.scdata.cc/api/v1/audience/x/rating_tier
Select an API key from Dashboard
Add an API key before sending a request.Go to Dashboard
Query Params
username*cURL Example
bash
curl -X GET "https://openapi.scdata.cc/api/v1/audience/x/rating_tier?username=nasa" \-H "Authorization: YOUR_API_KEY"
Response Example (200 application/json)
json
{"success": true,"code": 200,"message": "Request successful","data": {"rating_tier": "HIGH"}}
Use Cases
- Shortlist ranking — Sort a long creator list by tier to review the strongest candidates first.
- Tiered fee structures — Use the tier as an objective basis for tiered partnership rates.