This endpoint is available for YouTube shorts, Instagram reels and TikTok videos.

Need to get the short video ID? Use the Get short videos endpoint.

Request

GET /api/v2/artist/shorts/{identifier}/audience

Path parameters

Parameter name Value Description Additional
identifier string

A short/reel/video identifier

Required

Query string parameters

Parameter name Value Description Additional
startDate string

Optional period start date (format YYYY-MM-DD), period cannot exceed 90 days

endDate string

Optional period end date (format YYYY-MM-DD), leave empty to use latest 90 days

Response

Status code Description Resource
200 OK

A Short video Audience collection response

ShortVideo Audience Collection
401 Unauthorized

You are not logged in

403 Forbidden

This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access.

404 Not Found

Short Video not found


Explore this api

identifier

A short/reel/video identifier

startDate

Optional period start date (format YYYY-MM-DD), period cannot exceed 90 days

endDate

Optional period end date (format YYYY-MM-DD), leave empty to use latest 90 days

Try it out!