Art Argentum API Documentation

Make your first API request

Art Argentum API v1 is an authenticated JSON API. Create an API key in the private workspace, send it as a Bearer token, then use the discovery endpoints to locate the data your application needs.

1. Create an API key. The full aa_live_... secret is shown once.
2. Authenticate. Send the secret in the Authorization header.
3. Discover first. Public, Finance Media and Client YouTube discovery requests are free.
4. Fetch source content only when needed. One concrete YouTube source JSON costs $0.01.

Authentication header

Authorization: Bearer aa_live_...

Base URL

https://art-argentum.com

Test the API in your preferred environment

The examples below perform the same read-only request to /api/v1/catalog/. Replace aa_live_... with your real key.

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

$key = "aa_live_..."
$headers = @{ Authorization = "Bearer $key" }

Invoke-RestMethod `
  -Uri "https://art-argentum.com/api/v1/catalog/" `
  -Headers $headers `
  -Method GET

import requests

headers = {
    "Authorization": "Bearer aa_live_..."
}

response = requests.get(
    "https://art-argentum.com/api/v1/catalog/",
    headers=headers,
    timeout=30,
)
response.raise_for_status()

print(response.json())

const response = await fetch(
  "https://art-argentum.com/api/v1/catalog/",
  {
    headers: {
      Authorization: "Bearer aa_live_..."
    }
  }
);

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

const data = await response.json();
console.log(data);

Choose the API feed

What is free and what is billable?

For YouTube feeds, displaying and downloading a source are the same billable action: both return the concrete source file. A failed authentication, missing resource or insufficient-balance response is not a successful source-file delivery.

Billing headers

A successful billable source-file response can include the following headers:

Common HTTP responses