Email
Email Gender
Predict the likely gender and country behind an email address. 1 credit, with free repeats for 6 months.
POST
Email Gender
Overview
Email Gender infers the likely gender and country of the person behind an address from the name embedded in the local part (for examplejane.doe@ or
j.smith@). It returns a single verdict with a confidence score, backed by
genderapi.io. Use it to personalise outreach, segment a list, or fill a missing
gender field before a campaign.
Predict for a single address here (1 credit), or label a whole list with the
bulk job pipeline below.
Authentication
Requires an API key in theAuthorization header.
Request
string
required
The email address to predict gender for.
Example request
Response
string
The email address that was analysed.
string
The predicted gender:
male, female, or unknown when the name cannot be
resolved with confidence.string | null
The most likely country for the name as an ISO alpha-2 code (for example
US,
GB), or null when no country signal is available.number
Confidence in the
gender verdict, from 0 to 100. A low value on an
unknown verdict means the name was ambiguous or not recognised.number
Credits charged for this request.
1 on a fresh charge, or 0 when you were
already charged for this address within the billing window (a free repeat).boolean
Present and
true only when the verdict was served from cache. This is
independent of billing: a cached result is still charged 1 on your first
request for that address in the window.Errors
Errors return a JSON body of the form{"error": "<message>"} with the matching
HTTP status code.
A transient provider error (
502) is never billed. An unknown verdict from a
successful lookup is billed like any other result.Credits
Each lookup costs 1 credit. Billing is per-customer: 1 on the first lookup of an address,0 for repeats within the billing window (about 6 months). See
Credits for details.
Bulk (asynchronous)
To label a whole list, submit it as an async job instead of looping this endpoint. One entrypoint handles every lookup - settype=gender - and a webhook
delivers the finished file when it’s done.
- Up to 1,000,000 emails per job, charged 1 credit per email.
download_link=truereturns adownload_urlin thebulk.completedwebhook; fetch it with your API key.- Export filters:
all,found.
Email Gender