Bulk gender uit naam API – meerdere namen

Overzicht bulkaanvraag

Verwerk maximaal 100 namen

Verstuur een data-array en ontvang één resultaat per record. Voeg een id uit uw systeem toe om iedere voorspelling betrouwbaar aan het bronrecord te koppelen.

MethodePOST

Maximum100 namen

AuthenticatieBearer-token

AI-ondersteuningNiet ondersteund

Bulkaanvragen gebruiken geen AI.

askToAI en forceToGenderize zijn niet beschikbaar. Gebruik voor niet-Latijns schrift of AI-ondersteuning het endpoint voor één naam.

HDR

Vereiste HTTP-headers

Autoriseer de bulkaanvraag

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

JSON-aanvraagbody

Parameters

Veld	Type	Vereiste	Beschrijving
`data`	object[]	Verplicht	Array met 1 tot en met 100 naamrecords.
`data[].name`	string	Verplicht	Voornaam om te analyseren.
`data[].country`	string	Optioneel	ISO 3166-1 alpha-2-landcode. Als er geen landresultaat is, wordt het globale resultaat gebruikt.
`data[].id`	string \| integer	Optioneel	Uw record-ID; wordt ongewijzigd teruggestuurd om resultaat en bronrecord te koppelen.

Terugval zonder landmatch

Als de landcode geen match oplevert, retourneert GenderAPI het beschikbare globale naamresultaat. Gebruik codes zoals NL, BE of US.

Aanvraagpayload

Bouw de data-array

JSON

{ "data": [
  { "name": "Sophie", "country": "NL", "id": "123" },
  { "name": "Noor", "country": "BE", "id": "456" }
] }

Codevoorbeelden

Verstuur een aanvraag voor meerdere namen

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":"Sophie","country":"NL","id":"123"}]}'

JavaScript

const data=[{name:"Sophie",country:"NL",id:"123"}];
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-respons

Koppel resultaten aan uw records

JSON

{ "status": true, "used_credits": 2, "remaining_credits": 7265,
 "names": [{"name":"sophie","q":"Sophie","gender":"female","country":"NL","total_names":644,"probability":98,"id":"123"}], "duration":"5ms" }

Responsvelden

Veld	Type	Beschrijving
`status`	boolean	Of de bulkaanvraag met succes is voltooid.
`used_credits`	integer	Credits voor alle ingestuurde namen.
`remaining_credits`	integer	Beschikbare credits na de aanvraag.
`expires`	integer	Pakketvervaldatum als UNIX-tijdstempel.
`names`	object[]	Geordende verzameling voorspellingsresultaten.
`names[].name`	string	Genormaliseerde naam voor de voorspelling.
`names[].q`	string	Oorspronkelijk ingestuurde naam.
`names[].gender`	string \| null	Voorspelde waarde: male, female of null.
`names[].country`	string	Landcode voor dit resultaat.
`names[].total_names`	integer	Aantal ondersteunende voorbeelden.
`names[].probability`	integer	Waarschijnlijkheid als percentage.
`names[].id`	string \| integer	Teruggestuurde invoer-ID voor koppeling.
`duration`	string	Totale verwerkingstijd op de server.

Beperk iedere aanvraag tot 100 records

Valideer de array vooraf, gebruik unieke id's en verdeel grotere datasets in batches van maximaal 100 namen.

Volgende handleiding

Bepaal gender uit een e-mailadres

Enkele e-mailaanvraagExtraheer en analyseer een naam uit e-mail →Enkele naamaanvraagGebruik AI-ondersteuning voor één naam →