Returns behavioural metrics for a YouTube creator's audience: interaction rates by type, active hours and engagement depth. Premium audience insight endpoint with a higher quota cost.
/api/v1/audience/youtube/interactive_behaviorQuota usage: Each successful request to this endpoint deducts 300 quota units from your plan.
Request Parameters
Required Parameters
| Name | In | Type | Description |
|---|---|---|---|
channel_id | query | string | Channel ID example: UCX6OQ3DkcsbYNE6H8uQQuVA |
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
Query Params
channel_id*cURL Example
curl -X GET "https://openapi.scdata.cc/api/v1/audience/youtube/interactive_behavior?channel_id=UCX6OQ3DkcsbYNE6H8uQQuVA" \-H "Authorization: YOUR_API_KEY"
Response Example (200 application/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.