Hämta kön via användarnamn – Flera förfrågningar

Slutpunkten Multiple Username låter dig analysera könet på upp till 50 användarnamn i en enda förfrågan. Detta är användbart för bulkbearbetning och högpresterande integrationer. Alla parametrar skickas via en POST-förfrågan i JSON-format. Du måste autentisera dig med Bearer token-metoden i Authorization-headern.

API:t försöker extrahera ett sannolikt förnamn från varje användarnamn, vilket kan hjälpa till att förbättra precisionen i könsbestämningen. Du kan också skicka med ett valfritt country-filter och ett eget id-fält för varje post för att matcha resultaten med din databas.

Varning: Användarnamn måste vanligtvis vara i latinska tecken. De innehåller dock ofta ord eller kombinationer som inte är riktiga namn, t.ex. cool_boy123.

Om ditt primära mål är korrekt könsbestämning rekommenderar vi att du använder enskilda förfrågningar med parametern forceToGenderize aktiverad.

Om din prioritet enbart är att extrahera potentiella namn ur användarnamn kan du istället använda flera förfrågningar.

Förfrågnings-URL

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

Nödvändiga HTTP-headrar

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

Parametrar i förfrågningskroppen

Fält Typ Obligatorisk Beskrivning
data Array av objekt Ja Array med användarnamn och deras valfria parametrar. Max 50 poster per förfrågan.
username String Ja (i varje objekt) Användarnamnet som ska analyseras. Kan innehålla understreck, siffror osv.
country String Nej Tvåbokstavslandskod (ISO 3166-1 alpha-2) för att förbättra noggrannheten i förutsägelsen. Exempel: TR för Turkiet.
id String eller Integer Nej Valfritt ID som du definierar för att matcha resultat med dina egna databaspersoner. Samma id returneras i svaret för koppling.

Exempel på förfrågningskropp

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

Exempel på förfrågningar


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

Exempel PHP cURL

<?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;
?>

Exempel JavaScript fetch

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));

Exempel Python requests

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())

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

Fält i svaret

Fält Typ Beskrivning
status Boolean Anger om förfrågan lyckades.
used_credits Integer Antal krediter som användes för denna förfrågan.
remaining_credits Integer Återstående krediter på ditt konto efter denna förfrågan.
expires Integer (timestamp) Datum då paketet löper ut, som UNIX-timestamp.
names Array av objekt Lista med resultat för varje inskickat användarnamn.
names[].name String Detekterat förnamn, om något, som extraherats från användarnamnet.
names[].q String Ditt ursprungliga användarnamn som skickades in.
names[].gender Enum[String] Förutspått kön: male, female eller null.
names[].country String Landkod som beaktats vid förutsägelsen.
names[].total_names Integer Antal datapunkter som använts för förutsägelsen.
names[].probability Integer Säkerhetsprocent för könsförutsägelsen.
names[].id String / Integer Samma id som du skickade in, för att koppla resultat till dina egna data.
duration String Total tid för att behandla förfrågan (t.ex. 5ms).