Vornamencheck

Männlich oder weiblich? Pro Vorname und Land.

Eine HTTP-GET-Schnittstelle liefert zu jedem Vornamen die Wahrscheinlichkeit, bezogen auf ein Land. Was einmal ermittelt ist, liegt danach in der Kartei.

Namensabfrage

Deutschland

Rückseite · Rohdaten

Aufruf

Antwort


                        

                    

                    
                

            

        


        

            
Was bei einer Anfrage passiert

            

                
    
                    
  1. AnfrageSie senden Vorname und Ländercode per HTTP-GET, etwa /api/v1/names/Andrea/gender?culture=IT.
    2. 
                    
  2. KarteiLiegt die Kombination aus Name und Land schon vor, kommt die Antwort sofort aus der Datenbank.
    3. 
                    
  3. NeuUnbekannte Namen ermittelt ein KI-Modell (Claude) einmalig für genau dieses Land. Das Ergebnis wird abgelegt, jede weitere Anfrage kommt aus der Kartei.
    4. 
                

                
Deshalb dauert der erste Aufruf eines neuen Namens ein paar Sekunden, alle weiteren nicht. Und deshalb kann derselbe Name je nach Land anders ausfallen: Andrea ist in Deutschland meist weiblich, in Italien meist männlich.

            

        


        

            
Die Schnittstelle

            

                

                    
Aufruf

                    
GET https://vornamencheck.de/api/v1/names/{name}/gender
GET https://vornamencheck.de/api/v1/names/gender?name={name}

                    
Parameter

                    

                        
                        
cultureLändercode nach ISO 3166-1 alpha-2, Standard DE. Ungültige Werte ergeben 400.

                        
guessmale oder female. Die Antwort enthält dann check: ob die Vermutung stimmt.

                        
idWird unverändert zurückgegeben, etwa Ihre Datensatz-ID.

                        
                    

                

                

                    
Antwort für Anna mit guess=female

                    
{
  "name": "Anna",
  "gender": "female",
  "culture": "DE",
  "guess": "female",
  "check": true,
  "statistics": {
    "maleProbability": 0,
    "femaleProbability": 10
  },
  "infoMessage": ""
}

                    
Die Wahrscheinlichkeiten sind ganze Zahlen von 0 bis 10. Sind beide gleich, lautet gender unknown.

                

            

        


        

            
Zugang

            

                
Die API ist derzeit ohne Anmeldung und ohne Schlüssel nutzbar. Pro IP-Adresse gilt ein Limit von einer Anfrage pro Sekunde, kurzzeitig bis zu fünf.

                
API-Schlüssel mit höheren Limits für den produktiven Einsatz sind in Planung. Wenn Sie mehr Anfragen brauchen oder Fragen haben, schreiben Sie uns.

                info@vornamencheck.de