Määritä sukupuoli käyttäjänimestä – Useita pyyntöjä

Multiple Username -päätepisteen avulla voit analysoida jopa 50 käyttäjänimen sukupuolen yhdellä pyynnöllä. Tämä sopii eräajoon ja suorituskykyisiin integraatioihin. Kaikki parametrit täytyy lähettää JSON-muotoisena POST-pyyntönä. Pyyntö tulee tunnistaa Bearer-tunnuksella Authorization-otsikossa.

API yrittää tunnistaa mahdollisen nimen jokaisesta käyttäjänimestä, mikä voi parantaa sukupuoliarvauksen tarkkuutta. Voit myös halutessasi antaa country-suodattimen ja mukautetun id-kentän tulosten yhdistämiseksi omiin tietueisiisi.

Huomio: Käyttäjänimien tulisi yleensä olla latinalaisilla kirjaimilla. Usein niissä on kuitenkin sanoja tai yhdistelmiä, jotka eivät vastaa oikeita nimiä, kuten cool_boy123.

Jos tavoitteenasi on tarkka sukupuoliennuste, suosittelemme käyttämään yksittäisiä pyyntöjä forceToGenderize-parametri päällä.

Jos haluat vain tunnistaa mahdollisia nimiä käyttäjänimistä, voit käyttää useita pyyntöjä.

Pyyntöosoite

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

Vaaditut HTTP-otsikot

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

Pyyntörungon parametrit

Kenttä Tyyppi Pakollinen Kuvaus
data Objektien taulukko Kyllä Taulukko, jossa on käyttäjänimet ja niiden valinnaiset parametrit. Voit lähettää jopa 50 tietuetta per pyyntö.
username Merkkijono Kyllä (jokaisessa objektissa) Käyttäjänimi analysoitavaksi. Voi sisältää alaviivoja, numeroita jne.
country Merkkijono Ei Kaksikirjaiminen maakoodi (ISO 3166-1 alpha-2) tarkkuuden parantamiseksi. Esim. TR = Turkki.
id Merkkijono tai kokonaisluku Ei Valinnainen tunniste, jonka avulla voit yhdistää tulokset omiin tietueisiisi. Sama id palautetaan vastauksessa yhdistämistä varten.

Esimerkkipyynnön runko

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

Esimerkkipyynnöt


cURL-esimerkki

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 -esimerkki

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

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 -esimerkki

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

Esimerkkivastaus JSON-muodossa

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

Vasteen kentät

Kenttä Tyyppi Kuvaus
status Boolean Osoittaa, onnistuiko pyyntö.
used_credits Kokonaisluku Tässä pyynnössä käytettyjen krediittien määrä.
remaining_credits Kokonaisluku Krediittien määrä jäljellä pyynnön jälkeen.
expires Kokonaisluku (timestamp) Paketin vanhenemisaika UNIX-muodossa.
names Objektien taulukko Lista tuloksista jokaiselle käyttäjänimelle.
names[].name Merkkijono Käyttäjänimestä mahdollisesti tunnistettu nimi.
names[].q Merkkijono Alkuperäinen lähettämäsi käyttäjänimi.
names[].gender Enum[String] Ennustettu sukupuoli: male, female tai null.
names[].country Merkkijono Ennustamisessa huomioitu maa.
names[].total_names Kokonaisluku Tässä ennusteessa käytettyjen niminäytteiden määrä.
names[].probability Kokonaisluku Sukupuoliennusteen varmuusprosentti.
names[].id Merkkijono / kokonaisluku Sama id jonka lähetit, yhdistämistä varten.
duration Merkkijono Pyynnön käsittelyaika (esim. 5ms).