Βασική Χρήση

Το GenderAPI σου επιτρέπει να προσδιορίσεις το φύλο ενός ατόμου χρησιμοποιώντας διάφορους τύπους δεδομένων εισόδου. Μπορείς να αναλύσεις απευθείας μικρά ονόματα ή να εξαγάγεις ονόματα από διευθύνσεις email και ονόματα χρηστών. Δες πώς να ξεκινήσεις:

1. Φύλο από Όνομα

Στείλε ένα μικρό όνομα στο παρακάτω endpoint: 

https://api.genderapi.io/api

Παράδειγμα: 

curl "https://api.genderapi.io/api?name=Alice&key=YOUR_API_KEY"

Μπορείς επίσης να προσθέσεις προαιρετικές παραμέτρους:

  • country: Στείλε κωδικό χώρας δύο γραμμάτων ( ISO 3166-1 alpha-2 ) για μεγαλύτερη ακρίβεια στην πρόβλεψη. Για παράδειγμα: country=TR για την Τουρκία.
  • askToAI: Αν οριστεί σε true, η API θα ζητήσει από ένα μοντέλο τεχνητής νοημοσύνης να προσδιορίσει το φύλο αν το όνομα δεν υπάρχει στη βάση δεδομένων.
  • forceToGenderize: Αν οριστεί σε true, η API θα προσπαθήσει να μαντέψει το φύλο ακόμα και για εισόδους που δεν μοιάζουν με πραγματικά ανθρώπινα ονόματα, όπως ψευδώνυμα ή φανταστικά ονόματα όπως sparkling unicorn ή mystic warrior. Αυτό μπορεί να είναι χρήσιμο για ανάλυση ονομάτων χρηστών, αλλά τα αποτελέσματα μπορεί να είναι λιγότερο ακριβή. Σημείωση: Αυτή η παράμετρος δεν είναι διαθέσιμη στο endpoint για email.

Παράδειγμα με παραμέτρους: 

curl "https://api.genderapi.io/api?name=sparkling%20unicorn&country=US&askToAI=true&forceToGenderize=true&key=YOUR_API_KEY"

2. Φύλο από Διεύθυνση Email

Χρησιμοποίησε αυτό το endpoint αν έχεις μόνο μία διεύθυνση email: 

https://api.genderapi.io/api/email

Παράδειγμα: 

curl "https://api.genderapi.io/api/email?email=alice.smith@example.com&country=TR&askToAI=true&key=YOUR_API_KEY"

Σημείωση: Η παράμετρος forceToGenderize δεν είναι διαθέσιμη για το endpoint email, επειδή αυτό το endpoint εξάγει πρώτα εσωτερικά το όνομα.


3. Φύλο από Όνομα Χρήστη

Για ονόματα χρηστών ή ψευδώνυμα, χρησιμοποίησε: 

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

Παράδειγμα: 

curl "https://api.genderapi.io/api/username?username=sparkling_unicorn&country=US&askToAI=true&forceToGenderize=true&key=YOUR_API_KEY"

Η παράμετρος forceToGenderize είναι ιδιαίτερα χρήσιμη εδώ, επειδή τα ονόματα χρηστών συχνά περιέχουν λέξεις που δεν είναι ονόματα ή φανταστικούς όρους. Αναγκάζει την API να προσπαθήσει να προβλέψει το φύλο ακόμα και αν το input δεν είναι ένα συνηθισμένο ανθρώπινο όνομα.

Όλες οι μέθοδοι υποστηρίζουν είτε μεμονωμένα είτε μαζικά αιτήματα. Για περισσότερες λεπτομέρειες, δες τις αντίστοιχες ενότητες στο μενού πλοήγησης αριστερά.


✅ Απόκριση API

Παράδειγμα JSON απόκρισης για όλα τα endpoints: 

{
  "status": true,
  "used_credits": 1,
  "remaining_credits": 4999,
  "expires": 1743659200,
  "q": "michael.smith@example.com",
  "name": "Michael",
  "gender": "male",
  "country": "US",
  "total_names": 325,
  "probability": 98,
  "duration": "4ms"
}

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

Πεδίο Τύπος Περιγραφή
status Boolean true αν το αίτημα ήταν επιτυχές. Έλεγξε για σφάλματα αν είναι false.
used_credits Integer Ο αριθμός των credits που χρησιμοποιήθηκαν για αυτό το αίτημα.
remaining_credits Integer Τα credits που απομένουν στον λογαριασμό σου μετά από αυτό το αίτημα.
expires Integer (timestamp) Η ημερομηνία λήξης του πακέτου σε UNIX timestamp (δευτερόλεπτα).
q String Το input query σου (όνομα, email ή όνομα χρήστη).
name String Το βρεθέν ή εξαγόμενο μικρό όνομα.
gender Enum[String] Το προβλεπόμενο φύλο. Δυνατές τιμές: male, female ή null.
country Enum[String] Ο πιο πιθανός κωδικός χώρας (π.χ. US, DE).
total_names Integer Αριθμός δειγμάτων που χρησιμοποιήθηκαν για την πρόβλεψη.
probability Integer Ποσοστό πιθανοτήτων για την πρόβλεψη φύλου (π.χ. 50-100).
duration String Χρόνος επεξεργασίας του αιτήματος (π.χ. 4ms).
Προειδοποίηση: Αν οι τιμές εισόδου περιέχουν κενά ή ειδικούς χαρακτήρες (π.χ. sparkling unicorn), φρόντισε να τις κάνεις URL-encode πριν εκτελέσεις GET αιτήματα. Αλλιώς, το αίτημα μπορεί να αποτύχει ή άλλες παράμετροι να παρερμηνευτούν από τη γλώσσα προγραμματισμού ή τη βιβλιοθήκη HTTP που χρησιμοποιείς. 
curl "https://api.genderapi.io/api?name=sparkling unicorn&key=YOUR_API_KEY"
πρέπει να χρησιμοποιήσεις: 
curl "https://api.genderapi.io/api?name=sparkling%20unicorn&key=YOUR_API_KEY"
ή να εφαρμόσεις σωστές URL-encoding συναρτήσεις στη γλώσσα σου.