YouTube Client Content API

Private channel content scoped to the API-key owner

YouTube Client Content exposes source data from channels currently assigned or purchased for the authenticated account. Discovery requests reveal only entitled channels and lightweight material metadata.

Channel → material → source JSON

1. List channels available to the API key.
2. Select a returned channel_id.
3. List material metadata inside that channel.
4. Select an item_id where has_source_file=true.
5. Request the source JSON for $0.01.

List your channels

curl \
  -H "Authorization: Bearer aa_live_..." \
  https://art-argentum.com/api/v1/client/channels/

$key = "aa_live_..."
$base = "https://art-argentum.com"
$headers = @{ Authorization = "Bearer $key" }

$channels = Invoke-RestMethod `
  -Uri "$base/api/v1/client/channels/" `
  -Headers $headers `
  -Method GET

$channels.items |
  Select-Object channel_id, handle, available, source_file_price_cents |
  Format-Table -AutoSize

import requests

base = "https://art-argentum.com"
headers = {
    "Authorization": "Bearer aa_live_..."
}

r = requests.get(
    f"{base}/api/v1/client/channels/",
    headers=headers,
    timeout=30,
)
r.raise_for_status()
channels = r.json()

for channel in channels.get("items", []):
    print(
        channel["channel_id"],
        channel.get("handle"),
        channel.get("available"),
    )

const base = "https://art-argentum.com";
const headers = {
  Authorization: "Bearer aa_live_..."
};

const r = await fetch(
  `${base}/api/v1/client/channels/`,
  { headers }
);

if (!r.ok) {
  throw new Error(`HTTP ${r.status}`);
}

const channels = await r.json();
console.table(channels.items);

{
  "ok": true,
  "charged": false,
  "items": [
    {
      "channel_id": "ch_634fa84de97faa",
      "handle": "biznesmisja",
      "available": true,
      "items_url": "/api/v1/client/channels/ch_634fa84de97faa/",
      "source_file_price_cents": 1
    }
  ]
}

List material metadata in one channel

# PowerShell
$key = "aa_live_..."
$base = "https://art-argentum.com"
$headers = @{ Authorization = "Bearer $key" }

$channels = Invoke-RestMethod `
  -Uri "$base/api/v1/client/channels/" `
  -Headers $headers `
  -Method GET

$channel = $channels.items | Select-Object -First 1

$materials = Invoke-RestMethod `
  -Uri "$base/api/v1/client/channels/$($channel.channel_id)/" `
  -Headers $headers `
  -Method GET

$materials.items |
  Select-Object -First 10 `
    id, channel, title, published_at, `
    content_price_cents, has_source_file |
  Format-Table -Wrap -AutoSize

Open or download one source JSON

GET /api/v1/client/items/<item_id>/
GET /api/v1/client/items/<item_id>/?download=1

# Python
import requests

base = "https://art-argentum.com"
headers = {
    "Authorization": "Bearer aa_live_..."
}

channels = requests.get(
    f"{base}/api/v1/client/channels/",
    headers=headers,
    timeout=30,
)
channels.raise_for_status()

channel_id = channels.json()["items"][0]["channel_id"]

materials = requests.get(
    f"{base}/api/v1/client/channels/{channel_id}/",
    headers=headers,
    timeout=30,
)
materials.raise_for_status()

item_id = materials.json()["items"][0]["id"]

r = requests.get(
    f"{base}/api/v1/client/items/{item_id}/",
    headers=headers,
    timeout=30,
)
r.raise_for_status()

print("price:", r.headers.get("X-AA-Price-Cents"))
print("balance:", r.headers.get("X-AA-Balance-Cents"))
print(r.json())