ForHosting KIT · Websites auslesen & überwachen

FAQ-JSON-LD erstellen

Wandeln Sie eine freigegebene Liste von Fragen und Antworten in FAQPage-Markup von schema.org um, ohne verschachteltes JSON von Hand zu schreiben.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Der Generator prüft jedes Paar, erhält die gewählte Reihenfolge und liefert sowohl ein strukturiertes Objekt als auch einen vollständigen Script-Block für die betreffende Seite. Er erfindet keine Aussagen und formuliert Ihre Texte nicht um; die strukturierten Daten bleiben daher mit den sichtbaren Inhalten abgestimmt.

Bereiten Sie zuerst die sichtbaren Inhalte vor

Beginnen Sie mit den Fragen und Antworten, die Besucher auf der Seite tatsächlich sehen können. Jede Zeile benötigt eine vollständige Frage und die zugehörige Antwort; beide dürfen weder leer sein noch nur aus Leerzeichen bestehen. Der Generator verfasst, erweitert oder überprüft diese Inhalte nicht. Strukturierte Daten sollen die Seite beschreiben und keine verborgene zweite Fassung erzeugen. Lassen Sie Aussagen, Richtlinien, Preise, Termine und Bedingungen vor der Generierung von den zuständigen Personen prüfen. Verwenden Sie klare Formulierungen, die ohne Navigation oder Werbetext verständlich sind. Lösen Sie Dopplungen in der sichtbaren FAQ und sortieren Sie die Paare wie gewünscht: mainEntity übernimmt diese Reihenfolge exakt. Ändert sich eine Antwort, halten Sie sichtbaren Inhalt und Markup gemeinsam aktuell.

Erzeugen Sie sicheres standardgerechtes Markup

Für jedes Paar erstellt der Generator eine schema.org-Question, speichert die Frage in name und verschachtelt eine Answer unter acceptedAnswer mit der Antwort in text. Die Einträge bilden das mainEntity-Array eines FAQPage-Objekts. Die Ausgabe enthält dieses Objekt für automatisierte Abläufe sowie einen formatierten application/ld+json-Block für HTML. Äußere Leerzeichen werden entfernt; Zeichensetzung und Inhalt bleiben unter Ihrer Kontrolle. Die Serialisierung ist deterministisch: Gleiche Eingaben liefern ohne Netzwerk, Zufall, Modell oder Zeitstempel stets gleiche Ausgaben. Zeichen, die ein HTML-Script-Element stören könnten, werden sicher codiert. JSON stellt weiterhin den ursprünglichen Text her, während der eingefügte Inhalt sein eigenes Script-Element nicht vorzeitig schließen kann.

Veröffentlichen, prüfen und pflegen Sie das Ergebnis

Fügen Sie den zurückgegebenen Block in das HTML der Seite ein, auf der dieselben Fragen und Antworten sichtbar sind. JSON-LD kann meist in head oder body stehen; Ihr CMS bietet eventuell ein eigenes Feld. Verteilen Sie den Block nicht über eine globale Vorlage auf unpassende Seiten, denn er beschreibt eine bestimmte Seite. Kontrollieren Sie nach der Veröffentlichung das gerenderte Dokument: Das application/ld+json-Element muss vorhanden sein und darf nicht als sichtbarer Text erscheinen. Testen Sie anschließend die öffentliche URL mit den Validierungswerkzeugen der relevanten Suchdienste. Gültige Syntax garantiert keine besondere Darstellung, da jeder Dienst eigene Regeln anwendet. Behandeln Sie den Block als zu pflegenden Inhalt: Wenn eine sichtbare Antwort geändert, entfernt oder verschoben wird, erzeugen Sie das JSON-LD neu und veröffentlichen beide Änderungen zusammen.

Anwendungsfälle

Support-FAQ veröffentlichen

Wandeln Sie geprüfte Hilfe-Fragen in konsistentes FAQPage-Markup für denselben öffentlichen Artikel um.

Landingpages automatisieren

Erzeugen Sie bei jedem Build deterministisches JSON-LD aus FAQ-Datensätzen im CMS.

Manuelles Schema ersetzen

Entfernen Sie fehleranfällige Verschachtelung aus dem Redaktionsablauf, ohne freigegebene Texte zu ändern.

Häufige Fragen

Was gibt der Generator zurück?

Er liefert ein Schemaobjekt und einen vollständigen application/ld+json-Script-Block mit denselben FAQPage-Daten.

Verfasst er auch Fragen oder Antworten?

Nein. Er prüft und strukturiert nur Ihren Text; Aussagen werden weder erzeugt noch umgeschrieben oder verifiziert.

Was geschieht bei einem leeren Feld?

Die Anfrage scheitert mit einem Eingabefehler, der die Position der leeren Frage oder Antwort nennt.

Kann der Block sicher in HTML eingefügt werden?

Ja. HTML-empfindliche Zeichen werden bei der JSON-Serialisierung maskiert, damit das Script nicht vorzeitig endet.

Garantiert gültiges FAQPage-Markup ein Rich Result?

Nein. Der Generator erstellt eine gültige Struktur; Suchdienste bestimmen Eignung und Darstellung nach eigenen Regeln.

Was kostet eine API-Anfrage?

Jede API-Anfrage kostet $0.002. Das Webwerkzeug kann dieselbe deterministische Logik lokal ausführen.

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/web/faq-schema-generate

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/web/faq-schema-generate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pairs":[{"question":"How long does delivery take?","answer":"Standard delivery takes three to five business days."},{"question":"Can I change my order?","answer":"Yes. Contact support before the order is dispatched."}]}'

const res = await fetch("https://api.kit.forhosting.com/web/faq-schema-generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "pairs": [
      {
        "question": "How long does delivery take?",
        "answer": "Standard delivery takes three to five business days."
      },
      {
        "question": "Can I change my order?",
        "answer": "Yes. Contact support before the order is dispatched."
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/web/faq-schema-generate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "pairs": [
        {
            "question": "How long does delivery take?",
            "answer": "Standard delivery takes three to five business days."
        },
        {
            "question": "Can I change my order?",
            "answer": "Yes. Contact support before the order is dispatched."
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/faq-schema-generate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"pairs":[{"question":"How long does delivery take?","answer":"Standard delivery takes three to five business days."},{"question":"Can I change my order?","answer":"Yes. Contact support before the order is dispatched."}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"pairs":[{"question":"How long does delivery take?","answer":"Standard delivery takes three to five business days."},{"question":"Can I change my order?","answer":"Yes. Contact support before the order is dispatched."}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/faq-schema-generate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "pairs": [
    {
      "question": "How long does delivery take?",
      "answer": "Standard delivery takes three to five business days."
    },
    {
      "question": "Can I change my order?",
      "answer": "Yes. Contact support before the order is dispatched."
    }
  ]
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "web.faq_schema_generate",
  "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.

Limits

`timeout_sec`	30
`max_crawl_pages`	25

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 →