SEO-Audit-API-Dokumentation

Tätigen Sie Ihren ersten API-Aufruf in Sekunden. Senden Sie eine GET-Anfrage mit der Ziel-URL:

curl "https://www.auditme.dev/api/v1/audit?url=https://example.com"

Keine Authentifizierung erforderlich. Sie erhalten eine JSON-Antwort mit einem vollständigen SEO-Audit der angegebenen Seite.

Der Audit-Endpunkt akzeptiert eine Ziel-URL als Query-Parameter und liefert ein JSON-Objekt mit der vollständigen SEO-Analyse. Die Antwort erfolgt in der Regel innerhalb von 5–15 Sekunden, abhängig von der Größe der Zielseite.

Alle Parameter werden als Query-String-Parameter in der GET-Anfrage übergeben.

Die API liefert ein JSON-Objekt mit der folgenden Struktur auf oberster Ebene:

{
  "success": true,
  "url": "https://example.com",
  "audit": {
    "meta": {
      "title": "Example Domain",
      "titleLength": 13,
      "description": "This domain is for use in...",
      "descriptionLength": 36,
      "h1": ["Example Domain"],
      "canonical": "https://example.com",
      "ogTitle": "Example Domain",
      "ogDescription": "This domain is for use in...",
      "ogImage": "https://example.com/image.png"
    },
    "performance": {
      "lcp": 1.2,
      "inp": 85,
      "cls": 0.05,
      "fcp": 0.8,
      "ttfb": 120,
      "score": 92
    },
    "schema": {
      "valid": true,
      "types": ["WebPage", "Organization"],
      "errors": [],
      "warnings": []
    },
    "content": {
      "score": 78,
      "wordCount": 1250,
      "readabilityScore": "A",
      "keywordDensity": 2.1
    },
    "links": {
      "internal": 12,
      "external": 3,
      "broken": 0
    },
    "images": {
      "total": 5,
      "missingAlt": 0
    },
    "overallScore": 85
  }
}

Die API erzwingt eine Ratenbegrenzung von 10 Anfragen pro Minute pro IP-Adresse. Das ist für die meisten Monitoring-, Reporting- und Entwicklungszwecke mehr als ausreichend.

Wenn Sie für Produktionslasten oder Unternehmensanwendungen höhere Ratenbegrenzungen benötigen, wenden Sie sich an unser Team für einen individuellen Tarif.

Nutzen Sie die API aus jeder Sprache, die HTTP-Anfragen unterstützt. Hier finden Sie Beispiele in JavaScript und Python:

JavaScript (fetch)

async function auditUrl(url) {
  const response = await fetch(
    `https://www.auditme.dev/api/v1/audit?url=${encodeURIComponent(url)}`
  );

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

  const data = await response.json();
  console.log("Overall Score:", data.audit.overallScore);
  console.log("Meta Title:", data.audit.meta.title);
  console.log("LCP:", data.audit.performance.lcp + "s");

  return data;
}

auditUrl("https://example.com");

Python (requests)

import requests
from urllib.parse import urlencode

def audit_url(url):
    params = {"url": url}
    response = requests.get(
        "https://www.auditme.dev/api/v1/audit",
        params=params
    )
    response.raise_for_status()
    data = response.json()

    print(f"Overall Score: {data['audit']['overallScore']}")
    print(f"Meta Title: {data['audit']['meta']['title']}")
    print(f"LCP: {data['audit']['performance']['lcp']}s")

    return data

audit_url("https://example.com")

cURL

# Basic GET request
curl "https://www.auditme.dev/api/v1/audit?url=https://example.com"

# With text format
curl "https://www.auditme.dev/api/v1/audit?url=https://example.com&format=text"

# Pretty-print JSON output
curl -s "https://www.auditme.dev/api/v1/audit?url=https://example.com" | jq .

apiDocs.widgetDesc

apiDocs.widgetEmbedTitle

Image

<!-- Simple badge -->
<img src="https://www.auditme.dev/api/widget?domain=example.com" alt="SEO Score" style="border:0" />

<!-- Custom color and size -->
<img src="https://www.auditme.dev/api/widget?domain=example.com&color=3b82f6&size=large" alt="SEO Score" style="border:0" />

Iframe

<!-- Clickable badge (opens audit report) -->
<iframe
  src="https://www.auditme.dev/api/widget?domain=example.com&format=iframe"
  width="200" height="56" style="border:0"
  loading="lazy" title="SEO Score"
></iframe>