Ανίχνευση φύλου από Email – Πολλαπλό αίτημα

Το endpoint Multiple Email σας επιτρέπει να αναλύσετε το φύλο έως και 50 διευθύνσεων email σε ένα μόνο αίτημα. Αυτό είναι χρήσιμο για μαζική επεξεργασία και integrations με υψηλή απόδοση. Όλες οι παράμετροι αποστέλλονται μέσω POST αιτήματος ως JSON. Πρέπει να γίνει ταυτοποίηση χρησιμοποιώντας μέθοδο Bearer token στην επικεφαλίδα Authorization.

Το API εξάγει πιθανό μικρό όνομα από κάθε email και ανιχνεύει το φύλο για το καθένα. Μπορείτε επίσης να περάσετε προαιρετικό φίλτρο country και ένα custom id πεδίο για κάθε εγγραφή, ώστε να ταιριάξετε τα αποτελέσματα με τη βάση δεδομένων σας.

Διεύθυνση αιτήματος (Request URL)

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

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

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

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

Πεδίο Τύπος Απαραίτητο Περιγραφή
data Πίνακας αντικειμένων (Array of Objects) Ναι Πίνακας email και των προαιρετικών παραμέτρων τους. Μέγιστο 50 ανά αίτημα.
email String Ναι (μέσα σε κάθε αντικείμενο) Το email προς ανάλυση. Το API θα εξάγει το πιθανό μικρό όνομα.
country String Όχι Κωδικός χώρας δύο χαρακτήρων (ISO 3166-1 alpha-2) για βελτίωση ακρίβειας. Πχ: TR για Τουρκία.
id String ή Integer Όχι Προαιρετικό ID που ορίζετε για αντιστοίχιση αποτελεσμάτων με τα δικά σας δεδομένα. Το ίδιο id θα επιστραφεί στην απόκριση για map.

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

{
  "data": [
    { "email": "andrea.schmidt@example.com", "country": "DE", "id": "123" },
    { "email": "andrea.rossi@example.it", "country": "IT", "id": "456" },
    { "email": "james.brown@example.com", "country": "US", "id": "789" }
  ]
}

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


Παράδειγμα cURL

curl -X POST "https://api.genderapi.io/api/email/multi/country" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{"data":[{"email":"andrea.schmidt@example.com","country":"DE","id":"123"},{"email":"andrea.rossi@example.it","country":"IT","id":"456"},{"email":"james.brown@example.com","country":"US","id":"789"}]}'

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

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

$data = array(
    "data" => array(
        array(
            "email" => "andrea.schmidt@example.com",
            "country" => "DE",
            "id" => "123"
        ),
        array(
            "email" => "andrea.rossi@example.it",
            "country" => "IT",
            "id" => "456"
        ),
        array(
            "email" => "james.brown@example.com",
            "country" => "US",
            "id" => "789"
        )
    )
);

$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/multi/country", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    data: [
      { email: "andrea.schmidt@example.com", country: "DE", id: "123" },
      { email: "andrea.rossi@example.it", country: "IT", id: "456" },
      { email: "james.brown@example.com", country: "US", id: "789" }
    ]
  })
})
.then(response => response.json())
.then(data => console.log(data));

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

import requests

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

payload = {
    "data": [
        { "email": "andrea.schmidt@example.com", "country": "DE", "id": "123" },
        { "email": "andrea.rossi@example.it", "country": "IT", "id": "456" },
        { "email": "james.brown@example.com", "country": "US", "id": "789" }
    ]
}

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": 3,
  "remaining_credits": 7265,
  "expires": 1717069765,
  "names": [
    {
      "name": "Andrea",
      "q": "andrea.schmidt@example.com",
      "gender": "female",
      "country": "DE",
      "total_names": 644,
      "probability": 88,
      "id": "123"
    },
    {
      "name": "Andrea",
      "q": "andrea.rossi@example.it",
      "gender": "male",
      "country": "IT",
      "total_names": 13537,
      "probability": 98,
      "id": "456"
    },
    {
      "name": "James",
      "q": "james.brown@example.com",
      "gender": "male",
      "country": "US",
      "total_names": 45274,
      "probability": 100,
      "id": "789"
    }
  ],
  "duration": "5ms"
}

Πεδία απάντησης

Πεδίο Τύπος Περιγραφή
status Boolean Δείχνει αν το αίτημα ήταν επιτυχές.
used_credits Integer Πόσα credits χρησιμοποιήθηκαν για αυτό το αίτημα.
remaining_credits Integer Υπόλοιπο credits μετά το αίτημα.
expires Integer (timestamp) Ημερομηνία λήξης πακέτου σε UNIX timestamp.
names Array of objects Λίστα αποτελεσμάτων για κάθε email.
names[].name String Το εξαγόμενο μικρό όνομα από το email.
names[].q String Το αρχικό email που στείλατε.
names[].gender Enum[String] Προβλεπόμενο φύλο: male, female ή null.
names[].country String Κωδικός χώρας που χρησιμοποιήθηκε στην πρόβλεψη.
names[].total_names Integer Αριθμός δειγμάτων για την πρόβλεψη.
names[].probability Integer Ποσοστό βεβαιότητας για την πρόβλεψη φύλου.
names[].id String / Integer Το ίδιο id που στείλατε στο αίτημα (για αντιστοίχιση).
duration String Χρόνος επεξεργασίας αιτήματος (π.χ. 5ms).