Returns behavioural metrics for a X creator's audience: interaction rates by type, active hours and engagement depth. Premium audience insight endpoint with a higher quota cost.
GET
/api/v1/audience/x/interactive_behaviorQuota 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 |
Optional Parameters
| Name | In | Type | Description |
|---|---|---|---|
X-Language | header | string | Language code, supported: en, zh-CN, ja, ko example: en |
Response Fields
| Name | Type | Description |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | array<object> | Data |
data[].role | string | Role |
data[].value | string | Value |
data[].demographic | string | Demographics |
Try It
https://openapi.scdata.cc/api/v1/audience/x/interactive_behavior
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/interactive_behavior?username=nasa" \-H "Authorization: YOUR_API_KEY"
Response Example (200 application/json)
json
{"success": true,"code": 200,"message": "Request successful","data": [{"role": "Viewer","value": "60.00","demographic": "Primarily young adults and teenagers who enjoy entertaining content."},{"role": "Content Creator","value": "25.00","demographic": "Individuals creating similar engaging videos or aspiring YouTubers."},{"role": "Brand Collaborator","value": "15.00","demographic": "Companies looking to partner for promotions and sponsorships in videos."}]}
Use Cases
- Engagement quality scoring — Prefer creators whose audience comments and shares rather than only scrolling past.
- Posting-time optimisation — Schedule sponsored content for the hours when the creator's audience is most active.