GenderAPI από Email – Τεκμηρίωση Μεμονωμένου Αιτήματος

Επισκόπηση αιτήματος

Από τη διεύθυνση email στην πρόβλεψη

Το GenderAPI αναλύει το τοπικό τμήμα της διεύθυνσης, εξάγει το πιθανότερο όνομα και το χρησιμοποιεί για πρόβλεψη φύλου. Προσθέστε χώρα όταν γνωρίζετε την περιοχή του χρήστη.

01Εισαγωγή emailmichael.smith@example.com

02Εξαγωγή ονόματοςMichael

03Πρόβλεψηmale · 97%

ΜέθοδοςPOST

Τύπος περιεχομένουapplication/json

Έλεγχος ταυτότηταςBearer token

Κόστος1 αναζήτηση

HDR

Απαιτούμενα HTTP headers

Πιστοποιήστε το αίτημα

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Σώμα αιτήματος JSON

Παράμετροι

Παράμετρος	Τύπος	Απαίτηση	Περιγραφή
`email`	string	Απαιτείται	Η διεύθυνση email που θα αναλυθεί. Το GenderAPI εξάγει το πιθανότερο όνομα πριν από την πρόβλεψη.
`country`	string	Προαιρετικό	Κωδικός χώρας ISO 3166-1 alpha-2, όπως US ή GR, για προσθήκη γεωγραφικού πλαισίου.
`askToAI`	boolean	Προαιρετικό	Όταν είναι true, χρησιμοποιείται AI fallback αν το όνομα που εξήχθη δεν έχει αποτέλεσμα στη βάση δεδομένων.

AI fallback

Το askToAI αξιολογείται μετά την εξαγωγή ονόματος και μόνο όταν το όνομα δεν βρεθεί στη βάση δεδομένων. Το email endpoint δεν δέχεται forceToGenderize.

Παραδείγματα κώδικα

Στείλτε ένα αίτημα email

cURL

curl -X POST "https://api.genderapi.io/api/email" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"email":"michael.smith@example.com","country":"US","askToAI":true}'

JavaScript

const response = await fetch("https://api.genderapi.io/api/email", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ email: "michael.smith@example.com", country: "US", askToAI: true })
});
const data = await response.json();

Python

import requests

response = requests.post(
  "https://api.genderapi.io/api/email",
  headers={"Authorization": "Bearer YOUR_API_KEY"},
  json={"email": "michael.smith@example.com", "country": "US", "askToAI": True}
)
print(response.json())

Απόκριση 200

Όνομα που εξήχθη και πρόβλεψη

JSON

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

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

Πεδίο	Τύπος	Περιγραφή
`status`	boolean	Δηλώνει αν το αίτημα ολοκληρώθηκε επιτυχώς.
`used_credits`	integer	Μονάδες που καταναλώθηκαν από το αίτημα.
`remaining_credits`	integer	Διαθέσιμες μονάδες μετά το αίτημα.
`expires`	integer	Χρόνος λήξης πακέτου ως UNIX timestamp.
`q`	string	Το αρχικό email που υποβλήθηκε.
`name`	string	Το όνομα που εξήχθη από τη διεύθυνση email.
`gender`	string \| null	Προβλεπόμενη τιμή: male, female ή null.
`country`	string	Κωδικός χώρας που λήφθηκε υπόψη.
`total_names`	integer	Πλήθος δειγμάτων που υποστηρίζουν την πρόβλεψη.
`probability`	integer	Βεβαιότητα πρόβλεψης ως ποσοστό.
`duration`	string	Χρόνος επεξεργασίας στον server.

Χρησιμοποιήστε έγκυρη, πλήρη διεύθυνση email

Η εξαγωγή ονόματος εξαρτάται από τη δομή της διεύθυνσης. Γενικά inboxes, aliases ή τοπικά τμήματα χωρίς αναγνωρίσιμο όνομα μπορεί να μην επιστρέψουν αποτέλεσμα· ελέγξτε τα name, gender καιprobability πριν χρησιμοποιήσετε την πρόβλεψη.

Ιδιωτικότητα email: Τα email που υποβάλλονται σε αναζήτηση δεν αποθηκεύονται. Δείτε την Πολιτική Απορρήτου για λεπτομέρειες επεξεργασίας δεδομένων.

Επόμενος οδηγός

Αναλύστε πολλές διευθύνσεις email

Μαζικό αίτημα emailΕπεξεργαστείτε πολλές διευθύνσεις σε ένα αίτημα →Μεμονωμένο αίτημα ονόματοςΣτείλτε απευθείας ένα γνωστό όνομα →