Tunnista sukupuoli useista nimistä

Massakyselyn yleiskatsaus

Käsittele jopa 100 nimeä

Lähetä data-luettelo ja vastaanota yksi tulos tietuetta kohti. Lisää järjestelmäsi id, jotta jokainen ennuste voidaan yhdistää luotettavasti alkuperäiseen tietueeseen.

MenetelmäPOST

Enintään100 nimeä

TunnistautuminenBearer-token

TekoälyvarmistusEi tuettu

Massakyselyt eivät käytä tekoälypäättelyä.

askToAI ja forceToGenderize eivät ole käytettävissä. Käytä ei-latinalaisille nimille tai tekoälyvarmistusta tarvitseville syötteille yksittäisen nimen endpointia.

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–100 nimitietuetta.
`data[].name`	string	Pakollinen	Analysoitava etunimi.
`data[].country`	string	Valinnainen	ISO 3166-1 alpha-2 -maakoodi. Jos maakohtaista tulosta ei löydy, käytetään maailmanlaajuista tulosta.
`data[].id`	string \| integer	Valinnainen	Oma tietuetunnuksesi palautetaan muuttamattomana, jotta tulokset voidaan yhdistää alkuperäisiin tietueisiin.

Maakontekstin varatulokset

Jos valitulle maalle ei löydy osumaa, GenderAPI palauttaa saatavilla olevan maailmanlaajuisen nimituloksen. Käytä ISO 3166-1 alpha-2 -koodeja, kuten FI, SE tai DK.

Pyynnön hyötykuorma

Muodosta data-luettelo

JSON

{
  "data": [
    { "name": "Andrea", "country": "DE", "id": "123" },
    { "name": "andrea", "country": "IT", "id": "456" },
    { "name": "james", "country": "US", "id": "789" }
  ]
}

Koodiesimerkit

Lähetä usean nimen kysely

cURL

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

JavaScript

const data = [
  { name: "Andrea", country: "DE", id: "123" },
  { name: "andrea", country: "IT", id: "456" }
];

const response = await fetch("https://api.genderapi.io/api/name/multi/country", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ data })
});

200-vastaus

Yhdistä tulokset tietueisiisi

JSON

{
  "status": true,
  "used_credits": 3,
  "remaining_credits": 7265,
  "expires": 1717069765,
  "names": [
    { "name": "andrea", "q": "Andrea", "gender": "female", "country": "DE", "total_names": 644, "probability": 88, "id": "123" },
    { "name": "andrea", "q": "andrea", "gender": "male", "country": "IT", "total_names": 13537, "probability": 98, "id": "456" }
  ],
  "duration": "5ms"
}

Vastauskentät

Kenttä	Tyyppi	Kuvaus
`status`	boolean	Suoritettiinko koko pyyntö ilman virheitä.
`used_credits`	integer	Kaikkien lähetettyjen 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[]	Järjestetty luettelo nimien ennustetuloksista.
`names[].name`	string	Ennusteessa käytetty normalisoitu nimi.
`names[].q`	string	Lähetetty alkuperäinen nimi.
`names[].gender`	string \| null	Ennustettu arvo: male, female tai null.
`names[].country`	string	Tässä tuloksessa käytetty maakoodi.
`names[].total_names`	integer	Tulosta tukevien nimiesiintymien määrä.
`names[].probability`	integer	Ennusteen luottamus prosentteina.
`names[].id`	string \| integer	Tietueiden yhdistämistä varten palautettava syötetunnus.
`duration`	string	Palvelimen kokonaiskäsittelyaika.

Rajoita kukin kysely 100 tietueeseen

Validoi luettelo ennen lähettämistä ja käytä yksilöllistä id-arvoa tietueiden varmaan yhdistämiseen. Jaa suuremmat aineistot enintään 100 nimen eriin.

Seuraava opas

Tunnista sukupuoli sähköpostiosoitteesta

Yksittäinen sähköpostikyselyPoimi ja analysoi nimi sähköpostista →Yksittäinen nimikyselyKäytä tekoälyvarmistusta yhdelle nimelle →