Prøv V2-API'et
Analysér en e-mailadresse
Send en værdi, og se hele svaret, inklusive ukendte resultater og brugte kreditter.
Svaret nedenfor er et rigtigt svar, hentet den 1. oktober 2026. Klik på Analysér for at sende en forespørgsel.
| Navn | Anders |
|---|---|
| Køn | Mand |
| Sikkerhed | 98 % |
| Kilde | AI-model |
| Brugte kreditter | 2 |
{
"data": {
"input": {
"type": "email",
"value": "anders.jensen@example.com",
"country": null
},
"name": "anders",
"gender": "male",
"country": null,
"confidence": 0.98,
"confidence_kind": "model_reported",
"sample_count": null,
"source": "ai",
"result_status": "identified",
"reason": null,
"country_source": null,
"match": {
"name": null,
"method": "model_inference",
"scope": null,
"country": null
}
},
"meta": {
"request_id": "74947fb3-196c-4b44-a206-4f63e78a494f",
"duration_ms": 372,
"access": {
"mode": "api_key",
"reason": null
},
"usage": {
"charged_credits": 2,
"remaining_credits": 49999,
"billing_status": "confirmed",
"resets_at": null,
"limit": null,
"period_seconds": null
}
}
}Dette rigtige svar blev hentet den 1. oktober 2026; kun kontosaldoen er erstattet. Live-værdier kan være anderledes. En forudsigelse er ikke en bekræftet identitet.
Sådan fungerer det
Fra e-mailadresse til strukturerede data
Integrationsmuligheder
Vælg, hvor e-maildataene skal behandles
Microsoft Excel
Behandl kolonner med adresser med tilføjelsen til Excel
Vælg metoden til e-mailadresser, og tilknyt derefter kildekolonnen og resultatfelterne. Brug GENDER.FROM_EMAIL til dynamiske opslag i celler eller sidepanelet til varige resultater.
Google Sheets
Analysér e-mailadresser med tilføjelsen eller en formel
Brug tilføjelsen til eksisterende rækker, en understøttet arbejdsgang til nye rækker eller formlen GENDER til opslag i enkelte celler.
REST API
Integrér analysen af e-mailadresser i dit backend
Kald det godkendte endpoint for e-mailadresser fra serveren uden at eksponere API-nøglen i browseren eller i offentlig kode. Håndtér svarskemaet, fejlkoderne og forbruget af kreditter eksplicit.

