REST-API Dokumentation

Programmatische llms.txt-Generierung für Agency-Kunden. Crawlen Sie Websites und erzeugen Sie strukturierte KI-Dateien – vollautomatisch per API-Aufruf.

1. Authentifizierung

Jeder API-Request muss authentifiziert werden. Ihr API-Key ist identisch mit Ihrem Agency-Lizenzschlüssel (Format: LLMS-XXXX-XXXX-XXXX-XXXX).

Es gibt drei Möglichkeiten, den Key zu übergeben (in Prioritätsreihenfolge):

Pro- und Free-Keys erhalten bei API-Zugriff einen 403-Fehler mit Hinweis auf den Agency-Upgrade-Pfad.

2. Endpunkte

Alle Endpunkte liegen unter der Basis-URL:

https://www.llmstxtgenerator.de/api/generate.php

3. Website generieren (POST)

Request-Body (JSON)

Ablauf im Detail

Nach dem Empfang Ihres Requests durchläuft die API folgende Schritte:

1. Sitemap-Suche – Die API prüft /sitemap.xml, /sitemap_index.xml, /wp-sitemap.xml und parsed zusätzlich /robots.txt nach Sitemap-Einträgen. Sitemap-Indizes werden rekursiv aufgelöst.

2. Fallback auf Homepage-Links – Findet sich keine Sitemap, werden alle internen Links der Homepage extrahiert.

3. Metadaten-Crawling – Für jede URL werden <title>, <meta description>, <h1> und Schema.org @type-Annotationen extrahiert.

4. Kategorisierung – Jede URL wird automatisch kategorisiert (Hauptseiten, Produkte, Kategorien, Blog, Ratgeber, FAQ, Über uns, Rechtliches) anhand von URL-Pfaden und Schema.org-Typen.

5. Generierung – Aus den Metadaten wird eine strukturierte llms.txt und eine erweiterte llms-full.txt erzeugt.

4. Status & Kontingent (GET)

GET /api/generate.php?action=status
Header: X-API-Key: LLMS-XXXX-XXXX-XXXX-XXXX

Response

{
  "status": "active",
  "plan": "agency-monthly",
  "expires": "2026-04-22",
  "usage_today": {
    "requests": 12,
    "limit": 100,
    "remaining": 88,
    "urls_crawled": 340
  }
}

5. Response-Struktur

Eine erfolgreiche Generierung liefert folgende JSON-Struktur:

{
  "success": true,
  "url": "https://example.com",
  "pages_found": 87,
  "pages_crawled": 50,
  "duration_seconds": 14.3,
  "llms_txt": "# Example.com\n> Beschreibung...\n\n## Hauptseiten\n...",
  "llms_full_txt": "# example.com – Vollständige Seitenübersicht\n...",
  "generated_at": "2026-02-22T15:30:00+01:00",
  "warnings": ["https://example.com/old-page: HTTP 404"]
}

6. Code-Beispiele

curl -X POST https://www.llmstxtgenerator.de/api/generate.php \
  -H "Content-Type: application/json" \
  -H "X-API-Key: LLMS-XXXX-XXXX-XXXX-XXXX" \
  -d '{"url": "https://example.com", "max_urls": 100}'

import requests

response = requests.post(
    "https://www.llmstxtgenerator.de/api/generate.php",
    headers={"X-API-Key": "LLMS-XXXX-XXXX-XXXX-XXXX"},
    json={"url": "https://example.com", "max_urls": 100}
)

data = response.json()

# llms.txt direkt als Datei speichern
with open("llms.txt", "w") as f:
    f.write(data["llms_txt"])

print(f"{data['pages_crawled']} Seiten gecrawlt in {data['duration_seconds']}s")

const response = await fetch(
  "https://www.llmstxtgenerator.de/api/generate.php",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-API-Key": "LLMS-XXXX-XXXX-XXXX-XXXX"
    },
    body: JSON.stringify({
      url: "https://example.com",
      max_urls: 100
    })
  }
);

const data = await response.json();
console.log(data.llms_txt);
console.log(`${data.pages_crawled} Seiten in ${data.duration_seconds}s`);

$ch = curl_init("https://www.llmstxtgenerator.de/api/generate.php");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Content-Type: application/json",
        "X-API-Key: LLMS-XXXX-XXXX-XXXX-XXXX"
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "url" => "https://example.com",
        "max_urls" => 100
    ])
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

// llms.txt direkt als Datei speichern
file_put_contents("llms.txt", $data["llms_txt"]);

echo $data["pages_crawled"] . " Seiten gecrawlt\n";

Praxis-Beispiel: Batch-Generierung für mehrere Kunden

#!/bin/bash
# Monatliche llms.txt-Generierung für alle Kunden
API_KEY="LLMS-XXXX-XXXX-XXXX-XXXX"

KUNDEN=(
  "https://kunde1-shop.de"
  "https://kunde2-agentur.com"
  "https://kunde3-handwerk.de"
)

for url in "${KUNDEN[@]}"; do
  DOMAIN=$(echo "$url" | sed 's|https://||;s|/.*||')
  echo "Generiere: $DOMAIN ..."

  curl -s -X POST https://www.llmstxtgenerator.de/api/generate.php \
    -H "Content-Type: application/json" \
    -H "X-API-Key: $API_KEY" \
    -d "{\"url\": \"$url\", \"max_urls\": 200}" \
    | jq -r '.llms_txt' > "${DOMAIN}-llms.txt"

  echo "  → ${DOMAIN}-llms.txt gespeichert"
  sleep 2  # Fair-Use-Pause
done

import requests, time

API_KEY = "LLMS-XXXX-XXXX-XXXX-XXXX"

kunden = [
    "https://kunde1-shop.de",
    "https://kunde2-agentur.com",
    "https://kunde3-handwerk.de",
]

for url in kunden:
    domain = url.replace("https://", "").replace("/", "")
    print(f"Generiere: {domain} ...")

    r = requests.post(
        "https://www.llmstxtgenerator.de/api/generate.php",
        headers={"X-API-Key": API_KEY},
        json={"url": url, "max_urls": 200},
        timeout=120
    )

    data = r.json()
    if data.get("success"):
        with open(f"{domain}-llms.txt", "w") as f:
            f.write(data["llms_txt"])
        print(f"  → {data['pages_crawled']} Seiten, {data['duration_seconds']}s")
    else:
        print(f"  → Fehler: {data.get('error')}")

    time.sleep(2)  # Fair-Use-Pause

7. Limits & Fair Use

8. Fehlercodes

Fehler-Responses folgen immer diesem Format:

{
  "error": "Beschreibung des Fehlers",
  "code": 422,
  "detail": "Optionale zusätzliche Information"
}

9. Häufige Fragen