# sigma67/ytmusicapi

Unofficial API for YouTube Music

Repository: https://github.com/sigma67/ytmusicapi
Canonical: https://ross.abutalabs.com/products/ytmusicapi
Homepage: https://ytmusicapi.readthedocs.io
Language: Python
License: MIT
License Family: permissive
Topics: youtube, youtube-music, youtube-api, ytmusicapi, youtube-music-api
Last push: 2026-08-17T16:54:34+00:00

## Health v2 (maintenance only)
Score: 94/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 84, longevity 100
- inputs: {"age_days": 2388, "days_push": 16, "days_rel": 25, "gap_med": 34, "n_releases_24m": 16}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2962, forks 334 (observed 2026-08-28T04:07:32.324855+00:00)

## What it is
A Python 3 library that provides an unofficial API client for YouTube Music by emulating the web client's requests, using user cookie data for authentication. It supports searching, browsing artists and albums, managing playlists and library content, uploading songs, and accessing podcasts and charts.

## Use cases
- programmatically search youtube music for songs and artists
- create and manage youtube music playlists from a script
- scrape song lyrics and metadata from youtube music
- upload songs to my youtube music library via api
- get music charts and mood playlists by country
- automate rating and adding songs to my youtube music library

## When to choose
- you need programmatic access to youtube music features not covered by official APIs
- you want to automate playlist creation, library management, or uploads in Python
- you need region- and language-aware youtube music data

## When to avoid
- you need an officially supported and guaranteed-stable API
- you are not comfortable providing your account cookies for authentication
- you need a non-Python client

## Facets
- artifact type: library
- maturity: active
- function: http-client, search-engine, auth, sdk
- domain: apis, media, audio, developer-tools
- platform: python, cross-platform
- tags: youtube-music, unofficial-api, music-library-management, playlists, podcasts, web-client-emulation, automation

## Member repositories
- sigma67/ytmusicapi (main) score 94

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:32.324855+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:32:08.961916+00:00, confidence not recorded.
  - readme: https://github.com/sigma67/ytmusicapi (fetched 2026-08-28T04:07:32.324855+00:00, sha 3efaa7673a8b)
  - registry_pypi: https://pypi.org/pypi/ytmusicapi/json (fetched 2026-08-29T09:47:51.915501+00:00, sha 6ff24fcb3918)
- Data as of 2026-08-30T08:39:29.467469+00:00.