songs_by_artist
Pull real songs by a named artist from YouTube Music, excluding tracks already liked or in any playlist, so you get only new catalog picks.
Instructions
Return actual songs by a specific artist -- a direct catalog pull, not a similarity recommendation like recommend_from_song/recommend_from_playlist.
Resolves artist (a name) to its YouTube Music channel and pulls its
real song catalog, excluding anything already in Liked Music OR in ANY
of the user's playlists (not just one, unlike recommend_from_playlist's
single-seed-playlist exclusion). Read-only: never adds results anywhere.
This is a hard requirement, not best-effort -- if fewer than limit
qualifying songs exist after exclusion, this returns however many were
actually found rather than padding the list. Check found vs
requested in the result to see whether it fell short.
Remix/feature variants of the same underlying song (e.g. a track and its
"(feat. ...)" credit under a different videoId) count once, not once
per variant -- see variants_collapsed in the result.
The library exclusion set is cached for speed; newly liked songs are always honoured, but call refresh_library() after adding songs to a playlist by other means.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| artist | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||