Hent Kjønn via E-post – Flere Forespørsler

Endepunktet Multiple Email lar deg analysere kjønn på opptil 50 e-postadresser i én enkelt forespørsel. Dette er nyttig for massebehandling og høytytende integrasjoner. Alle parametere sendes via en POST-forespørsel som JSON. Du må autentisere deg ved hjelp av Bearer-token i Authorization-headeren.

API-et trekker ut sannsynlige fornavn fra hver e-postadresse og bestemmer kjønn for hver. Du kan også sende en valgfri country-filter og et egendefinert id-felt for hver post for å matche resultater mot databasen din.

Forespørsels-URL

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

Nødvendige HTTP-headere

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

Parametere i Forespørselsbody

Felt Type Obligatorisk Beskrivelse
data Array av objekter Ja Liste over e-poster og deres valgfrie parametere. Maksimalt 50 oppføringer per forespørsel.
email String Ja (i hvert objekt) E-postadressen som skal analyseres. API-et trekker ut sannsynlig fornavn.
country String Nei Tostavet landskode (ISO 3166-1 alpha-2) for å forbedre nøyaktigheten i prediksjonen. Eksempel: TR for Tyrkia.
id String eller Integer Nei Valgfri ID som du definerer for å matche resultater med egne databaseposter. Den samme id returneres i svaret for å lette mapping.

Eksempel på Forespørselsbody

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

Eksempler på Forespørsler


cURL-eksempel

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

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

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

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

Eksempel på JSON-svar

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

Felt i Svaret

Felt Type Beskrivelse
status Boolean Indikerer om forespørselen var vellykket.
used_credits Integer Antall kreditter brukt for denne forespørselen.
remaining_credits Integer Kreditter igjen på kontoen din etter denne forespørselen.
expires Integer (timestamp) Dato når pakken utløper, som UNIX-timestamp.
names Array av objekter Liste med resultater for hver e-post du sendte inn.
names[].name String Det uttrukne fornavnet fra e-posten.
names[].q String Din originale e-postinput.
names[].gender Enum[String] Forutsagt kjønn: male, female eller null.
names[].country String Landskode brukt ved prediksjonen.
names[].total_names Integer Antall forekomster som ble brukt i prediksjonen.
names[].probability Integer Prosentvis sikkerhet for kjønnsprediksjonen.
names[].id String / Integer Den samme id som du sendte i forespørselen. Brukes for å matche dine egne poster.
duration String Total behandlingstid for forespørselen (f.eks. 5ms).