Bestäm kön utifrån upp till 50 användarnamn

Översikt över massbegäran

Behandla upp till 50 användarnamn

Skicka endataarray. GenderAPI extraherar potentiella namnsignal från varje hantering och returnerar resultat med din valfria registreringid.

MethodPOST

Maximum50 användarnamn

AuthenticationBärer-token

AI-valInte stöd

Massresultat för användarnamn kräver noggrann kontroll.

Hanteringsnamn kan innehålla marknadsnamn, fantasitermer eller oanpassade ord. Massanfrågor accepterar inteaskToAI or forceToGenderize. För högre säkerhet vid hantering av ovanliga inmatningar, användendast begäran.

HDR

Krävda HTTP-huvudfält

Autorisera massbegäran

Content-Typeapplication/json

AuthorizationBearer DITT_API_NYCKEL

JSON-förfrågan i kroppen

Parametrar

Field	Type	Requirement	Description
`data`	object[]	Obligatorisk	Array som innehåller mellan 1 och 50 användarnamn.
`data[].username`	string	Obligatorisk	Användarnamn eller hanterare att analysera; understreck och siffror är tillåtna.
`data[].country`	string	Valfritt	ISO 3166-1 alpha-2 landkod används som regionell kontext.
`data[].id`	string \| integer	Valfritt	Din identifierare, returneras oändrad med motsvarande resultat.

Inmatningsguide

Latin-tecken användare ger vanligtvis tydligare namnsignal. Använd unikaidvärden och bedöm de extraheradename and probabilityinnan du uppdaterar poster.

Förfrågans innehåll

Bygg användarnamnsarrayen

JSON

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

Kodexempel

Skicka en förfrågan med flera användarnamn

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 svar

Extraherade namn och förutsägelser

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"
}

Svarsfält

Field	Type	Description
`status`	boolean	Om bulkförfrågan avslutades framgångsrikt.
`used_credits`	integer	Krediterna som förbrukades för de inmatade användarnamnen.
`remaining_credits`	integer	Krediterna som är kvar efter förfrågan.
`expires`	integer	Paketets giltighetsperiod som en UNIX-tidstempel.
`names`	object[]	Resultat för de inmatade användarnamnen.
`names[].name`	string	Potentiellt namn extraherat från användarnamnet.
`names[].q`	string	Originalanvändarnamn som inmatades i förfrågan.
`names[].gender`	string \| null	Förutsägda värden: manlig, kvinnlig eller null.
`names[].country`	string	Landkod som har använts för detta resultat.
`names[].total_names`	integer	Antal prov som stödjer detta resultat.
`names[].probability`	integer	Förutsägelsekonfidens uttryckt i procent.
`names[].id`	string \| integer	Inmatningsidentifierare som returneras för registreringskoppling.
`duration`	string	Total tid för serverbehandling.

Behåll varje begäran inom 50 poster

Delar större inmatningar in i batch. Ett användarnamn är en indirekt signal, så verifiera det extraherade namnet och fastställ en acceptabel sannolikhetsgräns innan du tillämpar resultatet.

Nästa referens

Validera och formatera telefonnummer

TelefonvalideringGranska validerings- och formateringsmetoder →Username endast begäranUse AI-val for one handle →