Bestem køn ud fra op til 50 brugernavne

Overblik over bulk-forespørgsler

Behandle op til 50 brugernavne

Send endataarray. GenderAPI extraherer potentielle navne signaler fra hvert håndtag og returnerer resultater med din valgfri registreringid.

MethodPOST

Maximum50 brugernavne

AuthenticationBearer token

AI-mulighederIkke understøttet

Bulk-resultater for brugernavne kræver nøjagtig gennemgang.

Håndtag kan indeholde markeder, fantasiord eller uafhængige ord. Bulk-anmodninger accepterer ikkeaskToAI eller forceToGenderize. Brug den til usædvanlige input, der kræver behandling med højere sikkerhed:enkelt forespørgsel.

HDR

Obligatoriske HTTP-hedre

Autoriser den massive forespørgsel

Content-Typeapplication/json

AuthorizationBearer DIN_API_NYCKEL

JSON forespørgselskrop

Parametre

Field	Type	Requirement	Description
`data`	object[]	Påkrævet	Array indeholdende mellem 1 og 50 brugernavn- eller handleposter.
`data[].username`	string	Påkrævet	Brugerenavn eller handle at analysere; understregninger og tal er tilladt.
`data[].country`	string	Valgfrit	ISO 3166-1 alpha-2-landkode brugt som regional kontekst.
`data[].id`	string \| integer	Valgfrit	Din identifikationskode, returneres uændret med den tilhørende resultater.

Indtastningsvejledning

Brug brugernavne med latinske tegn, da de ofte giver tydeligere navneindikationer. Brug unikke værdier og vurder de udtrækkedeidværdier før du opdaterer registreringer.name and probabilityByg brugernavn-arrayet

Anmodningsindhold

Byg brugernavn-arrayet

JSON

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

Kodeeksempler

Send en anmodning med flere brugernavne

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

Extractered navne og forudsigelser

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

Responsfelter

Field	Type	Description
`status`	boolean	Om den massive forespørgsel blev udført succesfuldt.
`used_credits`	integer	Kreditter forbrugt over de indsendte brugernavne.
`remaining_credits`	integer	Kreditter tilgængelige efter forespørgslen.
`expires`	integer	Pakkeudgået tid som UNIX-tidstamp.
`names`	object[]	Resultater for de indsendte brugernavne.
`names[].name`	string	Potentielt navn udtrukket fra brugernavnet.
`names[].q`	string	Original brugernavn indsendt i forespørgslen.
`names[].gender`	string \| null	Forudsiget værdi: mand, kvinde eller null.
`names[].country`	string	Landkode, der er blevet overvejet for dette resultat.
`names[].total_names`	integer	Antal eksempler, der støtter dette resultat.
`names[].probability`	integer	Forudsigelseskonfidens som procent.
`names[].id`	string \| integer	Indtastningsidentifikator, der bliver returneret til oplysningssammenhæng.
`duration`	string	Samlet serverbehandlingstid.

Behold hvert anmodning indenfor 50 registreringer

Del større indgange op i batcher. Et brugernavn er en indirekte signal, så verificér det udtrækkede navn og opstil et acceptabelt sandsynlighedsskærm før man anvender resultaterne.

Næste reference

Validér og formater telefonnumre

TelefonvalideringGennemgå validering og formateringsmetoder →Username enkelt forespørgselUse AI-muligheder for one handle →