Βασική Χρήση
Το 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 συναρτήσεις στη γλώσσα σου.