API-Dokumentation

Was das ist

Eine JSON-API über dieselben Daten, die auch die Website nutzt: Zu einem Vornamen liefert sie das wahrscheinliche Geschlecht, eine männliche Wahrscheinlichkeit, eine Länderübersicht sowie fertige deutsche und englische Anreden. Kein Konto, kein Schlüssel, keine Rate-Limit-Header zu konfigurieren — einfach aufrufen.

GET /api/check — einen Namen abfragen

Namen als Query-Parameter übergeben. Funktioniert mit lateinischen und chinesischen Namen.

GET https://dearwho.vercel.app/api/check?name=Andrea

Beispielantwort

{
  "query": "Andrea",
  "kind": "latin",
  "canonicalSlug": "andrea",
  "record": {
    "name": "Andrea",
    "verdict": "country_dependent",
    "p": 0.31,
    "confidence": "high",
    "countries": [
      {
        "cc": "it",
        "f": 12,
        "p": 0.98
      },
      {
        "cc": "de",
        "f": 9,
        "p": 0.02
      },
      {
        "cc": "us",
        "f": 8,
        "p": 0.013
      }
    ]
  },
  "greeting": {
    "en": "Dear Andrea Rossi,",
    "de": "Guten Tag Andrea Rossi,"
  },
  "url": "https://dearwho.vercel.app/name/andrea",
  "urlDe": "https://dearwho.vercel.app/de/name/andrea",
  "source": "DearWho - nam_dict (GFDL) + US SSA. Cite: https://dearwho.vercel.app/name/andrea"
}

POST /api/check — Listenabfrage

Bis zu 200 Namen auf einmal senden und für jeden ein kompaktes Verdikt in derselben Reihenfolge erhalten.

POST https://dearwho.vercel.app/api/check
Content-Type: application/json

{"names": ["Andrea", "Kim", "Wei"]}

POST /api/greeting — Anrede erzeugen

Vollständigen Namen, Zielsprache und Formalitätsstufe senden; zurück kommt eine fertige Anrede plus die Varianten für die anderen Geschlechter.

POST https://dearwho.vercel.app/api/greeting
Content-Type: application/json

{"fullName": "Andrea Rossi", "lang": "en", "formality": "formal", "gender": "auto"}

Fertige Code-Beispiele

Dieselbe Abfrage in vier gängigen Werkzeugen.

curl "https://dearwho.vercel.app/api/check?name=Andrea"

fetch("https://dearwho.vercel.app/api/check?name=Andrea")
  .then((res) => res.json())
  .then((data) => console.log(data.record.verdict, data.source));

import requests

response = requests.get("https://dearwho.vercel.app/api/check", params={"name": "Andrea"})
data = response.json()
print(data["record"]["verdict"], data["source"])

=IMPORTDATA("https://dearwho.vercel.app/api/check?name=" & A1)

Ratenlimits und faire Nutzung

Aktuell gibt es kein hartes Ratenlimit, aber der Betrieb läuft auf einem einzelnen kleinen Server: Bulk-Anfragen bitte auf oder unter der 200-Namen-Grenze halten, Ergebnisse auf Ihrer Seite zwischenspeichern statt denselben Namen wiederholt abzufragen, und einen echten User-Agent setzen, damit wir Sie bei Bedarf erreichen können. Starker oder missbräuchlicher Traffic kann ohne Vorwarnung gedrosselt werden.

Lizenz und Attribution

Die zugrunde liegenden Namensdaten stammen aus dem nam_dict-Projekt und stehen unter der GNU Free Documentation License (GFDL); US-Werte sind mit gemeinfreien Statistiken der Social Security Administration kombiniert. Wer Ergebnisse in größerem Umfang weiterverbreitet oder anzeigt, nennt DearWho als Quelle und verlinkt auf die passende Namensseite — jede Antwort enthält diesen Link bereits im Feld "source". Vollständige Attribution und Quellenliste:

Maschinenlesbare Spezifikation

Das vollständige OpenAPI-3.1-Dokument, um einen Client zu generieren oder eine Custom-GPT-Action einzurichten.

MCP-Server

Ein schreibgeschützter MCP-Server für diese API ist in Arbeit, zur direkten Nutzung in Claude und ChatGPT.