Køn ud fra flere navne API – Dokumentation til masseforespørgsel

Oversigt over masseforespørgslen

Behandl op til 100 navne

Send et data-array, og modtag ét resultat pr. post. Tilføj et id fra dit system for pålideligt at knytte hver estimering til den oprindelige post.

MetodePOST

Maksimum100 navne

GodkendelseBearer-token

AI-fallbackUnderstøttes ikke

Masseforespørgsler bruger ikke AI-estimering.

askToAI og forceToGenderize er ikke tilgængelige. Brug endpointet til ét navn til ikke-latinske skriftsystemer eller input, der kræver AI-fallback.

HDR

Påkrævede HTTP-headere

Godkend masseforespørgslen

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

JSON-request body

Parametre

Felt	Type	Krav	Beskrivelse
`data`	object[]	Påkrævet	Array med mellem 1 og 100 navneposter.
`data[].name`	string	Påkrævet	Fornavnet, der skal analyseres.
`data[].country`	string	Valgfri	ISO 3166-1 alpha-2-landekode. Hvis landet ikke giver et resultat, bruges det tilgængelige globale resultat.
`data[].id`	string \| integer	Valgfri	Din postidentifikator, som returneres uændret, så resultatet kan knyttes til inputposten.

Globalt fallback for land

Hvis den indsendte landekode ikke giver et resultat, returnerer GenderAPI det tilgængelige globale navneresultat. Brug ISO 3166-1 alpha-2-værdier som DK, DE eller US.

Request payload

Opbyg data-arrayet

JSON

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

Kodeeksempler

Send en forespørgsel med flere navne

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

Knyt resultaterne til dine 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"
}

Svarfelter

Felt	Type	Beskrivelse
`status`	boolean	Angiver, om masseforespørgslen blev gennemført korrekt.
`used_credits`	integer	Kreditter brugt på alle indsendte navne.
`remaining_credits`	integer	Tilgængelige kreditter efter forespørgslen.
`expires`	integer	Pakkens udløbstid som UNIX-tidsstempel.
`names`	object[]	Ordnet samling af estimeringsresultater.
`names[].name`	string	Normaliseret navn brugt til estimeringen.
`names[].q`	string	Det oprindelige navn i forespørgslen.
`names[].gender`	string \| null	Estimeret værdi: male, female eller null.
`names[].country`	string	Landekoden, der indgik i resultatet.
`names[].total_names`	integer	Antal navneposter, som understøtter resultatet.
`names[].probability`	integer	Estimeringens sandsynlighed i procent.
`names[].id`	string \| integer	Inputidentifikatoren returneret til sammenkædning af poster.
`duration`	string	Samlet behandlingstid på serveren.

Hold hver forespørgsel inden for 100 poster

Validér arrayet før afsendelse, og brug et unikt id til entydig sammenkædning. Opdel større datasæt i batches på højst 100 navne.

Næste vejledning

Bestem køn ud fra en e-mail

Enkelt e-mailforespørgselUdtræk og analysér et navn fra e-mail →Enkelt navneforespørgselBrug AI-fallback til ét navn →