Εύρεση φύλου από email – Μοναδικό αίτημα

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

URL αιτήματος

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

Απαιτούμενες κεφαλίδες HTTP

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

Παράμετροι σώματος αιτήματος

Παράμετρος Τύπος Υποχρεωτικό Περιγραφή
email String Ναι Η διεύθυνση email για ανάλυση. Η API θα εξάγει το πιθανό όνομα πριν προσδιορίσει το φύλο.
country String Όχι Διψήφιος κωδικός χώρας (ISO 3166-1 alpha-2) για βελτίωση της ακρίβειας. Παράδειγμα: TR για Τουρκία.
askToAI Boolean Όχι Αν οριστεί σε true, η API θα ρωτήσει ένα μοντέλο τεχνητής νοημοσύνης να προσδιορίσει το φύλο εάν το εξαγόμενο όνομα δεν βρεθεί στη βάση δεδομένων.

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


Παράδειγμα 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}'

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

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

$data = array(
    "email" => "michael.smith@example.com",
    "country" => "US",
    "askToAI" => 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/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
  })
})
.then(response => response.json())
.then(data => console.log(data));

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

import requests

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

payload = {
    "email": "michael.smith@example.com",
    "country": "US",
    "askToAI": True
}

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

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

print(response.json())

Παράδειγμα απόκρισης 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 Αριθμός credits που χρησιμοποιήθηκαν για αυτό το αίτημα.
remaining_credits Integer Τα εναπομείναντα credits στον λογαριασμό σας μετά από αυτό το αίτημα.
expires Integer (timestamp) Η ημερομηνία λήξης του πακέτου ως UNIX timestamp.
q String Το αίτημα που υποβάλατε (το email).
name String Το εξαγόμενο όνομα από τη διεύθυνση email.
gender Enum[String] Προβλεπόμενο φύλο. Πιθανές τιμές: male, female ή null.
country String Ο κωδικός χώρας που λήφθηκε υπόψη στην πρόβλεψη.
total_names Integer Αριθμός δειγμάτων που χρησιμοποιήθηκαν για αυτήν την πρόβλεψη.
probability Integer Ποσοστό βεβαιότητας για την πρόβλεψη φύλου.
duration String Χρόνος επεξεργασίας του αιτήματος (π.χ. 5ms).