Sukupuolen määritys sähköpostista – Useita pyyntöjä

Multiple Email -päätepisteen avulla voit analysoida jopa 50 sähköpostiosoitetta yhdellä pyynnöllä. Tämä on hyödyllistä massakäsittelyssä ja suorituskykyisissä integraatioissa. Kaikki parametrit lähetetään POST-pyynnön mukana JSON-muodossa. Sinun täytyy tunnistautua käyttämällä Bearer-tunnusta Authorization-otsikossa.

API poimii todennäköisen etunimen jokaisesta sähköpostiosoitteesta ja määrittää sukupuolen. Voit myös lisätä valinnaisen country-suodattimen sekä mukautetun id-kentän jokaiselle riville, jotta voit yhdistää tulokset omaan tietokantaasi.

Pyyntöosoite

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

Vaaditut HTTP-otsikot

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

Pyyntörunko-parametrit

Kenttä Tyyppi Pakollinen Kuvaus
data Objektitaulukko Kyllä Taulukko sähköposteista ja niiden valinnaisista parametreista. Maksimi 50 riviä pyyntöä kohden.
email Merkkijono Kyllä (jokaisessa objektissa) Sähköpostiosoite analysoitavaksi. API poimii todennäköisen etunimen.
country Merkkijono Ei Kaksikirjaiminen maakoodi (ISO 3166-1 alpha-2) parantamaan ennusteen tarkkuutta. Esim: TR Turkille.
id Merkkijono tai kokonaisluku Ei Valinnainen tunniste, jolla voit yhdistää tulokset omaan tietokantaan. Sama id palautetaan vastauksessa.

Esimerkki pyyntödatasta

{
  "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" }
  ]
}

Esimerkkipyynnöt


cURL-esimerkki

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 -esimerkki

<?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 -esimerkki

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 -esimerkki

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())

Esimerkki JSON-vastauksesta

{
  "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"
}

Vasteen kentät

Kenttä Tyyppi Kuvaus
status Boolean Kertoo, onnistuiko pyyntö.
used_credits Kokonaisluku Tähän pyyntöön käytettyjen krediittien määrä.
remaining_credits Kokonaisluku Käyttäjätilillesi jääneet krediitit pyynnön jälkeen.
expires Kokonaisluku (timestamp) Paketin vanhenemispäivä UNIX-aikaleimana.
names Objektitaulukko Vastausten lista jokaiselle sähköpostille.
names[].name Merkkijono Sähköpostista poimittu etunimi.
names[].q Merkkijono Alkuperäinen syöttämäsi sähköposti.
names[].gender Enum[String] Ennustettu sukupuoli: male, female tai null.
names[].country Merkkijono Maa, jota ennusteessa on käytetty.
names[].total_names Kokonaisluku Kuinka monesta nimestä ennuste on laskettu.
names[].probability Kokonaisluku Varmuusprosentti sukupuoliennusteessa.
names[].id Merkkijono / Kokonaisluku Sama id, jonka annoit pyynnössä. Käytetään yhdistämiseen omiin tietueisiisi.
duration Merkkijono Koko pyynnön käsittelyaika (esim. 5ms).