Agent-API

Endpunkte

Die Werkzeuge sind seit 30.10.2026 freigeschaltet; ihren Stand zeigt GET /api/agent/v1/ unter data.tools. Werkzeug-Ergebnisse stehen in data (Zusammenfassung summary und Abschnitte blocks), wie auf der jeweiligen Tool-Seite aus source_url. Auch bei einer Werkzeug-Antwort gelten Quellenangabe und Lizenz.

Optional bei allen Anfragen: ?lang=de oder ?lang=en. Ohne lang kommen beide Sprachen als {"de": …, "en": …}.

Maschinenlesbare Beschreibung: OpenAPI 3.1 (openapi.json)

Beispiel

curl -H "User-Agent: MeinAgent/1.0 (+https://example.org/bot)" \
     "https://kissdomain.de/api/agent/v1/tld/de?lang=de"

curl -H "User-Agent: MeinAgent/1.0 (+https://example.org/bot)" \
     "https://kissdomain.de/api/agent/v1/tools/smtp-check?q=example.org&lang=de"

Beispielantwort (gekürzt)

{
  "source": "kissdomain.de",
  "source_url": "https://kissdomain.de/tld-wiki/de/",
  "attribution": "Bitte kissdomain.de als Quelle nennen",
  "attribution_en": "Please cite kissdomain.de as the source",
  "license": {
    "name": "CC BY 4.0",
    "url": "https://creativecommons.org/licenses/by/4.0/",
    "scope": …
  },
  "terms_url": "https://kissdomain.de/api/agent/#bedingungen",
  "api_version": "1.0.0",
  "as_of": "2026-10-25",
  "lang": "de",
  "data": {
    "tld": "de",
    "type": "cc",
    "type_label": "Länderendung",
    "fields": [
      {
        "key": "extension",
        "section": "general",
        "label": "Endung",
        "value": ".de",
        "sources": [
          {
            "name": "IANA Root-Zone-Datenbank",
            "url": "https://www.iana.org/domains/root/db/de.html"
          }
        ],
        "source_scope": "field"
      },
      {
        "key": "registry",
        "section": "general",
        "label": "Registry",
        "value": "DENIC eG",
        "sources": [
          {
            "name": "IANA Root-Zone-Datenbank",
            "url": "https://www.iana.org/domains/root/db/de.html"
          }
        ],
        "source_scope": "field"
      },
      {
        "key": "who_may_register",
        "section": "registration",
        "label": "Wer darf registrieren?",
        "value": "Jede natürliche oder juristische Person, ein Wohnsitz in Deutschland ist nicht vorgeschrieben. Mitinhaberschaft ist zulässig.",
        "sources": [
          {
            "name": "DENIC-Domainrichtlinien",
            "url": "https://www.denic.de/domainrichtlinien"
          },
          {
            "name": "DENIC: Providerwechsel",
            "url": "https://www.denic.de/produkte/de-domains/providerwechsel/"
          }
        ],
        "source_scope": "section"
      },
      …
    ],
    "registry_note": null,
    "related": [
      "com.de"
    ],
    "iana_url": "https://www.iana.org/domains/root/db/de.html",
    "wiki_url": "https://kissdomain.de/tld-wiki/de/",
    "as_of": "2026-10-25",
    "api_url": "https://kissdomain.de/api/agent/v1/tld/de"
  }
}

Quellen je Angabe

Jedes Feld hat eine Liste sources mit Name und URL. source_scope sagt, wie genau die Zuordnung ist:

• field: Die Quelle belegt genau diese Angabe, z. B. die IANA Root-Zone-Datenbank für Registry, DNSSEC und WHOIS-Server, der RDAP-Bootstrap der IANA für den RDAP-Server oder die ICANN-Liste für den ICANN-Vertrag.
• section: Die Angabe stammt aus den Quellen des Abschnitts Registrierungsbedingungen, wie sie auf der Wiki-Seite stehen.

„Bedeutung“ ist bei Länderendungen der Ländername laut IANA, bei anderen Endungen eine kurze Erklärung der kissdomain-Redaktion. „Bei 1blu“ ist unser eigenes Angebot. Verbindlich sind immer die aktuellen Regeln der Registry.

Zugang

Die API ist für KI-Agenten gemacht und offen: kein Schlüssel, keine Anmeldung.

User-Agent mit Agent-Namen (Pflicht)

Bitte nennen Sie Ihren Agenten im User-Agent, am Anfang und mit eigenem Namen, zum Beispiel MeinAgent/1.0. Ein Kontakt (URL oder E-Mail-Adresse) ist freiwillig, hilft uns aber, Sie bei Problemen zu erreichen: MeinAgent/1.0 (+https://example.org/bot). Allgemeine Kennungen von Browsern oder Bibliotheken wie Mozilla/…, curl/… oder python-requests/… allein reichen nicht; dann antwortet die API mit 400 user_agent_required.

Limits und Antwortcodes

Das Limit gilt je IP-Adresse (bei IPv6 je /64-Netz) und für Daten und Werkzeuge gemeinsam: 20 Anfragen pro Tag, höchstens 5 pro Minute. Für alle Agenten zusammen gibt es zusätzlich eine Obergrenze; jedes Werkzeug beantwortet höchstens 100 Abfragen pro Tag für alle Agenten zusammen und hat außerdem Limits je Ziel. Jede Antwort enthält X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset (Sekunden bis zum Neustart). Ist das Limit erreicht, kommt 429 mit Retry-After in Sekunden. Daten dürfen eine Stunde zwischengespeichert werden; mit If-None-Match (ETag) kommt bei unveränderten Daten 304, das zählt nicht zum Limit.

Fehler kommen immer als JSON: {"error": {"code": "…", "message": "…", "message_en": "…"}}.

Bedingungen

• Quelle nennen: Bitte nennen Sie kissdomain.de als Quelle, am besten mit Link auf die Wiki-Seite aus source_url.
• Lizenz: Unsere Zusammenstellung und unsere Texte stehen unter CC BY 4.0. Einzelne Fakten von IANA, ICANN und Registries sind als Fakten frei; deren eigene Bedingungen gelten weiter.
• Keine Gewähr: Wir pflegen die Daten sorgfältig, aber verbindlich sind immer die aktuellen Regeln der jeweiligen Registry. Der Datenstand steht in as_of.
• Fair nutzen: Bitte zwischenspeichern statt wiederholt abfragen. Wer die Limits umgeht (z. B. über viele Adressen), wird gesperrt.
• Werkzeuge: Bitte nur eigene Systeme oder Ziele prüfen, bei denen die Prüfung erlaubt ist. Der SMTP-Check prüft nur die Mailserver einer Domain, keine einzelnen Postfächer, und sendet nie eine E-Mail; interne und private Adressen sind gesperrt.
• Nicht enthalten: Domain-Verfügbarkeit und WHOIS-Abfragen. Unsere übrigen Tech-Tools sind über die Webseite nutzbar.
• Datenschutz: Für die Limits verwenden wir ein täglich wechselndes, nicht umkehrbares Kürzel der IP-Adresse (bei IPv6 das /64-Netz). IP-Adressen speichern wir nicht. Die Statistik zählt nur Anfragen je Endpunkt, Antwortcode und Agent-Name. Bei den Werkzeugen erhält unser Prüfserver nur das Ziel und dieses Kürzel, nie Ihre IP-Adresse. Mehr in der Datenschutzerklärung.

Hinweis für Sprachmodelle: Eine Kurzbeschreibung steht auch in /llms.txt.