Skip to main content
GenderAPI.io logo
  • Category: developer tools
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 5
  • Triggers: 0
  • Slug: GENDERAPI_IO
  • Version: 20261101_00

Tools

Slug: GENDERAPI_IO_GENDERAPI_GET_STATSTool to retrieve account usage statistics from GenderAPI.io. Use when you need to check remaining API credits and expiry.

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: GENDERAPI_IO_GENDER_API_QUERY_BY_FIRST_NAMETool to determine gender by querying first name. Use when you need to infer likely gender for a given name with optional localization hints.

Input Parameters

string
Optional arbitrary identifier (up to 50 characters) to correlate the response.
string
Optional IP address (IPv4 or IPv6) to localize the query.
string
required
First name to query gender for.
string
Optional locale to guide gender inference.
boolean
Ask AI model when the name isn’t present in the database.
string
Optional ISO 3166 alpha-2 country code to localize the query.
boolean
Attempt to genderize even for non-typical names (e.g., nicknames).

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: GENDERAPI_IO_GET_GENDER_FROM_USERNAMETool to determine gender from a username or nickname. Use when you have an alias or handle and want to infer gender from that identifier.

Input Parameters

boolean
If true, asks the AI model when the name is not found in the database.
string
Optional ISO 3166-1 alpha-2 country code to improve prediction accuracy.
string
required
Username or nickname to analyze for gender inference.
boolean
If true, attempts prediction even for usernames that don’t resemble real names.

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: GENDERAPI_IO_LIST_ERROR_CODESReturn a static list of six error codes with HTTP statuses and descriptions for debugging or validating API responses. The list is based on Gender-API.com documentation.

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: GENDERAPI_IO_QUERY_BY_EMAIL_ADDRESSTool to determine gender from an email address. Use when you need to infer gender for personalization after obtaining proper consent.

Input Parameters

string
Optional client-provided ID (max 50 characters) for tracing.
string
Valid IPv4 or IPv6 address for geo-hinting.
string
required
Email address to query; must be a valid email format.
string
Browser locale to improve name parsing (e.g., ‘en’, ‘fr’).
string
ISO 3166-1 alpha-2 country code to hint the endpoint (uppercase).

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