Finn kjønn fra flere navn – API for masseoppslag

Oversikt over masseoppslag

Behandle opptil 100 navn

Send en data-liste og motta ett resultat per post. Legg til en id fra systemet ditt for å koble hver prediksjon sikkert tilbake til den opprinnelige posten.

MetodePOST

Maksimum100 navn

AutentiseringBearer-token

KI-reserveStøttes ikke

Masseoppslag bruker ikke KI-inferens.

askToAI og forceToGenderize er ikke tilgjengelige. For navn med ikke-latinske skriftsystemer eller inndata som trenger KI-reserve, bruker du endepunktet for ett navn.

HDR

Påkrevde HTTP-headere

Autoriser masseoppslaget

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

JSON-body for forespørselen

Parametere

Felt	Type	Krav	Beskrivelse
`data`	object[]	Påkrevd	En liste med mellom 1 og 100 navneposter.
`data[].name`	string	Påkrevd	Fornavnet som skal analyseres.
`data[].country`	string	Valgfri	ISO 3166-1 alfa-2-landkode. Et globalt resultat brukes hvis det ikke finnes et landsspesifikt resultat.
`data[].id`	string \| integer	Valgfri	Din post-ID, returnert uendret slik at resultater kan kobles til de opprinnelige postene.

Reserve for landkontekst

Hvis det ikke finnes et treff for det valgte landet, returnerer GenderAPI det tilgjengelige globale navneresultatet. Bruk ISO 3166-1 alfa-2-koder som NO, SE eller DK.

Payload for forespørselen

Bygg data-listen

JSON

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

Kodeeksempler

Send en forespørsel med flere navn

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-svar

Koble resultatene til postene dine

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

Svarfelt

Felt	Type	Beskrivelse
`status`	boolean	Om den samlede forespørselen ble fullført uten feil.
`used_credits`	integer	Kreditter brukt for alle innsendte navn.
`remaining_credits`	integer	Kreditter som er tilgjengelige etter forespørselen.
`expires`	integer	Pakkens utløpstid som UNIX-tidsstempel.
`names`	object[]	Sortert liste med resultater for navneprediksjonene.
`names[].name`	string	Normalisert navn brukt i prediksjonen.
`names[].q`	string	Det opprinnelige navnet som ble sendt inn.
`names[].gender`	string \| null	Predikert verdi: male, female eller null.
`names[].country`	string	Landkoden som ble brukt for dette resultatet.
`names[].total_names`	integer	Antall navneforekomster som støtter resultatet.
`names[].probability`	integer	Prediksjonens konfidens uttrykt i prosent.
`names[].id`	string \| integer	Inndata-ID som returneres for kobling av poster.
`duration`	string	Samlet behandlingstid på serveren.

Begrens hver forespørsel til 100 poster

Valider listen før den sendes, og bruk en unik id for entydig kobling av poster. Del større datasett i grupper med maksimalt 100 navn.

Neste veiledning

Finn kjønn fra en e-postadresse

Enkeltforespørsel for e-postHent ut og analyser et navn fra e-post →Enkeltforespørsel for navnBruk KI-reserve for ett navn →