# Gender API

Gender API determines the gender of a first name, email address, or username.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 9
- **Triggers:** 0
- **Slug:** `GENDER_API`
- **Version:** 20260312_00

## Tools

### Get Country of Origin

**Slug:** `GENDER_API_GET_COUNTRY_OF_ORIGIN`

Tool to retrieve a name's likely countries of origin. Use after confirming the name identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Client-defined request ID for correlation (max 50 chars). |
| `email` | string | No | Email address to query; can be provided instead of first_name. |
| `full_name` | string | No | Full name to query; can be provided instead of first_name. |
| `first_name` | string | No | First name to query. Required if full_name and email are not provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Country of Origin (v1)

**Slug:** `GENDER_API_GET_COUNTRY_OF_ORIGIN_V1`

Tool to get the country of origin for a given first name using v1 API. Returns the most likely country where the name is most common.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | First name to query country of origin for. Must contain at least one non-space character. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Gender API Statistics

**Slug:** `GENDER_API_GET_STATISTIC`

Tool to retrieve account statistics from Gender-API, including remaining credits and usage details. Use when you need to check your credit balance before performing further gender lookups.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Gender by Email Address

**Slug:** `GENDER_API_QUERY_BY_EMAIL_ADDRESS`

Determine likely gender from an email address by extracting and analyzing the name portion. Returns male/female/unknown with a confidence score. Optionally filter by country for improved accuracy. Check result_found to know if a determination was made; probability indicates confidence level.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Client-provided correlation ID |
| `ip` | string | No | Valid IPv4 or IPv6 address |
| `email` | string | Yes | Email address to query for gender determination |
| `locale` | string | No | Browser locale code (e.g., 'en_US') |
| `country` | string | No | ISO 3166 ALPHA-2 country code |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Gender by Multiple Email Addresses

**Slug:** `GENDER_API_QUERY_BY_EMAIL_ADDRESS_MULTIPLE`

Determine likely gender for multiple email addresses in a single batch request. Returns male/female/unknown with confidence scores for each email. Use for efficient bulk processing. Each result includes result_found flag and optional probability score.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `emails` | array | Yes | List of email queries to process in a single batch request |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Gender From First Name

**Slug:** `GENDER_API_QUERY_BY_FIRST_NAME`

Tool to determine the gender of a first name. Use when you need to identify gender based on a given name.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Client-defined correlation ID, max 50 characters. |
| `ip` | string | No | Valid IPv4 or IPv6 address. |
| `locale` | string | No | Browser locale, e.g., 'en-US'. |
| `country` | string | No | ISO 3166 ALPHA-2 country code. |
| `first_name` | string | Yes | Name to query. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Gender by Full Name

**Slug:** `GENDER_API_QUERY_BY_FULL_NAME`

Tool to determine gender by splitting a full name. Use when you have an exact full name string and want to infer gender. Slightly less reliable for rare or ambiguous names.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Arbitrary ID (max 50 chars) for correlating batch responses. |
| `ip` | string | No | Valid IPv4 or IPv6 address for geo-based gender inference. |
| `locale` | string | No | Browser locale string (e.g., en_US) for more accurate inference. |
| `country` | string | No | ISO 3166 alpha-2 country code to hint regional gender conventions. |
| `full_name` | string | Yes | Full name to query; must contain at least one non-space character. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Gender by Multiple First Names

**Slug:** `GENDER_API_QUERY_GENDER_BY_FIRST_NAME_MULTIPLE`

Tool to determine gender for multiple first names in a single batch request. Use when you need to query gender for several names efficiently to save API credits and reduce latency.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `names` | array | Yes | List of name queries to process in a single batch request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Gender by Full Name (Multiple)

**Slug:** `GENDER_API_QUERY_GENDER_BY_FULL_NAME_MULTIPLE`

Tool to batch query gender for multiple full names in a single request. Use when you need to determine gender for multiple names efficiently. Each name can optionally include country, locale, or IP for more accurate regional inference.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `names` | array | Yes | List of name query items to process in a single batch request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |