Quickstart

import httpx
import time

API_KEY = "your-api-key"
BASE = "https://api.tastelabs.com"
HEADERS = {"X-API-Key": API_KEY}

def extract_brand(url: str) -> dict:
    submit = httpx.post(f"{BASE}/design/submissions", headers=HEADERS, json={"url": url})
    submit.raise_for_status()
    submission_id = submit.json()["submission_id"]
    print(f"Submitted: {submission_id}")

    while True:
        r = httpx.get(f"{BASE}/design/submissions/{submission_id}/result", headers=HEADERS)
        if r.status_code == 409:
            time.sleep(3)
            continue
        r.raise_for_status()
        body = r.json()
        if body["status"] == "completed":
            return body["result"]["design_system"]
        if body["status"] == "failed":
            raise RuntimeError(body.get("error") or "Extraction failed")
        time.sleep(3)

design_system = extract_brand("https://stripe.com")
print(design_system["profile"]["brand_name"])

const API_KEY = "your-api-key";
const BASE = "https://api.tastelabs.com";

async function extractBrand(url: string) {
  const submit = await fetch(`${BASE}/design/submissions`, {
    method: "POST",
    headers: { "X-API-Key": API_KEY, "Content-Type": "application/json" },
    body: JSON.stringify({ url }),
  });
  const { submission_id } = await submit.json();
  console.log(`Submitted: ${submission_id}`);

  while (true) {
    const r = await fetch(`${BASE}/design/submissions/${submission_id}/result`, {
      headers: { "X-API-Key": API_KEY },
    });
    if (r.ok) {
      const body = await r.json();
      if (body.status === "completed") return body.result.design_system;
      if (body.status === "failed") throw new Error(body.error ?? "Failed");
    }
    await new Promise((res) => setTimeout(res, 3000));
  }
}

const ds = await extractBrand("https://stripe.com");
console.log(ds.profile.brand_name);

export API_KEY="your-api-key"
export BASE="https://api.tastelabs.com"

# 1. Submit
SUBMISSION_ID=$(curl -s -X POST $BASE/design/submissions \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://stripe.com"}' | jq -r '.submission_id')

# 2. Poll the result endpoint
while true; do
  RESP=$(curl -s $BASE/design/submissions/$SUBMISSION_ID/result -H "X-API-Key: $API_KEY")
  STATUS=$(echo "$RESP" | jq -r '.status // empty')
  { [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ]; } && break
  sleep 3
done

# 3. Read the design system
echo "$RESP" | jq '.result.design_system'