Skip to main content
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 example jane.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 the Authorization 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 - set type=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=true returns a download_url in the bulk.completed webhook; fetch it with your API key.
  • Export filters: all, found.
See the Bulk Operations guide for the webhook payload, status checks, and download options.