Find køn ud fra brugernavn – Forespørgsel med flere brugernavne

Multi-brugernavn-endepunktet giver dig mulighed for at analysere køn for op til 50 brugernavne i én enkelt forespørgsel. Dette er nyttigt til massebehandling og højtydende integrationer. Alle parametre sendes via en POST-anmodning som JSON. Du skal godkende ved at bruge Bearer-token i Authorization-headeren.

API'et forsøger at udtrække et sandsynligt fornavn fra hvert brugernavn, hvilket kan hjælpe med at forbedre kønsforudsigelsen. Du kan også angive et valgfrit country-filter og et tilpasset id-felt for hver post, så du kan matche resultater med din database.

Advarsel: Brugernavne skal som regel være med latinske bogstaver. De kan dog ofte indeholde ord eller kombinationer, som ikke er rigtige navne, fx cool_boy123.

Hvis dit hovedformål er præcis kønsforudsigelse, anbefaler vi at bruge enkelt-forespørgsler med forceToGenderize-parameteren aktiveret.

Hvis du blot vil udtrække mulige navne fra brugernavne, kan du bruge forespørgsler med flere brugernavne.

Forespørgsels-URL

POST https://api.genderapi.io/api/username/multi/country

Nødvendige HTTP-headere

  • Content-Type: application/json
  • Authorization: Bearer YOUR_API_KEY

Body-parametre

Felt Type Påkrævet Beskrivelse
data Array af objekter Ja Array af brugernavne og deres valgfrie parametre. Maks. 50 poster pr. forespørgsel.
username String Ja (i hvert objekt) Brugernavn, der skal analyseres. Kan indeholde underscores, tal mv.
country String Nej To-bogstavs landekode (ISO 3166-1 alpha-2) for at forbedre forudsigelsesnøjagtighed. Eksempel: TR for Tyrkiet.
id String eller Integer Nej Valgfrit ID, du selv definerer, så du kan matche resultater med dine egne databaseposter. Samme id returneres i svaret.

Eksempel på request-body

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

Eksempler på forespørgsler


cURL-eksempel

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"},{"username":"giulia_rossi","country":"IT","id":"789"}]}'

PHP cURL-eksempel

<?php
$url = "https://api.genderapi.io/api/username/multi/country";

$data = array(
    "data" => array(
        array(
            "username" => "anna_smith88",
            "country" => "US",
            "id" => "123"
        ),
        array(
            "username" => "michael_bauer",
            "country" => "DE",
            "id" => "456"
        ),
        array(
            "username" => "giulia_rossi",
            "country" => "IT",
            "id" => "789"
        )
    )
);

$payload = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    "Content-Type: application/json",
    "Authorization": "Bearer YOUR_API_KEY"
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

JavaScript fetch-eksempel

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: [
      { username: "anna_smith88", country: "US", id: "123" },
      { username: "michael_bauer", country: "DE", id: "456" },
      { username: "giulia_rossi", country: "IT", id: "789" }
    ]
  })
})
.then(response => response.json())
.then(data => console.log(data));

Python requests-eksempel

import requests

url = "https://api.genderapi.io/api/username/multi/country"

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

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.post(url, headers=headers, json=payload)

print(response.json())

Eksempel på JSON-svar

{
  "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"
    },
    {
      "name": "Giulia",
      "q": "giulia_rossi",
      "gender": "female",
      "country": "IT",
      "total_names": 4321,
      "probability": 95,
      "id": "789"
    }
  ],
  "duration": "5ms"
}

Svars-felter

Felt Type Beskrivelse
status Boolean Angiver om forespørgslen var succesfuld.
used_credits Integer Antal forbrugte credits for denne forespørgsel.
remaining_credits Integer Tilbageværende credits efter denne forespørgsel.
expires Integer (timestamp) Pakkens udløbsdato som UNIX timestamp.
names Array af objekter Resultatliste for hvert indtastet brugernavn.
names[].name String Detekteret fornavn, hvis muligt, udtrukket fra brugernavnet.
names[].q String Dit originale input til brugernavn.
names[].gender Enum[String] Forudsagt køn: male, female eller null.
names[].country String Landekode brugt i forudsigelsen.
names[].total_names Integer Antal prøver brugt til denne forudsigelse.
names[].probability Integer Procentvis sandsynlighed for kønsforudsigelsen.
names[].id String / Integer Samme id som du sendte i requestet. Bruges til at matche dine poster.
duration String Total behandlingstid for forespørgslen (fx 5ms).