Geschlecht aus bis zu 50 Benutzernamen bestimmen

Übersicht zur Massenanfrage

Bis zu 50 Benutzernamen verarbeiten

Senden Sie einedataArray. GenderAPI extrahiert potenzielle Namenssignale aus jedem Handle und gibt Ergebnisse mit Ihrem optionalen Datensatz zurückid.

MethodPOST

Maximum50 Benutzernamen

AuthenticationBearer-Token

AI-OptionenNicht unterstützt

Bulk-Ergebnisse für Benutzernamen erfordern sorgfältige Prüfung.

Handles können Marken, Fantasiewörter oder unverwandte Wörter enthalten. Bulk-Anfragen werden nicht akzeptiertaskToAI or forceToGenderize. Für eine zuverlässigere Behandlung ungewöhnlicher Eingaben verwenden Sie dieeine Anfrage.

HDR

Erforderliche HTTP-Header

Autorisieren Sie die Bulk-Anfrage

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

JSON-Anfragekörper

Parameter

Field	Type	Requirement	Description
`data`	object[]	Pflichtfeld	Array mit zwischen 1 und 50 Benutzernamenangaben.
`data[].username`	string	Pflichtfeld	Benutzername oder Handle analysieren; Unterstriche und Zahlen sind erlaubt.
`data[].country`	string	Optional	ISO 3166-1 alpha-2-Landcode als regionale Kontextnutzung.
`data[].id`	string \| integer	Optional	Ihre Identifikationsnummer, unverändert mit dem entsprechenden Ergebnis zurückgegeben.

Eingabehinweise

Benutzernamen mit lateinischen Zeichen geben in der Regel klarere Namenssignale. Verwenden Sie eindeutigeidWerte und bewerten Sie die extrahiertenname and probabilitybevor Sie die Datensätze aktualisieren.

Anfrageinhalt

Bauen Sie das Benutzername-Array

JSON

{
  "data": [
    { "username": "anna_smith88", "country": "US", "id": "123" },
    { "username": "michael_bauer", "country": "DE", "id": "456" },
    { "username": "giulia_rossi", "country": "IT", "id": "789" }
  ]
}

Codebeispiele

Senden Sie eine Anfrage mit mehreren Benutzernamen

cURL

curl -X POST "https://api.genderapi.io/api/username/multi/country" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"data":[{"username":"anna_smith88","country":"US","id":"123"},{"username":"michael_bauer","country":"DE","id":"456"}]}'

JavaScript

const data = [
  { username: "anna_smith88", country: "US", id: "123" },
  { username: "michael_bauer", country: "DE", id: "456" }
];
const response = await fetch("https://api.genderapi.io/api/username/multi/country", {
  method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ data })
});

200-Antwort

Extrahierte Namen und Vorhersagen

JSON

{
  "status": true, "used_credits": 3, "remaining_credits": 7265, "expires": 1717069765,
  "names": [
    { "name": "Anna", "q": "anna_smith88", "gender": "female", "country": "US", "total_names": 1234, "probability": 92, "id": "123" },
    { "name": "Michael", "q": "michael_bauer", "gender": "male", "country": "DE", "total_names": 5678, "probability": 89, "id": "456" }
  ], "duration": "5ms"
}

Antwortfelder

Field	Type	Description
`status`	boolean	Ob die Bulk-Anfrage erfolgreich abgeschlossen wurde.
`used_credits`	integer	Verbrauchte Credits bei den eingereichten Benutzernamen.
`remaining_credits`	integer	Verfügbare Credits nach der Anfrage.
`expires`	integer	Verfallszeit des Pakets als UNIX-Timestamp.
`names`	object[]	Ergebnisse für die eingereichten Benutzernamen.
`names[].name`	string	Potenzieller Name, der aus dem Benutzernamen extrahiert wurde.
`names[].q`	string	Original-Benutzername, der in der Anfrage eingereicht wurde.
`names[].gender`	string \| null	Vorhergesagter Wert: männlich, weiblich oder null.
`names[].country`	string	Landescode, der für dieses Ergebnis berücksichtigt wird.
`names[].total_names`	integer	Anzahl der Proben, die dieses Ergebnis unterstützen.
`names[].probability`	integer	Vorhersagegenauigkeit in Prozent.
`names[].id`	string \| integer	Eingabekennung für die Korrelation des Datensatzes.
`duration`	string	Gesamte Serververarbeitungszeit.

Halte jede Anfrage auf 50 Einträge begrenzt

Teile größere Eingaben in Batches auf. Ein Benutzername ist ein indirekter Hinweis, daher überprüfe den extrahierten Namen und stelle eine akzeptable Wahrscheinlichkeitsgrenze her, bevor Ergebnisse angewendet werden.

Nächster Referenzpunkt

Validiere und formatiere Telefonnummern

TelefonvalidierungPrüfe und überprüfe Validierungs- und Formatierungsverfahren →Username eine AnfrageUse AI-Optionen for one handle →