Λήψη Φύλου μέσω Username - Μοναδικό Αίτημα

Το endpoint Get Gender by Username σου επιτρέπει να προσδιορίσεις το φύλο ενός ατόμου αναλύοντας ένα username ή ψευδώνυμο. Όλες οι παράμετροι αποστέλλονται μέσω αιτήματος POST σε μορφή JSON. Πρέπει να πραγματοποιήσεις αυθεντικοποίηση χρησιμοποιώντας τη μέθοδο Bearer token στην κεφαλίδα Authorization.

Request URL

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

Απαραίτητα HTTP Headers

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

Παράμετροι Σώματος Αιτήματος (Request Body Parameters)

Παράμετρος	Τύπος	Απαραίτητο	Περιγραφή
username	String	Ναι	Το username ή το ψευδώνυμο που θέλεις να αναλύσεις. Μπορεί να είναι όνομα χρήστη σε social media, screen name ή ψευδώνυμο. Μπορεί να περιλαμβάνει λέξεις που δεν είναι ονόματα, όπως όροι φαντασίας ή εμπορικά σήματα.
country	String	Όχι	Κωδικός χώρας δύο χαρακτήρων (ISO 3166-1 alpha-2) για βελτίωση της ακρίβειας της πρόβλεψης. Παράδειγμα: `TR` για την Τουρκία.
askToAI	Boolean	Όχι	Αν οριστεί σε `true`, το API θα ζητήσει από ένα μοντέλο AI να προσδιορίσει το φύλο αν το όνομα που εξήχθη δεν βρεθεί στη βάση δεδομένων.
forceToGenderize	Boolean	Όχι	Αν οριστεί σε `true`, το API θα προσπαθήσει να μαντέψει το φύλο ακόμη και για usernames που δεν μοιάζουν με πραγματικά ανθρώπινα ονόματα, όπως φανταστικοί όροι ή ψευδώνυμα (π.χ. `sparkling_unicorn`).

Παραδείγματα Αιτημάτων

Παράδειγμα με cURL

curl -X POST "https://api.genderapi.io/api/username" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{"username": "sparkling_unicorn", "country": "US", "askToAI": true, "forceToGenderize": true}'

Παράδειγμα με PHP cURL

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

$data = array(
    "username" => "sparkling_unicorn",
    "country" => "US",
    "askToAI" => true,
    "forceToGenderize" => true
);

$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

fetch("https://api.genderapi.io/api/username", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    username: "sparkling_unicorn",
    country: "US",
    askToAI: true,
    forceToGenderize: true
  })
})
.then(response => response.json())
.then(data => console.log(data));

Παράδειγμα με Python requests

import requests

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

payload = {
    "username": "sparkling_unicorn",
    "country": "US",
    "askToAI": True,
    "forceToGenderize": True
}

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

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

print(response.json())

Παράδειγμα JSON Response

{
  "status": true,
  "used_credits": 1,
  "remaining_credits": 4999,
  "expires": 1743659200,
  "q": "sparkling_unicorn",
  "name": "Sparkling",
  "gender": "female",
  "country": "US",
  "total_names": 9876,
  "probability": 92,
  "duration": "6ms"
}

Πεδία στην Απόκριση

Πεδίο	Τύπος	Περιγραφή
status	Boolean	Δείχνει αν το αίτημα ήταν επιτυχές.
used_credits	Integer	Ο αριθμός των credits που καταναλώθηκαν για το συγκεκριμένο αίτημα.
remaining_credits	Integer	Τα υπόλοιπα credits στο λογαριασμό σου μετά από αυτό το αίτημα.
expires	Integer (timestamp)	Η ημερομηνία λήξης του πακέτου σε UNIX timestamp.
q	String	Το αρχικό query εισόδου σου (το username που στάλθηκε).
name	String	Το εξαγόμενο μικρό όνομα από το username.
gender	Enum[String]	Το προβλεπόμενο φύλο. Πιθανές τιμές: `male`, `female` ή `null`.
country	String	Ο κωδικός χώρας που χρησιμοποιήθηκε στην πρόβλεψη.
total_names	Integer	Ο αριθμός των δειγμάτων που χρησιμοποιήθηκαν για την πρόβλεψη.
probability	Integer	Ποσοστό βεβαιότητας της πρόβλεψης φύλου.
duration	String	Ο χρόνος που χρειάστηκε για την επεξεργασία του αιτήματος (π.χ. `6ms`).