Tunnista sukupuoli useista käyttäjänimistä

Massakyselyn yleiskatsaus

Käsittele jopa 50 käyttäjänimeä

Lähetä data-luettelo. GenderAPI poimii mahdolliset nimisignaalit jokaisesta käyttäjänimestä ja palauttaa tulokset valinnaisen id-tunnuksesi kanssa turvallista tietueiden yhdistämistä varten.

MenetelmäPOST

Enintään50 käyttäjänimeä

TunnistautuminenBearer-token

TekoälyasetuksetEi tuettu

Useiden käyttäjänimien tuloksia on arvioitava huolellisesti.

Käyttäjänimet voivat sisältää brändinimiä, mielikuvitussanoja tai muita ilmauksia ilman henkilönimeä. Massakyselyt eivät hyväksy askToAI tai forceToGenderize. Saat enemmän hallintaa epätavallisiin syötteisiin käyttämällä yksittäistä kyselyä.

HDR

Pakolliset HTTP-headerit

Valtuuta massakysely

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Pyynnön JSON-runko

Parametrit

Kenttä	Tyyppi	Vaatimus	Kuvaus
`data`	object[]	Pakollinen	Luettelo, jossa on 1–50 käyttäjänimitietuetta.
`data[].username`	string	Pakollinen	Analysoitava käyttäjänimi tai profiilinimi; alaviivoja ja numeroita tuetaan.
`data[].country`	string	Valinnainen	Alueellisena kontekstina käytettävä ISO 3166-1 alpha-2 -maakoodi.
`data[].id`	string \| integer	Valinnainen	Oma tunnisteesi palautetaan muuttamattomana vastaavan tuloksen mukana.

Syötteen ohjeistus

Latinalaisia merkkejä sisältävät käyttäjänimet antavat yleensä selkeämpiä nimisignaaleja. Käytä yksilöllisiä id-arvoja ja arvioi sekä poimittu name että probability ennen tietueiden päivittämistä.

Pyynnön hyötykuorma

Muodosta käyttäjänimiluettelo

JSON

{
  "data": [
    { "username": "emilia_k", "country": "FI", "id": "123" },
    { "username": "mikael_l", "country": "FI", "id": "456" },
    { "username": "sofia_n", "country": "FI", "id": "789" }
  ]
}

Koodiesimerkit

Lähetä usean käyttäjänimen kysely

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":"emilia_k","country":"FI","id":"123"},{"username":"mikael_l","country":"FI","id":"456"}]}'

JavaScript

const data = [
  { username: "emilia_k", country: "FI", id: "123" },
  { username: "mikael_l", country: "FI", 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-vastaus

Poimitut nimet ja ennusteet

JSON

{
  "status": true, "used_credits": 3, "remaining_credits": 7265, "expires": 1717069765,
  "names": [
    { "name": "Emilia", "q": "emilia_k", "gender": "female", "country": "FI", "total_names": 1234, "probability": 99, "id": "123" },
    { "name": "Mikael", "q": "mikael_l", "gender": "male", "country": "FI", "total_names": 5678, "probability": 98, "id": "456" }
  ], "duration": "5ms"
}

Vastauskentät

Kenttä	Tyyppi	Kuvaus
`status`	boolean	Suoritettiinko massakysely onnistuneesti.
`used_credits`	integer	Lähetettyjen käyttäjänimien käyttämät krediitit.
`remaining_credits`	integer	Pyynnön jälkeen käytettävissä olevat krediitit.
`expires`	integer	Paketin vanhenemisaika UNIX-aikaleimana.
`names`	object[]	Lähetettyjen käyttäjänimien tulokset.
`names[].name`	string	Käyttäjänimestä poimittu mahdollinen nimi.
`names[].q`	string	Pyynnön alkuperäinen käyttäjänimi.
`names[].gender`	string \| null	Ennustettu arvo: male, female tai null.
`names[].country`	string	Tuloksessa käytetty maakoodi.
`names[].total_names`	integer	Tulosta tukevien datapisteiden määrä.
`names[].probability`	integer	Ennusteen luottamus prosentteina.
`names[].id`	string \| integer	Tietueiden yhdistämistä varten palautettava syötetunniste.
`duration`	string	Palvelimen kokonaiskäsittelyaika.

Rajoita kukin kysely 50 tietueeseen

Jaa suuremmat aineistot useisiin eriin. Käyttäjänimi on epäsuora signaali, joten tarkista poimittu nimi ja määritä hyväksyttävä todennäköisyysraja ennen tulosten käyttämistä.

Seuraava viite

Validoi ja muotoile puhelinnumeroita

Puhelinnumeron validointiKatso validointi- ja muotoilumenetelmät →Yksittäinen käyttäjänimiKäytä tekoälyasetuksia yhdelle käyttäjänimelle →