Api documentation

Get retention

Also called “conversion rate” or “followers to listeners ratio”, this metric shows the relationship between the listeners and the followers. Do take into account that not all followers are listeners. We calculate this by dividing the total number of listeners by the total number of followers, multiplied by 100. The higher the percentage is, the better the artist can turn its listeners into followers.

Available platforms for this endpoint are Spotify, YouTube, Anghami and JioSaavn.

Note that the metrics can be different according to the platform:

  • Spotify: Followers / Monthly Listeners
  • JioSaavn: Followers / Monthly Listeners
  • YouTube: Subscribers / Views
  • Anghami: Followers / Plays

Don't know the artist UUID yet? Use the Get artist by platform ID or Search artist by name endpoints.

Request

GET /api/v2/artist/{uuid}/{platform}/retention

Path parameters

Parameter name Value Description Additional
uuid string

An artist UUID

 Required
platform string

A social platform code (spotify, jiosaavn, anghami, youtube)

 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

Retention for a period

 Retention Plot 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

Artist not found

Explore this api

uuid

An artist UUID
platform

A social platform code (spotify, jiosaavn, anghami, youtube)
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!