[GH-ISSUE #99] No way to tell explicit and non explicit versions of songs apart? #74

New issue

Closed

opened 2026-02-27 22:07:53 +03:00 by kerem · 2 comments

kerem commented

2026-02-27 22:07:53 +03:00

Owner

Originally created by @kubeckubis44 on GitHub (Nov 5, 2020).
Original GitHub issue: https://github.com/sigma67/ytmusicapi/issues/99

Originally assigned to: @sigma67 on GitHub.

Hi!
I was wondering if there is a way to tell if a song is explicit (they have that small 'E' tag in front of the track name) or not.
I could'nt find anything about it in the metadata returned by get_song and i think it would be a very useful thing to include there (if possible).

Originally created by @kubeckubis44 on GitHub (Nov 5, 2020). Original GitHub issue: https://github.com/sigma67/ytmusicapi/issues/99 Originally assigned to: @sigma67 on GitHub. Hi! I was wondering if there is a way to tell if a song is explicit (they have that small 'E' tag in front of the track name) or not. I could'nt find anything about it in the metadata returned by `get_song` and i think it would be a very useful thing to include there (if possible).

kerem

2026-02-27 22:07:53 +03:00

closed this issue
added the
enhancement
label

kerem commented

2026-02-27 22:07:53 +03:00

Author

Owner

@sigma67 commented on GitHub (Nov 8, 2020):

It's not possible with get_song unfortunately, since that uses a YouTube endpoint that does not mark explicit songs. For albums it is possible using the contentRating property. For playlists it should be possible, but the data is inconsistent and I can't really figure out which property indicates that a song is explicit.

So it would have to be done for each endpoint separately. Which one would you use it for? Pull requests are welcome as always.

@sigma67 commented on GitHub (Nov 8, 2020): It's not possible with get_song unfortunately, since that uses a YouTube endpoint that does not mark explicit songs. For albums it is possible using the contentRating property. For playlists it should be possible, but the data is inconsistent and I can't really figure out which property indicates that a song is explicit. So it would have to be done for each endpoint separately. Which one would you use it for? Pull requests are welcome as always.

kerem commented

2026-02-27 22:07:53 +03:00

Author

Owner

@sigma67 commented on GitHub (Jan 11, 2021):

I figured out why explicit songs seemed inconsistent: Some songs are only marked as explicit when signed in. Will add an explicit property for applicable endpoints with the next version.

@sigma67 commented on GitHub (Jan 11, 2021): I figured out why explicit songs seemed inconsistent: Some songs are only marked as explicit when signed in. Will add an `explicit` property for applicable endpoints with the next version.

kerem referenced this issue

2026-02-27 23:01:27 +03:00

[PR #74] [MERGED] Return empty list if no songs are uploaded #552