Kostenlos · Keine Registrierung

API für Entwickler

Zugriff auf über 1.800 Persönlichkeiten aus Geschichte, Kultur und Wissenschaft. Perfekt für Apps, Websites und Datenanalysen.

Endpunkte

100

Requests/Min

JSON

Format

Blitzschnell

Durchschnittliche Response-Zeit unter 50ms. Optimiert für Performance.

Rate-Limiting

Faire Nutzung für alle: 100 Requests pro Minute pro IP-Adresse.

Einfach zu nutzen

RESTful API mit klaren Endpunkten. Keine Authentifizierung nötig.

API-Endpunkte

Personensuche

GET /api/search

Suche nach Personen anhand des Namens. Unterstützt Fuzzy-Matching und Aliase.

Parameter

q (string, required) - Suchbegriff (Name der Person)

Response

{
  "person": {
    "id": 123,
    "name": "Albert Einstein",
    "birthDate": "1879-03-14",
    "birthPlace": "Ulm, Deutschland",
    "occupation": "Physiker",
    "description": "Entwickler der Relativitätstheorie",
    "portraitImage": "https://...",
    "wikipediaUrl": "https://de.wikipedia.org/wiki/Albert_Einstein"
  },
  "redirectedFrom": null,
  "fuzzyMatch": false
}

Beispiel (curl)

curl "https://wiealtist.de/api/search?q=Einstein"

Beispiel (JavaScript)

const response = await fetch(
  'https://wiealtist.de/api/search?q=Einstein'
);
const data = await response.json();
console.log(data.person.name); // "Albert Einstein"

Autocomplete-Vorschläge

GET /api/suggestions

Erhalte Vorschläge für die Autovervollständigung. Ideal für Suchfelder.

Parameter

q (string, required) - Suchbegriff (min. 2 Zeichen)

Response

{
  "suggestions": [
    {
      "id": 123,
      "name": "Albert Einstein",
      "occupation": "Physiker",
      "birthDate": "1879-03-14"
    },
    {
      "id": 456,
      "name": "Albert Schweitzer",
      "occupation": "Arzt",
      "birthDate": "1875-01-14"
    }
  ]
}

Beispiel (curl)

curl "https://wiealtist.de/api/suggestions?q=Alb"

Statistiken

GET /api/stats

Anzahl der Personen in der Datenbank. Gecacht für 1 Stunde.

Parameter

Keine Parameter erforderlich

Response

{
  "count": 1848,
  "rounded": 1850,
  "formatted": "1.850"
}

Beispiel (curl)

curl "https://wiealtist.de/api/stats"

Rate-Limiting

Alle API-Endpunkte sind durch Rate-Limiting geschützt, um faire Nutzung für alle zu gewährleisten.

100 Requests pro Minute pro IP-Adresse

Separate Limits pro Endpunkt

Rollierendes Zeitfenster (60 Sekunden)

Response-Header

X-RateLimit-Limit: 100

X-RateLimit-Remaining: 95

X-RateLimit-Reset: 2025-10-20T21:45:00.000Z

Bei Überschreitung

Status: 429 Too Many Requests

{
  "error": "Zu viele Anfragen. Bitte versuche es in einer Minute erneut.",
  "retryAfter": "45s"
}

Haftungsausschluss

Keine Gewährleistung

Die API wird „wie besehen" bereitgestellt. Wir übernehmen keine Gewähr für:

• Richtigkeit: Daten stammen aus öffentlichen Quellen und können Fehler enthalten
• Verfügbarkeit: Die API kann jederzeit geändert oder abgeschaltet werden
• Vollständigkeit: Nicht alle Personen sind in der Datenbank enthalten
• Aktualität: Daten werden täglich aktualisiert, können aber veraltet sein

Nutzungsbedingungen

• Keine kommerzielle Nutzung ohne vorherige Genehmigung
• Automatisierte Anfragen müssen Rate-Limits respektieren
• Wir haften nicht für Schäden durch Nutzung der API
• API-Endpunkte und Formate können sich ohne Vorankündigung ändern

Datenquellen

Alle Daten stammen aus Wikipedia (CC BY-SA 3.0) und Wikidata (CC0 1.0). Bei Nutzung der Daten müssen die entsprechenden Lizenzen beachtet werden.

Bei Fragen oder Problemen: Impressum