Authentication

Authentication Overview

To access your personal YouTube Music data (playlists, library, history), you need to authenticate your requests. YTMusicAPI PHP supports several authentication methods:

Browser Method (Recommended)

This is the most reliable method for getting authentication headers. You'll need Firefox for best results, though we have tried to make it work with Chrome as well.

Step 1: Extract Headers from Browser

1. Open Firefox and go to https://music.youtube.com
2. Make sure you're logged in to your Google account
3. Open Developer Tools (F12 or Ctrl/Cmd + Shift + I)
4. Go to the Network tab
5. Click on "Library" in YouTube Music to trigger a request
6. Filter by browse
7. Right-click on a POST request under the name column
8. Select Copy Value → Copy Request Headers

Step 2: Setup Authentication

Run the setup command:

php vendor/bin/setup-ytmusicapi browser

Paste the copied headers when prompted and press Enter twice. This will create a browser.json file.

Step 3: Use Authentication

<?php
require "vendor/autoload.php";

// Use the generated browser.json file
$yt = new Ytmusicapi\YTMusic("browser.json");

// Now you can access your personal data
$playlists = $yt->get_library_playlists();
$history = $yt->get_history();

Cookie Method

For Chrome users or when the browser method doesn't work, you can use cookies directly.

Extract Cookies

1. Go to https://music.youtube.com in your browser
2. Open Developer Tools → Network tab
3. Find a request to a browse or next endpoint
4. Click on the request and go to the Headers tab
5. Copy the Cookie value
6. Copy the X-Goog-Authuser value (usually "0")

Use Cookie Authentication

<?php
require "vendor/autoload.php";

$cookie = "SAPISID=your_sapisid_value; __Secure-3PAPISID=your_secure_value; SID=your_sid_value; ...";
$user = "0"; // X-Goog-Authuser value

$yt = new Ytmusicapi\YTMusic($cookie, $user);

// Access authenticated endpoints
$playlists = $yt->get_library_playlists();

Manual Configuration File

Create a JSON file with the required authentication headers:

{
    "cookie": "SAPISID=your_value; __Secure-3PAPISID=your_value; SID=your_value; ...",
    "x-goog-authuser": "0",
    "x-goog-visitor-id": "your_value"
}

Save this as auth.json and use it:

$yt = new Ytmusicapi\YTMusic("auth.json");

OAuth Setup

OAuth support is available but requires additional setup for custom OAuth credentials.

Step 1: Setup OAuth Credentials

Create your OAuth credentials in your Google Cloud Console. You can create a new OAuth client ID by clicking on Create Credentials and selecting OAuth client ID. Set the application type to TVs and Limited Input Devices and follow the instructions to create a new OAuth client ID. Next, activate the YouTube Data API for your project by clicking on Enabled APIs and Services, then clicking Enable APIs and Services and selecting YouTube Data API v3.

Step 2: Setup Authentication

Run the setup command:

php vendor/bin/setup-ytmusicapi oauth

Step 3: Login to Google

Follow the instructions to login to Google and grant access to your YouTube Music data.

Step 4: Use Authentication

Use the generated oauth.json file:

<?php
// OAuth requires additional credentials from your Google Cloud Console
// which has access to the YouTube Data API. Here we assume you have setup
// those values in your environment variables.
$client_id = getenv("GOOGLE_CLIENT_ID");
$client_secret = getenv("GOOGLE_SECRET_ID");

// Create OAuth credentials
$credentials = new Ytmusicapi\OAuthCredentials($client_id, $client_secret);
$yt = new Ytmusicapi\YTMusic("oauth.json", oauth_credentials: $credentials);

Brand Accounts

Brand accounts are not yet supported.

Authentication Troubleshooting

Testing Authentication

Test your authentication setup with this simple script:

<?php
require "vendor/autoload.php";

try {
    $yt = new Ytmusicapi\YTMusic("browser.json");
    
    // Test authenticated request
    $account = $yt->get_account();
    echo "Authentication successful!\n";
    echo "Account: " . $account->name . "\n";
    
} catch (Exception $e) {
    echo "Authentication failed: " . $e->getMessage() . "\n";
}