ForHosting KIT · SEO

Schema.org-Felder: erforderlich und empfohlen

Die Wahl eines Schema.org-Typs ist nur der erste Schritt zu hilfreichen strukturierten Daten.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Die enthaltenen Eigenschaften entscheiden darüber, ob Suchmaschinen und andere Systeme die Seite verstehen können. Diese Abfrage nimmt bekannte Typnamen wie Article, Product, Recipe oder FAQPage entgegen und liefert sofort eine praktische Feldliste. Sie trennt üblicherweise erforderliche Eigenschaften von empfohlenen Ergänzungen, verwendet kanonische Namen und weist unbekannte Typen eindeutig zurück. Automatisierte Abläufe arbeiten dadurch nie unbemerkt mit einer bloßen Vermutung weiter.

Beginnen Sie mit dem Typ, der Ihre Seite genau beschreibt

Strukturierte Daten funktionieren am besten, wenn der gewählte Typ das Hauptthema der Seite beschreibt und nicht nur ein kleines Element darauf. Geben Sie beispielsweise Product für einen käuflichen Artikel, Recipe für eine Kochanleitung, Article für redaktionelle Inhalte oder LocalBusiness für ein Unternehmen mit einem physischen Standort ein. Bei der Abfrage spielt die Groß- und Kleinschreibung keine Rolle. Sie können außerdem die vollständige schema.org-URL eines Typs angeben, was bei Werten aus einem vorhandenen JSON-LD-Dokument praktisch ist. Die Antwort enthält den kanonischen Namen und die kanonische URL sowie zwei geordnete Eigenschaftslisten. Befindet sich der Name nicht im unterstützten Katalog, meldet die Funktion einen Eingabefehler, statt eine ungefähre Übereinstimmung zu erfinden. In Veröffentlichungsabläufen stoppt ein Tippfehler wie Productt deshalb den Build, anstatt scheinbar plausibles Markup ohne definierte Bedeutung zu erzeugen. Wählen Sie den genauesten unterstützten Typ. Die Abfrage konzentriert sich auf verbreitete SEO-Typen und deckt nicht jede Klasse des vollständigen Schema.org-Vokabulars ab.

Verstehen Sie die Felder als praktische Implementierungsliste

Schema.org ist ein Vokabular und schreibt Eigenschaften nicht generell wie ein Datenbankschema vor. Suchfunktionen, Validatoren und nachgelagerte Systeme legen eigene Eignungsregeln fest, die je nach Plattform und Darstellung variieren können. Die Liste der erforderlichen Felder bezeichnet daher Eigenschaften, die in SEO-Implementierungen üblicherweise als sinnvolle Mindestausstattung gelten. Empfohlene Felder verbessern meist Vollständigkeit, Eignung oder Qualität eines angezeigten Ergebnisses. Verknüpfen Sie zunächst jede erforderliche Eigenschaft mit echten, sichtbaren Seiteninformationen. Ergänzen Sie empfohlene Eigenschaften nur, wenn zuverlässige Quelldaten vorhanden sind. Erfinden Sie niemals Bewertungen, Preise, Verfasser, Bilder, Verfügbarkeit oder Daten, um die Liste zu füllen. Ein kürzeres, im Seiteninhalt verankertes Objekt ist sicherer als umfangreiches Markup, das dem sichtbaren Inhalt widerspricht. Einige Eigenschaften enthalten verschachtelte Objekte, etwa offers bei Product, author bei Article, location bei Event und mainEntity bei FAQPage. Diese Abfrage nennt die übergeordneten Eigenschaften, erzeugt aber keine verschachtelten Werte und validiert keinen vollständigen JSON-LD-Graphen.

Nutzen Sie deterministische Ergebnisse in Prüfabläufen

Da die Abfrage einen festen Katalog im Arbeitsspeicher ohne Netzwerk, Modelle, Zufall oder Uhrzeitabhängigkeit verwendet, erzeugt derselbe unterstützte Typ stets dasselbe geordnete Ergebnis. Das eignet sich für wiederholbare Inhaltsprüfungen, Formularersteller, Schema-Vorlagen, Migrationsskripte und kontinuierliche Integrationskontrollen. Ein CMS kann die Liste abrufen, sobald die Redaktion einen Inhaltstyp auswählt, fehlende Pflichteingaben markieren und empfohlene Ergänzungen getrennt darstellen. Ein Prüfwerkzeug kann vorhandene JSON-LD-Schlüssel mit der Antwort vergleichen und Lücken melden, ohne jede Empfehlung zum Fehler zu erklären. Ein Generator kann die kanonische URL verwenden und die geordnete Liste für eine vorhersehbare Oberfläche beibehalten. Betrachten Sie das Ergebnis als praktischen Ausgangspunkt und prüfen Sie die aktuelle Dokumentation jeder Suchplattform, deren Rich Results geschäftskritisch sind; plattformspezifische Regeln gehören nicht zu diesem Offline-Katalog. Eine API-Anfrage kostet $0.002; im Browser läuft dieselbe reine Logik. Ein nicht unterstützter Typ erzeugt absichtlich einen Eingabefehler mit dem übermittelten Namen und den zulässigen Auswahlmöglichkeiten.

Anwendungsfälle

Eine JSON-LD-Vorlage planen

Rufen Sie eine stabile Liste ab, bevor Sie CMS-Felder für eine neue Vorlage strukturierter Daten entwerfen.

Fehlende Eigenschaften prüfen

Vergleichen Sie vorhandene Markup-Schlüssel mit gängigen Mindest- und Zusatzfeldern des angegebenen Typs.

Die Inhaltsredaktion unterstützen

Zeigen Sie bei der Typauswahl zuerst erforderliche Eingaben und danach empfohlene Ergänzungen an.

Häufige Fragen

Schreibt Schema.org selbst diese Felder vor?

Nein. Schema.org definiert ein Vokabular, verlangt aber normalerweise keine Eigenschaften. Die Pflichtliste bildet übliche SEO-Mindestangaben ab.

Was geschieht bei einem unbekannten Typ?

Die Anfrage liefert einen Eingabefehler und nennt die unterstützten kanonischen Namen. Ein Ersatz wird niemals erraten.

Kann ich eine vollständige Schema.org-URL angeben?

Ja. Ein Wert wie https://schema.org/Product wird zum kanonischen Typ Product normalisiert.

Enthält das Ergebnis verschachtelte Eigenschaftsstrukturen?

Nein. Es nennt gängige übergeordnete Eigenschaften. Verschachtelte Objekte wie Offer, Person oder PostalAddress müssen Sie separat erstellen und validieren.

Was kostet eine Abfrage über die API?

Jede API-Anfrage kostet $0.002. Der Algorithmus ist deterministisch und ruft keinen externen Dienst auf.

Für Entwickler — API-Zugang

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

Endpunkt

POSThttps://api.kit.forhosting.com/seo/schema-type-lookup

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

Aufruf aus Ihrem Stack

curl -X POST https://api.kit.forhosting.com/seo/schema-type-lookup \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"Product"}'

const res = await fetch("https://api.kit.forhosting.com/seo/schema-type-lookup", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "type": "Product"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/seo/schema-type-lookup",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "type": "Product"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/seo/schema-type-lookup", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"type":"Product"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"type":"Product"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/seo/schema-type-lookup", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "type": "Product"
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "seo.schema_type_lookup",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Preis

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →