Kjønn fra brukernavn · Masseforespørsel

Analyser flere brukernavn i én forespørsel

Hent ut mulige navn og prediker kjønn fra opptil 50 brukernavn med landkontekst og egne post-ID-er.

POSThttps://api.genderapi.io/api/username/multi/country

Oversikt over masseoppslag

Behandle opptil 50 brukernavn

Send en data-liste. GenderAPI henter ut mulige navnesignaler fra hvert brukernavn og returnerer resultatene sammen med din valgfrie id for sikker kobling av poster.

MetodePOST
Maksimum50 brukernavn
AutentiseringBearer-token
KI-alternativerStøttes ikke
Resultater fra flere brukernavn må vurderes nøye.

Brukernavn kan inneholde merkenavn, fantasiord eller andre uttrykk uten personnavn. Masseforespørsler godtar ikke askToAI or forceToGenderize. For mer kontroll ved uvanlige inndata bruker du enkeltforespørselen.

HDR

Påkrevde HTTP-headere

Autoriser masseforespørselen

Content-Typeapplication/json
AuthorizationBearer YOUR_API_KEY

JSON-forespørsel

Parametere

FeltTypeKravBeskrivelse
dataobject[]PåkrevdListe med mellom 1 og 50 brukernavnsposter.
data[].usernamestringPåkrevdBrukernavn eller profilnavn som skal analyseres; understrek og tall støttes.
data[].countrystringValgfrittISO 3166-1 alfa-2-landkode som brukes som regional kontekst.
data[].idstring | integerValgfrittDin identifikator, returnert uendret med det tilhørende resultatet.
Veiledning for inndata

Brukernavn med latinske tegn gir vanligvis tydeligere navnesignaler. Bruk unike id-verdier, og vurder både uttrukket name og probability før du oppdaterer poster.

Forespørselsdata

Bygg listen med brukernavn

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 forespørsel med flere brukernavn

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

Uttrukne navn og prediksjoner

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

Svarfelter

FeltTypeBeskrivelse
statusbooleanOm masseforespørselen ble fullført.
used_creditsintegerAntall kreditter brukt for de innsendte brukernavnene.
remaining_creditsintegerTilgjengelige kreditter etter forespørselen.
expiresintegerPakkens utløpstid som UNIX-tidsstempel.
namesobject[]Resultater for de innsendte brukernavnene.
names[].namestringMulig navn hentet ut fra brukernavnet.
names[].qstringDet opprinnelige brukernavnet i forespørselen.
names[].genderstring | nullPredikert verdi: male, female eller null.
names[].countrystringLandkoden som ble brukt for resultatet.
names[].total_namesintegerAntall datapunkter som støtter resultatet.
names[].probabilityintegerPrediksjonens konfidens i prosent.
names[].idstring | integerIdentifikatoren fra inndata, returnert for kobling av poster.
durationstringSamlet behandlingstid på serveren.

Begrens hver forespørsel til 50 poster

Del større datamengder i flere grupper. Et brukernavn er et indirekte signal, så kontroller navnet som er hentet ut, og fastsett en akseptabel sannsynlighetsterskel før resultatene tas i bruk.

Neste referanse

Valider og formater telefonnumre

TelefonvalideringSe metoder for validering og formatering →Enkelt brukernavnBruk KI-alternativer for ett brukernavn →