Hromadné určení pohlaví z e-mailu API

Přehled hromadného požadavku

Zpracujte až 50 e-mailových adres

Odešlete pole data. GenderAPI z každé adresy extrahuje pravděpodobné jméno a vrátí odpovídající odhad; volitelné id umožní jednoznačné propojení se záznamem ve vašem systému.

MetodaPOST

Maximum50 e-mailů

AutentizaceBearer token

Formát výsledkunames[]

Nejvýše 50 e-mailůExtrakce jménaVýsledky s kontextem země

Ochrana soukromí: E-mailové dotazy se neukládají. Adresy se zpracují pouze za účelem vrácení výsledků požadavku. Podrobnosti uvádějí zásady ochrany osobních údajů.

HDR

Povinné HTTP hlavičky

Autorizujte hromadný požadavek

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Tělo požadavku JSON

Parametry

Pole	Typ	Požadavek	Popis
`data`	object[]	Povinné	Pole obsahující 1 až 50 e-mailových záznamů.
`data[].email`	string	Povinné	E-mailová adresa, ze které GenderAPI extrahuje pravděpodobné křestní jméno.
`data[].country`	string	Volitelné	Kód země ISO 3166-1 alpha-2 použitý jako regionální kontext.
`data[].id`	string \| integer	Volitelné	Váš identifikátor záznamu, který se vrátí beze změny s odpovídajícím výsledkem.

Propojení záznamů

Pro každou položku použijte unikátní id. GenderAPI je vrátí s výsledkem položky, takže můžete aktualizovat správný záznam bez spoléhání pouze na pořadí v poli.

Data požadavku

Sestavte pole e-mailů

JSON

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

Příklady kódu

Odešlete požadavek s více e-maily

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":"james.brown@example.com","country":"US","id":"789"}]}'

JavaScript

const data = [
  { email: "andrea.schmidt@example.com", country: "DE", id: "123" },
  { email: "james.brown@example.com", country: "US", id: "789" }
];
const response = await 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 })
});

Odpověď 200

Extrahovaná jména a odhady

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": "James", "q": "james.brown@example.com", "gender": "male", "country": "US", "total_names": 45274, "probability": 100, "id": "789" }
  ], "duration": "5ms"
}

Pole odpovědi

Pole	Typ	Popis
`status`	boolean	Určuje, zda byl hromadný požadavek úspěšně zpracován.
`used_credits`	integer	Počet kreditů spotřebovaných všemi odeslanými e-maily.
`remaining_credits`	integer	Počet kreditů dostupných po požadavku.
`expires`	integer	Čas vypršení balíčku jako časové razítko UNIX.
`names`	object[]	Seřazená kolekce výsledků odeslaných e-mailů.
`names[].name`	string	Křestní jméno extrahované z e-mailové adresy.
`names[].q`	string	Původní e-mail odeslaný v požadavku.
`names[].gender`	string \| null	Odhadovaná hodnota: male, female nebo null.
`names[].country`	string	Kód země zohledněný pro tento výsledek.
`names[].total_names`	integer	Počet vzorků podporujících tento výsledek.
`names[].probability`	integer	Míra spolehlivosti odhadu v procentech.
`names[].id`	string \| integer	Vstupní identifikátor vrácený pro propojení záznamů.
`duration`	string	Celková doba zpracování na serveru.

Omezte každý požadavek na 50 záznamů

Každou adresu ověřte a větší datové sady rozdělte do dávek po nejvýše 50 položkách. Před použitím výsledku zkontrolujte extrahované name a hodnotu probability.

Další průvodce

Určete pohlaví podle uživatelského jména

Jednotlivý požadavek na uživatelské jménoExtrahujte jméno z jednoho uživatelského jména →Jednotlivý e-mailový požadavekPoužijte podporu AI pro jeden e-mail →