Nøjagtighed og ansvarlig brug
Fremtving ikke et resultat, når adressen ikke indeholder et navn
Funktionsadresser, tilfældige identifikatorer og delte postkasser giver ikke altid et pålideligt signal. Bevar data.result_status, data.reason og data.confidence, og håndtér usikre resultater separat.
Implementeringsguide til V2
Gem kildedata og forudsigelse hver for sig
Bevar postens oprindelige identifikator. API'et åbner ingen profil, kontrollerer ikke, hvem der ejer en konto, og bekræfter ikke nogen identitet. Send kun en landekontekst, når du har en pålidelig oplysning; udled den ikke af domænet eller af webstedets sprog.
| Post | Felt | Fortolkning |
|---|---|---|
| Kildepost | contact_id / original_email | Bevar kildedataene i dit eget system, og erstat ikke et navn, som personen selv har oplyst, med forudsigelsen. Det er ikke felter i API-svaret. |
| Kandidatnavn | data.name / data.match | Det valgte navn kan være null. Der findes ikke et felt til et verificeret efternavn, og et match beviser ikke, hvem der ejer postkassen. |
| Forudsigelse | data.gender / data.result_status / data.reason | Gem et ukendt resultat som JSON-null. En uafgjort række i datasættet kan indeholde et kandidatnavn uden køn. |
| Evidens | data.source / data.confidence_kind / data.confidence / data.sample_count | confidence ligger mellem 0 og 1. Hyppighed i datasættet og en AI-score er forskellige mål; for AI er sample_count null. |
| Log over operationen | meta.request_id / meta.usage | Gem id'et og opkrævningsstatussen; et tabt svar betyder hverken, at operationen var gratis, eller at den mislykkedes. |
Opslaget i datasættet analyserer delen før @, fjerner et suffiks, der begynder med +, og vurderer kandidatnavnene. En standardforespørgsel kan desuden tilføje et begrænset antal kandidater ud fra præfiks og suffiks i sammensatte dele. Hvis flere rækker matcher, vælges den med det højeste antal registrerede forekomster; den kandidat er ikke nødvendigvis personens rigtige navn. Hvis du sender et land, foretrækkes landets række for hver kandidat; mangler den, kan en global række bruges. Kontrollér data.match.scope og country_source.
Vælg behandlingstilstand og pris i kreditter
| Indstilling | Behandling | Pris pr. gennemført element |
|---|---|---|
| options.ai_mode: off | Kun datasættet | 1 kredit |
| options.ai_mode: fallback | Først datasættet; hvis der ikke kan bestemmes et køn, almindelig AI-fallback | 1 kredit i alt, inklusive AI |
| options.ai_mode: always | Direkte til AI | 2 kreditter |
| forceToGenderize: true | Først datasættet, derefter fortolkning af kaldenavnet uden krav om et egentligt fornavn | 1, hvis datasættet er nok; 2 i alt, hvis AI bruges |
For en enkeltforespørgsel er standarden fallback, for elementer i en batch off. forceToGenderize er valgfrit for navne, e-mailadresser og brugernavne; udelad i så fald ai_mode, eller brug fallback, fordi indstillingen ikke kan kombineres med off og always. Gennemførte unknown-resultater opkræves også. En positiv startsaldo er nok til at gå i gang; når operationen er afsluttet, kan saldoen blive negativ.
Når AI bruges, modtager den hele den adresse, du har sendt, inklusive domænet og +-suffikset, også selvom den bliver bedt om at se bort fra de dele. forceToGenderize kan give en kobling til et køn, uden at der er fundet et egentligt fornavn; det betyder ikke, at der er udtrukket et verificeret navn i dit CRM.
Prøv først en e-mailforespørgsel, der kun bruger datasættet
Eksempelinput garanterer ikke en bestemt forudsigelse. Sæt GENDERAPI_API_KEY i servermiljøet, og læg ikke nøglen i offentlig kode på klientsiden. V1 og V2 bruger den samme kontonøgle og den samme saldo. Kontrollér nøglen med /api/v2/usage, og bekræft, at meta.access.mode har værdien api_key.
Vælg et programmeringssprog. Konfigurér din API-nøgle, og kør derefter eksemplet på din server.
Hver forespørgsel om en forudsigelse er en ny operation, der koster kreditter, også når den gentages. Eksemplerne prøver ikke automatisk igen. Kontrollér opkrævningsstatus, før du sender en ny forespørgsel.
Før du kører: adgang og fejlhåndtering
Kør eksemplerne på din server. Sæt GENDERAPI_API_KEY i procesmiljøet til din eksisterende API-nøgle. Bekræft, at meta.access.mode er api_key: En nøgle, der ikke genkendes, kan føre til IP-prøveadgangen.
JSON-svar med HTTP 4xx og 5xx bevarer fejlens body og returnerer en exitstatus, der ikke er nul. Kontrollér code, action og meta.usage.billing_status, før du prøver igen.
Guide til fejl og nye forsøg →cURL 7.76+ i en POSIX-shell. Kør i din terminal. Dokumentation for kørselsmiljøet
Node.js 22+, indbygget fetch. Gem som example.mjs, og kør node example.mjs. Dokumentation for kørselsmiljøet
Python 3.10+, standardbiblioteket. Gem som example.py, og kør python3 example.py. Dokumentation for kørselsmiljøet
PHP 8+ med cURL-udvidelsen. Gem som example.php, og kør php example.php. Dokumentation for kørselsmiljøet
Java 17+, standard-HTTP-klienten. Gem som GenderApiExample.java, og kør java GenderApiExample.java. Dokumentation for kørselsmiljøet
Konsolapplikation med .NET 8+. Brug som Program.cs i et konsolprojekt, og kør derefter dotnet run. Dokumentation for kørselsmiljøet
Go 1.22+, standardbiblioteket. Gem som main.go, og kør go run main.go. Dokumentation for kørselsmiljøet
Håndtér resultater fra lister og gentagne forespørgsler
POST /api/v2/gender/batch accepterer op til 50 elementer med en API-nøgle og 10 med IP-prøveadgangen. Giv hvert element sine egne værdier for type, value og options. Hvis du vil bruge den almindelige AI-fallback, skal du angive fallback udtrykkeligt i hvert element. id skal være unikt inden for batchen; index starter ved nul inden for den sendte batch. Gem dine egne job- og kilderækkeidentifikatorer separat.
HTTP 200 betyder ikke, at alle elementer er gennemført. Håndtér resultaterne identified, unknown og error hver for sig; meta.summary.succeeded tæller både identified og unknown. Vurdér data.gender, source, confidence_kind, confidence, match og reason samlet. Behandl ikke en AI-score og en hyppighed i datasættet som ligeværdige.
Hvis meta.usage.billing_status har værdien confirmed, skal du kun gentage de driftsfejl, der tillader en ny forespørgsel. Hvis statussen er unconfirmed, eller svaret er gået tabt, skal du stoppe og kontrollere opkrævningen. Hvis du sender det samme element igen, også et gennemført unknown-resultat, oprettes en ny betalt operation; send aldrig hele listen igen i blinde.
Kontrakt for batchforespørgsler · Svarfelter · AI-indstillinger · Vurdering af nøjagtighed og konfidens · Privatlivspolitik
Tilføjelserne til Excel og Google Sheets og de andre færdige integrationer kan bruge deres egen forbindelse og deres eget resultatformat. Gå ikke ud fra, at deres output følger dette V2-JSON-skema; læs den aktuelle guide til den pågældende integration.
Ofte stillede spørgsmål
Navn og køn fra e-mailadresser
Kan man udtrække et navn fra en e-mailadresse?
GenderAPI kan udtrække et kandidatnavn fra delen før @ i understøttede personlige adresser og, når de er tilgængelige, returnere oplysninger om køn, land og konfidens. Kandidaten er en slutning og ikke et verificeret navn på den, der ejer postkassen.
Giver alle adresser et navn?
Nej. Funktionsadresser, tilfældige identifikatorer og lokale dele uden et egentligt navn giver ikke altid et pålideligt signal. Kontrollér data.result_status, data.reason, data.confidence og data.confidence_kind i V2-svaret.
Bliver e-mailforespørgsler gemt?
Ifølge den offentliggjorte politik gemmes e-mailforespørgsler ikke som genanvendelige forespørgselsposter. For separate tekniske logfiler og sikkerhedslogfiler gælder de perioder, der er angivet i privatlivspolitikken. Brug ikke følsomme personoplysninger i den offentlige demo.
Kan jeg bruge funktionen i Excel og Google Sheets?
Ja. Kolonner med adresser kan behandles med tilføjelsen til Excel, tilføjelsen til Google Sheets eller importværktøjet til Excel- og CSV-filer. Disse integrationer har deres eget resultatformat, som er forskelligt fra V2-JSON.
Hvilke felter returnerer API'et?
V2 returnerer data.name, data.gender, data.match og felterne for kilde og konfidens, og i meta også operationens id og forbruget af kreditter. Kandidatnavnet eller kønnet kan være null. Der findes ikke et felt til et verificeret efternavn.
Hvornår bruges AI?
For en enkeltforespørgsel i V2 er den almindelige AI-fallback slået til som standard. I denne demo kan du bruge en standardforespørgsel eller forceToGenderize; off og always angiver du i API-forespørgslen. Den almindelige AI-fallback koster 1 kredit i alt, always 2. Med forceToGenderize opkræves 1 kredit, hvis datasættet giver et resultat, eller 2 i alt, hvis AI bruges; resultatet kan forblive unknown.
Kan jeg prøve tjenesten gratis?
Konti indeholder 200 gratis kreditter om dagen, og den delte IP-prøveadgang giver 10 kreditter pr. offentlig IP-adresse inden for 24 timer. En manglende eller ukendt nøgle kan føre til IP-prøveadgangen; kontrollér feltet meta.access.mode i svaret. Der er tale om kreditter, ikke et antal forespørgsler.
