Bulk-API för kön från namn | Flera namn per förfrågan

Översikt över bulkförfrågan

Bearbeta upp till 100 namn

Skicka en data-array och ta emot ett resultat per post. Lägg till ett id från ditt system för att säkert koppla varje prognos till rätt källpost.

MetodPOST

Maximalt100 namn

AutentiseringBearer-token

AI-stödStöds inte

Bulkförfrågningar använder inte AI-inferens.

askToAI och forceToGenderize är inte tillgängliga. Använd endpointen för enskilda namn för namn i icke-latinsk skrift eller indata som behöver AI-stöd.

HDR

Obligatoriska HTTP-headers

Auktorisera bulkförfrågan

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

JSON-body för förfrågan

Parametrar

Fält	Typ	Krav	Beskrivning
`data`	object[]	Obligatorisk	Array med mellan 1 och 100 namnposter.
`data[].name`	string	Obligatorisk	Förnamnet som ska analyseras.
`data[].country`	string	Valfri	Landskod enligt ISO 3166-1 alpha-2. Ett globalt resultat används om det saknas resultat för landet.
`data[].id`	string \| integer	Valfri	Ditt post-ID returneras oförändrat så att resultatet kan kopplas till rätt källpost.

Global reservmatchning

Om det saknas träff för angivet land returnerar GenderAPI det tillgängliga globala namnresultatet. Använd landskoder enligt ISO 3166-1 alpha-2, exempelvis SE, IT eller US.

Request payload

Bygg data-arrayen

JSON

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

Kodexempel

Skicka en förfrågan med flera namn

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

Koppla resultat till dina poster

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

Svarsfält

Fält	Typ	Beskrivning
`status`	boolean	Anger om den samlade förfrågan slutfördes utan fel.
`used_credits`	integer	Krediter som förbrukades för samtliga skickade namn.
`remaining_credits`	integer	Krediter som återstår efter förfrågan.
`expires`	integer	Paketets utgångstid som en UNIX-tidsstämpel.
`names`	object[]	Ordnad samling med namnprognoser.
`names[].name`	string	Normaliserat namn som användes för prognosen.
`names[].q`	string	Ursprungligt namn från förfrågan.
`names[].gender`	string \| null	Prognostiserat värde: male, female eller null.
`names[].country`	string	Landskod som användes för resultatet.
`names[].total_names`	integer	Antal namnposter som stöder resultatet.
`names[].probability`	integer	Resultatets sannolikhet i procent.
`names[].id`	string \| integer	Inmatat ID som returneras för koppling till källposten.
`duration`	string	Total behandlingstid på servern.

Begränsa varje förfrågan till 100 poster

Validera arrayen innan den skickas och använd ett unikt id för deterministisk koppling mellan poster. Dela större dataset i batcher med högst 100 namn.

Nästa guide

Bestäm kön från en e-postadress

Enskild e-postförfråganExtrahera och analysera namn från e-post →Enskild namnförfråganAnvänd AI-stöd för ett namn →