Gender Association
/api/genderassociation 1 credit(s) per call
Statistically determine the likely gender association (male, female, or unisex) for a given first name based on worldwide name frequency data.
Overview
The Gender Association API provides a statistical determination of the likely gender association for a given first name based on worldwide name frequency data from multiple sources. Optionally filter results by country using an ISO 3166-1 alpha-2 code.
Note: This API returns a population-level statistical prediction based on name frequency data. It does not determine or imply anyone's gender identity. Results reflect historical naming patterns and should not be used to make assumptions about individuals.
Endpoint
/api/genderassociation
/api/genderassociation/associate?name=Maria&country=US
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | The first name to look up (case-insensitive) |
| country | string | No | ISO 3166-1 alpha-2 country code (e.g. GB, US) to filter results |
Response Fields
The response is wrapped in a standard API envelope:
| Field | Type | Description |
|---|---|---|
| success | boolean | true on success |
| data.name | string | The normalized name queried |
| data.association | string | Statistically determined gender association: male, female, or unisex |
| data.probability | double | Confidence of the prediction (0.00–1.00) |
| data.sampleSize | long | Total number of name records used for the prediction |
| data.country | string? | ISO country code if filtered, otherwise null |
| data.sources | array | List of data source names contributing to the result |
Example
Get the gender association for a name:
curl -X POST https://simplewebapis.com/api/genderassociation \
-H "Content-Type: application/json" \
-H "X-Api-Key: swa_your_key" \
-d '{"name": "Maria", "country": "US"}'
The response is a JSON object (Content-Type: application/json).
Try it out
Use the Playground to test this API live.