Hent Kjønn via Brukernavn – Flere Forespørsler

Endepunktet Multiple Username lar deg analysere kjønn for opptil 50 brukernavn i én enkelt forespørsel. Dette er nyttig for massebehandling og høyytelsesintegrasjoner. Alle parametere sendes via en POST-forespørsel som JSON. Du må autentisere deg ved hjelp av Bearer-token-metoden i Authorization-headeren.

API-et vil forsøke å trekke ut et sannsynlig fornavn fra hvert brukernavn, noe som kan bidra til bedre kjønnsprediksjon. Du kan også sende med et valgfritt country-filter og et egendefinert id-felt for hver post for å matche resultatene med databasen din.

Advarsel: Brukernavn forventes vanligvis å være skrevet med latinske tegn. De kan imidlertid ofte inneholde ord eller kombinasjoner som ikke representerer ekte navn, f.eks. cool_boy123.

Hvis ditt hovedmål er mest mulig nøyaktig kjønnsprediksjon, anbefaler vi å bruke enkeltforespørsler med parameteren forceToGenderize aktivert.

Hvis målet ditt først og fremst er å trekke ut mulige navn fra brukernavn, kan du bruke flere forespørsler i stedet.

Forespørsels-URL

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

Nødvendige HTTP-headere

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

Parametere i Forespørselsbody

Felt Type Påkrevd Beskrivelse
data Array of Objects Ja Liste over brukernavn og tilhørende valgfri informasjon. Maks 50 oppføringer per forespørsel.
username String Ja (inne i hvert objekt) Brukernavnet som skal analyseres. Kan inneholde understreker, tall osv.
country String Nei En tobokstavs landskode (ISO 3166-1 alpha-2) for å forbedre nøyaktigheten. Eksempel: TR for Tyrkia.
id String eller Integer Nei Valgfritt ID-felt du definerer for å matche resultatene med dine egne databaseposter. Samme id returneres i svaret for å lette samsvaringen.

Eksempel på Forespørselsbody

{
  "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ørsler


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

Felter i Svar

Felt Type Beskrivelse
status Boolean Indikerer om forespørselen var vellykket.
used_credits Integer Antall kreditter brukt for denne forespørselen.
remaining_credits Integer Antall kreditter igjen på kontoen din etter forespørselen.
expires Integer (timestamp) Utløpsdato for pakken, som UNIX timestamp.
names Array av objekter Liste over resultater for hvert brukernavn du sendte inn.
names[].name String Det oppdagede fornavnet (hvis noe) som ble hentet ut fra brukernavnet.
names[].q String Ditt originale innsendte brukernavn.
names[].gender Enum[String] Predikert kjønn: male, female eller null.
names[].country String Landskode vurdert under prediksjonen.
names[].total_names Integer Antall prøver brukt for denne prediksjonen.
names[].probability Integer Sannsynlighetsprosent for prediksjonen.
names[].id String / Integer Samme id som du sendte inn i forespørselen. Brukes til å matche dine egne poster.
duration String Total behandlingstid for forespørselen (f.eks. 5ms).