Bepaal het geslacht aan de hand van maximaal 50 gebruikersnamen

Overzicht van bulk-aanvragen

Tot 50 gebruikersnamen verwerken

Stuur eendataarray. GenderAPI extrahereert potentiële naamsignalen uit elk handle en retourneert resultaten met je optionele recordid.

MethodPOST

Maximum50 gebruikersnamen

AuthenticationBearer token

AI-optiesNiet ondersteund

Bulk-resultaten voor gebruikersnamen vereisen een zorgvuldige controle.

Handles kunnen merken, fantasite termen of ongerelateerde woorden bevatten. Bulk-aanvragen worden niet geaccepteerdaskToAI or forceToGenderize. Voor een betere verwerking van ongebruikelijke invoer, gebruik dan deéén aanvraag.

HDR

Verplichte HTTP-header

Autoriseer de bulk-aanvraag

Content-Typeapplication/json

AuthorizationBearer UW_API_SLEUTEL

JSON-aanvraaglichaam

Parameters

Field	Type	Requirement	Description
`data`	object[]	Verplicht	Array met tussen 1 en 50 gebruikersnaamrecords.
`data[].username`	string	Verplicht	Gebruikersnaam of handle analyseren; underscoren en cijfers zijn toegestaan.
`data[].country`	string	Optioneel	ISO 3166-1 alpha-2 landcode gebruikt als regionale context.
`data[].id`	string \| integer	Optioneel	Uw identificator, geretourneerd onveranderd met het bijbehorende resultaat.

Invoerhandleiding

Latijnse karaktergebruikersnamen bieden meestal duidelijker namesignalen. Gebruik uniekeidwaarden en bepaal de geëxtraheerdename and probabilityvoor het bijwerken van records.

Aanvraagpayload

Bouw de gebruikersnaamarray

JSON

{
  "data": [
    { "username": "anna_smith88", "country": "US", "id": "123" },
    { "username": "michael_bauer", "country": "DE", "id": "456" },
    { "username": "giulia_rossi", "country": "IT", "id": "789" }
  ]
}

Codevoorbeelden

Stuur een aanvraag met meerdere gebruikersnamen

cURL

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

JavaScript

const data = [
  { username: "anna_smith88", country: "US", id: "123" },
  { username: "michael_bauer", country: "DE", id: "456" }
];
const response = await fetch("https://api.genderapi.io/api/username/multi/country", {
  method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ data })
});

200 antwoord

Gehaalde namen en voorspellingen

JSON

{
  "status": true, "used_credits": 3, "remaining_credits": 7265, "expires": 1717069765,
  "names": [
    { "name": "Anna", "q": "anna_smith88", "gender": "female", "country": "US", "total_names": 1234, "probability": 92, "id": "123" },
    { "name": "Michael", "q": "michael_bauer", "gender": "male", "country": "DE", "total_names": 5678, "probability": 89, "id": "456" }
  ], "duration": "5ms"
}

Antwoordvelden

Field	Type	Description
`status`	boolean	Of de bulkverzoek succesvol is afgerond.
`used_credits`	integer	Credits verbruikt per ingediende gebruikersnaam.
`remaining_credits`	integer	Credits beschikbaar na de verzoek.
`expires`	integer	Verloopstijd van de pakket als UNIX-timestamp.
`names`	object[]	Resultaten voor de ingediende gebruikersnamen.
`names[].name`	string	Potentiële naam geëxtraheerd uit de gebruikersnaam.
`names[].q`	string	Oorspronkelijke gebruikersnaam ingediend in de verzoek.
`names[].gender`	string \| null	Gepredigeerde waarde: man, vrouw of null.
`names[].country`	string	Landcode die voor deze resultaat wordt overwogen.
`names[].total_names`	integer	Aantal monsters dat deze resultaat ondersteunt.
`names[].probability`	integer	Vertrouwensniveau als percentage.
`names[].id`	string \| integer	Inputidentificator geretourneerd voor correlatie van het record.
`duration`	string	Totaal verwerkings tijd op de server.

Houd elke aanvraag binnen 50 records

Deel grotere invoer in batches. Een gebruikersnaam is een indirecte signal, dus controleer de geëxtraheerde naam en stel een acceptabele waarschijnlijkheidsdrempel vast voordat je resultaten toepast.

Volgende referentie

Valideer en formateer telefoonnummers

TelefoonvalidatieControleer validatie- en formateringsmethoden →Username één aanvraagUse AI-opties for one handle →