Skip to main content
Gender API logo
  • Category: developer tools
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 9
  • Triggers: 0
  • Slug: GENDER_API
  • Version: 20261101_00

Tools

Slug: GENDER_API_GET_COUNTRY_OF_ORIGINTool to retrieve a name’s likely countries of origin. Use after confirming the name identifier.

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GENDER_API_GET_COUNTRY_OF_ORIGIN_V1Tool 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

string
required
First name to query country of origin for. Must contain at least one non-space character.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GENDER_API_GET_STATISTICTool 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GENDER_API_QUERY_BY_EMAIL_ADDRESSDetermine 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

string
Client-provided correlation ID
string
Valid IPv4 or IPv6 address
string
required
Email address to query for gender determination
string
Browser locale code (e.g., ‘en_US’)
string
ISO 3166 ALPHA-2 country code

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GENDER_API_QUERY_BY_EMAIL_ADDRESS_MULTIPLEQuery likely gender for multiple email addresses in a single batch request. Results can include gender, probability and a result-found flag, or per-item error details.

Input Parameters

array
required
List of email queries to process in a single batch request

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GENDER_API_QUERY_BY_FIRST_NAMETool to determine the gender of a first name. Use when you need to identify gender based on a given name.

Input Parameters

string
Client-defined correlation ID, max 50 characters.
string
Valid IPv4 or IPv6 address.
string
Browser locale, e.g., ‘en-US’.
string
ISO 3166 ALPHA-2 country code.
string
required
Name to query.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GENDER_API_QUERY_BY_FULL_NAMETool 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GENDER_API_QUERY_GENDER_BY_FIRST_NAME_MULTIPLEQuery gender for multiple first names in a single batch request.

Input Parameters

array
required
List of name queries to process in a single batch request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GENDER_API_QUERY_GENDER_BY_FULL_NAME_MULTIPLESubmit a batch of name strings for gender queries, with optional country, locale or IP context. Each name is sent as a first-name field.

Input Parameters

array
required
List of name query items to process in a single batch request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not